Skip to main content

Stripe Payment Gateway


Stripe Payment Gateway

The Stripe payment gateway allows individuals and businesses to accept payments over the internet. 

Supported Gateway Versions

Zuora provides two Stripe gateway integration versions, Stripe v1 and Stripe v2. The following table lists the major functional differences between Stripe v1 and Stripe v2:

Gateway version Supported payment methods Support 3DS2 through Payment Pages 2.0? Support stored credential transactions?

Stripe v1

  • Credit Cards (Visa, Mastercard, American Express, Discover, JCB, and Diners Club)
  • Credit Card Reference Transaction
  • ACH
No No

Stripe v2

  • Credit Cards (Visa, Mastercard, American Express, Discover, JCB, and Diners Club)
  • Credit Card Reference Transaction
  • ACH
Yes Yes

Stripe v2 includes support for the Stored Credential Transaction framework of Visa, Mastercard, and American Express.

Currently, only existing Stripe Tokens are supported as a Credit Card Reference Transaction payment method type. Creating Tokens in Zuora is not supported.

Configure the Stripe Payment Gateway

  1. Click your username at the top right and navigate to Settings > Payments > Setup Payment Gateway
  2. Select Stripe v1 or Stripe v2 from the Gateway Type drop-down menu.
  3. Click create gateway.

Stripe v2 configuration page

Common Configuration Fields

There are some common fields you must complete for every gateway configuration. We recommend reviewing Setting Up Payment Gateways for information on these fields: 

  • Name
  • Use Gateway Test Environment (Does not apply to Stripe)
  • Secret Key
  • Cards Accepted
  • Default Authorization Amount
  • Verify new payment method (optional)
  • Verify updated payment method (optional)

When using ACH payment method with the Stripe payment gateway, the Verify new payment method and Verify updated payment method check boxes are required to be selected. 

Stripe Configuration Fields

Field Description

Secret Key

Determines if the transaction will go through the merchant's live or test account. You can find your Secret key by navigating to Developers > API Keys in your Stripe merchant account.

Publishable Key

This field is specific to Stripe v2.

It can be found on your Stripe account settings page. You can find your Stripe API Publishable key by navigating to Developers > API Keys in your Stripe merchant account.

Default Authorization Amount

Must not be less than 0.50, in any currency.

See for more information.

Configure the required fields on the Stripe gateway instance setup page. 

Once you have entered the necessary information, click save gateway information.

Additional Gateway Information

Credit Card Reference Transactions

Zuora supports Stripe tokens. Tokens are used for credit card reference transactions in Zuora. A reference transaction is simply a representation of a credit card payment method without having sensitive payment method information like the credit card number stored in Zuora. Please note that the token cannot be used with another gateway, which is why we recommend storing credit card information in Zuora whenever possible.

This feature is in Limited Availability. If you want to have access to the feature, submit a request at Zuora Global Support

See the following topics for more information about setting up credit card reference transactions in Zuora.

The following SOAP API call can be used to create a payment method that represents a Stripe-stored credit card.

  <ns1:zObjects xsi:type="ns2:PaymentMethod">


The bank account verification through Stripe using Plaid or Stripe.js is not supported by Zuora’s Stripe gateway integration. To ensure ACH transactions work correctly, the verification of bank accounts must be turned off by Stripe for your merchant account. 

See Stripe's ACH Guide for more information.