PayPal Payflow Gateway / PayPal Payment Pro¶
This section describes the steps that are necessary to expose either PayPal Payflow Gateway and PayPal Payflow Gateway Express Checkout or PayPal Payments Pro and PayPal Payments Pro Express Checkout as payment methods for OroCommerce orders and quotes.
Integration steps for PayPal Payments Pro and PayPal Payflow Gateway are exactly the same. The only difference is the integration type that indicates the way OroCommerce shall treat the integration.
To enable PayPal Payflow Gateway or PayPal Payment Pro payments:
Navigate to the Manage Integrations page by clicking System > Integrations > Manage Integrations in the main menu.
Click Create Integration and select either PayPal Payflow Gateway or PayPal Payment Pro as integration type.
Type in the Common Integration Details:
- In the Basic Information and Display Options, provide name, label and short label for the PayPal Payflow Gateway/PayPal Payment Pro method.
- In the Express Checkout section, provide different name, label and short label to identify the PayPal Payflow Gateway/PayPal Payment Pro Express Checkout method.
- Name – the payment method name that is shown as an option for payment configuration in the OroCommerce Management Console.
- Label – the payment method name/label that is shown as a payment option for the buyer in the OroCommerce Store Front on the checkout.
- Short label – the payment method name/label that is shown in the order details in the OroCommerce Management Console and Front Store after the order is submitted.
- Status – set the status to Active to enable the integration.
Fill in the PayPal Specific Integration Details:
- Basic Information and Display Options:
- Common Payment Integration Details (name, label, and short label) for the ordinary PayPal payment.
- Allowed Credit Card Types – Select one or more items from the list of the credit card types. Supported types are Visa, Mastercard, Discover, American Express. Press and hold Ctrl/Shift and click on the items to select.
- Integration settings:
- Partner – the PayPal payment partner (usually, a PayPal).
- Vendor – your company ID (Business Name) provided to the PayPal in the Register a PayPal Payflow Gateway Account step (see Prerequisites for PayPal Services Integration for more information).
- User – the PayPal API Integration user name. See the Create an API Transaction User section in the Prerequisites for PayPal Services Integration.
- Password – the PayPal API Integration user password. See the Create an API Transaction User section in the Prerequisites for PayPal Services Integration.
- Test mode – an option that enables calling PayPal API in the test mode.
- Advanced Settings:
- Payment Actions (Authorize or Authorize and Charge) for the ordinary PayPal payment.
- Debug Mode – when enabled, the PayPal includes more detailed information in the response. This mode may be helpful when troubleshooting payment-related issues.
- Require CVV Entry – when enabled, the buyer is prompted to enter their credit card CVV. When enabled, the CVV is verified during payment authorization by the payment processor.
- Zero Amount Authorization – enables Zero Amount authorization request – a transaction that authorizes further payment with the same payment details. When enabled, the buyer can reuse this payment information for the further orders.
- Authorization for Required Amount – enables blocking the required amount on the buyer’s credit card to ensure that they have sufficient balance to be charged for the order later. This option is valid only when Zero Amount Authorization is enabled and only when Authorize payment action is selected.
- Connection Options:
- Use Proxy – when enabled, any request to the PayPal will be routed through the proxy server using Proxy Host and Proxy Port values provided in the following parameters.
- Proxy Host – the host name or the IP address of the proxy server that routes the requests to and from OroCommerce.
- Proxy Port – the port that is used by the proxy server that routes the requests to and from OroCommerce.
- Enable SSL Verification – when enabled, OroCommerce validates the PayPal certificate in the responses from the PayPal API to secure from the man-in-the-middle attack. If the certificate is not valid, the response is ignored and payment processing fails. It is recommended to keep this option enabled for production and most test deployments. You might need to disable the SSL verification for OroCommerce internal tests with no real PayPal integration (e.g. when you are testing checkout workflow customization).
- Express Checkout:
PayPal Integration Configuration Details. Part 1
PayPal Integration Configuration Details. Part 2
PayPal Integration Configuration Details. Part 3
- Basic Information and Display Options:
Next, set up a payment rule that enables these payment methods (PayPal Payflow Gateway and PayPal Payflow Gateway Express Checkout and/or PayPal Payment Pro and PayPal Payment Pro Express Checkout) for all or some customer orders.