Set up and configure a PayPal Commerce Platform gateway instance
Set up and configure a PayPal Commerce Platform payment gateway instance by using the information in this article.
Prerequisites
- Before processing payments with Zuora, you must onboard with PayPal’s new Commerce platform to establish a Business type of merchant account and include your primary email address in your PayPal merchant account. The ID associated with that merchant account is required to transact through Zuora. Note that the ID must belong to a PayPal Business account. Personal account types will cause failed transactions.
- For customers who want to process payments with PayPal in Australia, please contact your PayPal representative about any required agreements with PayPal Australia. Zuora is not an agent or representative of PayPal or PayPal Australia. Any contacts or required contracts must be handled through PayPal Australia.
- Enable the PayPal Commerce Platform payment gateway integration for your tenant. See Enable payment gateway integrations for your tenant for instructions.
Procedure
Perform the following steps to set up and configure a PayPal Commerce Platform gateway instance in Zuora:
- Click your username in the upper right and navigate to Settings > Payments > Setup Payment Gateway.
- On the Configure Gateway Instance tab, select PayPal Commerce Platform from the Gateway Type drop-down list.
- Click Create Gateway.
- On the gateway settings page, specify values for the configuration fields. See below for more information on the fields.
- Click Save Gateway Information.
Configuration fields
Common configuration fields
There are some common fields you must configure for every gateway instance. See Setting Up Payment Gateways for information about the following common configuration fields and complete the configuration:
- Name
- Use Gateway Test Environment
Additional configuration fields
In addition to the common fields, the following fields are specific to the configuration of the PayPal Commerce Platform integration:
- Merchant ID: Select the merchant ID that was created to access the PayPal Commerce Platform gateway. To create a new merchant ID or view all available IDs, you can navigate to Settings > Payments > Gateway Authentication. For more information about how to create a merchant ID for PayPal Commerce Platform in Zuora, see Payment Gateway Authentication.
- Verify new PayPal Commerce payment method: If this option is selected, the Billing Agreement ID (BAID) is validated with the gateway when the payment method record is created in Zuora. This option is enabled by default to avoid storing invalid payment methods in Zuora.
Test the configuration
We recommend that you test your payment gateway using both your payment gateway's test and production (live) environments. Once you have completed testing in the gateway's test environment, it is recommended that you perform a test in your live production environment with a real PayPal wallet. If there are any differences in the configuration of your testing and production accounts, testing in production ensures your production merchant account is set up properly and can successfully connect to the production environment.
To perform your test, create an account in PayPal Sandbox and then generate test card data in your PayPal Sandbox account by using the Credit card generator. For more information about managing your BAIDs, see PayPal Developer documentation.
Troubleshooting
Use the information in the following table to troubleshoot common errors:
Error | Description |
---|---|
Email verification | This error occurs when your email has not been verified, which could be an issue with PayPal. Please contact PayPal Commerce Support if this issue persists. |
Not able to receive payments | This error occurs when your PayPal account is not enabled to receive payments, which could be an issue with PayPal. Please contact PayPal Commerce Support if this issue persists. |
Insufficient callback data | This error occurs when PayPal does not return sufficient callback data to Zuora. Please contact Zuora Support if you have any issues related to insufficient callback data when creating the PayPal Commerce access token. |
Insufficient permissions | This error occurs when you do not grant Zuora sufficient permissions to initiate transactions on your behalf. Please contact Zuora Support if you have any issues related to insufficient permissions when creating the PayPal Commerce access token. |
Initialize authorization link error |
These authorization errors occur when connecting with the gateway. For more information on the status code and troubleshooting, see PayPal's document. |