Welcome to Zuora Product Documentation

Explore our rich library of product information

Overview of Amazon Pay Checkout v2 gateway integration

Learn about integrating Amazon Pay Checkout v2 with Zuora for processing transactions in Japan.

Note:

This payment gateway integration can be requested through the Specialized Payment Connections service at an additional cost.

Zuora integrates with Amazon Pay, supporting a gateway integration known as Amazon Pay Checkout v2 for processing Amazon Pay Wallet transactions. This integration currently supports Japan.

Supported payment methods

The Amazon Pay Checkout v2 payment gateway integration supports Amazon Pay tokens.

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

Amazon Pay Wallet

Supported payment operations

Payment and 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

Gateway provider’s API version

V2 https://pay-api.amazon.com/v2

Amazon Pay production endpoint used for Zuora gateway integration service

V2 https://pay-api.amazon.com/v2

Support Gateway Reconciliation

No

Support Payment Method Updater

No

Real Time Reconciliation

Yes

Note:

The feature only handles the status updates of charge permission ID's (payment methods) and not the payment and refund status.

Supported payment operations

The Checkout.com integration supports the following payment operations:

  • Payment

  • Referenced refund

Support for IPN

Events related to AmazonPay V2 Checkout payment methods also trigger Instant Payment Notification (IPN). This messaging service immediately notifies merchants about the status of the changes in payment methods.

Amazon Pay Checkout v2

For Amazon Pay Checkout v2, Real-Time Reconciliation is based on Amazon Pay Instant Payment Notifications (IPN).

Zuora consumes ChargePermission IPN events for this integration. When Zuora receives an IPN indicating that the ChargePermission state has changed from Non-chargeable to Closed, Zuora updates the related payment method so it can no longer be used for future payments.

After this event is processed, Zuora updates the payment method as follows:

  • PaymentMethod.MandateStatus is set to closed.

  • PaymentMethod.MandateReason is cleared.

  • PaymentMethod.State is set to Closed.

Optional note if the page includes gateway behavior details:

This integration currently uses ChargePermission IPN events for Real-Time Reconciliation.