Skip to main content

Overview of PayPal Express Checkout gateway integration

Zuora

Overview of PayPal Express Checkout gateway integration

Supported features

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

PayPal

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

https://api-3t.paypal.com/nvp

Support Gateway Reconciliation Yes
PayPal production endpoint used for Gateway Reconciliation service https://api-3t.paypal.com/nvp
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:

  • Settlement
  • Rejection
  • Chargeback

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:
    • Settlement
    • Rejection

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
Success
  • Completed
  • Cleared
Payment settlement
Denied
  • Canceled
  • Returned
Payment rejection
Reversed
  • Reversed
Payment chargeback

Limitation

Zuora does not support Payment Review in PayPal Express Checkout. Contact your PayPal Account Manager or the PayPal Customer Support to disable Payment Review.