Skip to main content payment gateway integration

Zuora payment gateway integration allows you to build flexible payment flows, collect payments quickly and securely, and accept payments from various payment methods. Zuora’s integration with makes it simple to accept recurring and one-off payments via credit cards, bank transfer, or ACH.

Supported payment methods

The gateway integration supports the following payment methods:

  • Credit Cards, including:
    • Visa
    • Mastercard
    • American Express
    • Discover
    • Diners Club
    • JCB
    • China Union Pay 
  • SEPA
  • ACH

Stored credential transactions

The gateway integration supports the Stored Credential Transactions framework of Visa and Mastercard.

Supported payment operations

The integration supports the following payment operations:

  • Validate
  • Payment
  • Refund

Compliance with PSD2

The gateway integration provides support for 3D Secure 2.0. To learn how to enable 3D Secure 2.0 for, see Enable 3DS2 for gateway integration.

Set up integration

After the gateway integration is enabled in your tenant, set up the payment gateway.

  1. Click your username at the top right, and navigate to Settings > Payments > Set Up Payment Gateway.
  2. From the Gateway Type dropdown list, select
  3. Click create gateway.
  4. Complete the information for the gateway instance. See below for more information about the fields.
  5. Click save gateway information.

Common configuration fields

There are some common fields you must complete for every gateway configuration. Zuora recommends that you review Setting Up Payment Gateways for information about these fields: 

  • Type
  • Name
  • Use Gateway Test Environment
  • Cards Accepted
  • Default Authorization Amount: This field is used only for credit card validation. You can validate the credit card payment method using 0 or non-zero authorization amount. Defaults to 1 in Zuora. 
  • Verify new payment method (optional):
    With this checkbox selected, the validate call is triggered for any supported payment method when a new payment method is created.
    For ACH and SEPA, Source ID from must be entered in the MandateID field during the payment method creation if this checkbox is selected. 
  • Verify updated payment method (optional): 
    With this checkbox selected, the validate call is triggered for any supported payment method when an existing payment method is updated.
    This checkbox must be selected for ACH and SEPA to have updated payment information reflected in

Additional configuration fields

The following fields are specific to this gateway integration:

  • API Key: It is required by all endpoints for authentication. This field corresponds to the secret key in your merchant account. You can obtain it by navigating to Settings > Channels.
  • Default Soft Descriptor (optional): The default soft descriptor for payments. It is required for all Direct Debit payment methods.


  • Since uses auto-capture by default, payment requests are captured very quickly. Therefore, payments cannot be cancelled or voided using the gateway. Once made, payments can only be refunded later.
  • Non-referenced refunds (credits) are not supported by the gateway integration.