Overview of PayPal Express Checkout gateway integration
The following table provides a quick reference for the supported features. For details about each feature, see the later sections in this article.
|Supported payment methods||
See PayPal BAID for more information on capturing a customer's PayPal payment method.
|Supported payment operations||
Validate, Payment, Referenced refund
|Support 3D Secure 2.0||No|
|Support Delayed Capture||No|
|Support Level 2 and Level 3 card data||No|
|Support stored credential transactions||No|
|Support Gateway Options fields||No|
|PayPal API version||
PayPal Name-Value Pair (NVP) API
Although the new features and enhancements of PayPal will only be added to the PayPal REST API, the classic API is still supported. When you implement the PayPal Express Checkout, the same API supported in Zuora PalPal Express Checkout Gateway integration will be used because Zuora will run the request on your behalf.
|PayPal production endpoint used for Zuora gateway integration service||
|Support Gateway Reconciliation||Yes|
|PayPal production endpoint used for Gateway Reconciliation service||
|Support Payment Method Updater||No|
|Support idempotency for retrying a transaction request||Yes. See Electronic payment processing for details.|
Support for Gateway Reconciliation
PayPal Express Checkout gateway integration supports the following Gateway Reconciliation event types:
Note that Zuora only creates an external refund for a transaction if the transaction status is Reversed, which maps into the Chargeback event type.
The PayPal Express Checkout gateway handles various transactions, for example, payments, refunds, and eCheck. Zuora, however, only reconciles payments through PayPal Express Checkout.
Zuora reconciles payment transactions two times. For payment transactions that take place on day N:
- They will be reconciled on day N+7 for the first time. All supported event types are processed.
- The second reconciliation is performed on day N+16, whereas only the following event types are processed:
If a transaction is in an intermediate status instead of final status on day N+16, it cannot be reconciled. At a later time, you can manually create a refund, or use the Payment Gateway Reconciliation API operations to reconcile the payment.
Zuora uses PayPal's TransactionSearch API Operation (NVP) API on a daily basis to search for the transactions for reconciliation. The following table describes how different transaction status is mapped to the corresponding gateway reconciliation event type:
|Status in TransactionSearch request||Status in TransactionSearch response||Gateway reconciliation event type|
Zuora does not support Payment Review in PayPal Express Checkout. Contact your PayPal Account Manager or the PayPal Customer Support to disable Payment Review.
Set up and configure a PayPal Express Checkout gateway instance