Paypal Module
Broadleaf Commerce currently offers integration with the PayPal Express API. See [[Getting Started With Express Checkout | https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_ECGettingStarted]] for more information. This module allows users to complete their shopping experience using their PayPal account.
How It Works
- When a customer clicks the "Pay with PayPal" button on your checkout page, a request is sent to Broadleaf to initiate the Express Checkout flow.
- Broadleaf will generate a request and call PayPal using the NVP API to verify that the order being sent to them is valid.
- If the checkout request is valid, PayPal will send over a redirect URL.
- Broadleaf will then relay that URL to the customer's browser.
- The customer will then be redirected to PayPal's site to authenticate and review the transaction. Once completed, PayPal would redirect the customer back to a URL in Broadleaf with an authorization token to complete checkout.
- Broadleaf would then complete the order and settlement with PayPal and finally redirect the customer's browser to an order confirmation page.
Note: PayPal requires you to conform to certain UI requirements in order to integrate with them. Please see [[Express Checkout User Interface Requirements | https://cms.paypal.com/us/cgi-bin/?cmd=_render-content&content_ID=developer/e_howto_api_ECUIRequirements]] for more information.
There are two ways to get started integrating the PayPal module into your web application.
Broadleaf offers a PayPal Quick Start solution that allows developers to easily add PayPal functionality with little configuration.
If you have a complex payment workflow, please take a look at our PayPal Advance Configuration
Here's a feature list to help you decide which approach to choose:
(This list does not contain all the capabilities of the module)
Feature List
Feature | Quick Start | Advanced |
---|---|---|
Customizable Logo and Color Scheme on PayPal | ✓ | ✓ |
Single payments using PayPal or another credit card payment gateway. | ✓ | ✓ |
Partial payments using custom defined payment activities | ✓ | |
Capture shipping information in Broadleaf | ✓ | ✓ |
Capture shipping information on PayPal | ✓ | |
Saving PayPal details to Broadleaf profile | ✓ | |
Simple Authorization and Checkout | ✓ | ✓ |
Refund Transaction | ✓ | |
Void Transaction | ✓ |