Skip over navigation

PayPal Express Integration

This section describes the steps that are necessary to expose PayPal Express as a payment method for OroCommerce orders and quotes.

Warning

Before you can use PayPal Express in OroCommerce, install the Oro PayPal Express Integration package.

Note

Before you begin, see PayPal Express Service overview and learn about PayPal Express integration prerequisites – the preparation steps that should be performed on the PayPal service side.

To enable PayPal Express payments:

  1. Navigate to System > Integrations > Manage Integrations in the main menu. The Manage Integrations page opens.

  2. Click Create Integration.

  3. On the Create Integration page, select PayPal Express for Type.

    ../../../../_images/paypal_express_integration.png
  4. Type in the Common Integration Details:

    • 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 Storefront during the checkout. It may not include the payment processor name if you want to hide it from the buyers. For example, you can enter ‘Credit Card Payments’ if you have a single payment method configured for processing credit cards.

      Click the Translations icon to provide spelling for different languages. Click the Default Language icon to return to the single-language view.

    • Short label—The payment method name/label that is shown in the order details in the OroCommerce Management Console and Storefront after the order is submitted.

      Click the Translations icon to provide spelling for different languages. Click the Default Language icon to return to the single-language view.

    • Status—Set the status to Active to enable the integration.

    • Default Owner—A user who is responsible for this integration and manages it.

  5. In Payment Action, select the strategy for the payment processing on the checkout:

    • Authorize — When this option is selected, a buyer is not charged after submitting an order. They should first provide their card details to validate the payment information. The total purchase amount may be put on hold (temporarily blocked) on their account to guarantee that they have enough funds to finalize the purchase.

      Note

      With this strategy selected, you will need to capture the payment manually. It can be performed either on the PayPal side or in the Oro management console. However, be noted that if you capture the payment from your PayPal Manager account, the payment status of the submitted order in the Oro management console will still be Payment authorized. The Paid in full status is assigned only when you capture the payment in the Oro management console.

      ../../../../_images/paypal_express_charge.png
    • Authorize and Charge — When this option is selected, a buyer is charged immediately after they submitted an order and provided the card details to validate the payment information.

More information on PayPal payment actions is covered in the Payment Actions topic.

  1. Insert the Client ID and Client Secret values, generated individually through the PayPal website. For more information on how to get the sandbox API credentials, refer to the Obtain Sandbox Credentials section. For the production API credentials, refer to the Obtain Production Credentials guide.
  2. Select the Sandbox Mode check box to check the PayPal Express interaction process in the test mode without any charges. It enables you to connect to the gateway in a safe environment with no risk to both customers and sales representatives.
  3. Click Save and Close.

Next, set up a payment rule that enables the PayPal Express payment method for all or some customer orders via the Payment Rules Configuration page.

Browse maintained versions:3.11.6

You will be redirected to [title]. Would you like to continue?

Yes No
Back to top