Skip to main content

Define and set up payment methods


Define and set up payment methods

Payment methods are the ways in which customers pay for their subscription services. A customer can choose a payment method based on your company’s list of preferred payment methods. To set up payment methods for the customer accounts, define the payment methods your company can support in Payments settings, and then set up the payment methods for the customer accounts.

Activate payment methods

Navigate to Payment Settings > Payment Method to define and activate payment methods your company supports.

The payment methods you select will appear in a picklist when you set up the billing and payment terms for a customer within the customer account

For more details about the supported payment methods, see Supported Payment Methods.

Set up payment methods for customer accounts

You can set up payment methods for new customer accounts during the account creation process, or by editing an existing account. You can add a maximum of 100 payment methods to an account. If there are multiple payment methods associated with a customer account, select one of the payment methods as the default payment method to indicate that it is the customer's preferred method of payment. You can enable the Auto-Pay setting on a customer account that uses an electronic payment method to automatically collect payments.

You can set up payment methods except for Apple Pay and Google Pay through Zuora UI, APIs, and Payment Pages 2.0. For information about setting up Apple Pay and Google Pay, see the later sections in this article.

Set up a payment method through the Zuora UI

  1. Navigate to the UI section for setting up payment methods:
    • To set up a payment method during the creation of a new customer account, navigate to the Payment Method section.
    • To set up a new electronic payment method for an existing customer account, open the customer account page, navigate to the Electronic Payment Methods section, and then click Create New Payment Method.
  2. Select one of the available electronic payment methods you have defined in the Payment Method setting. During the creation of a new customer account, you can set up an external payment method for the customer account.
  3. Enter the payment method details.
  4. Click Save.

Set up a payment method through the API

You can use any of the following REST APIs to set up a payment method:

Set up a payment method through Payment Pages 2.0

You can use the embedded iFrame or Direct POST to implement Payment Pages 2.0 to collect your end user's payment method data. See Payment Pages 2.0 for details.

Set up Apple Pay

To enable Apple Pay on your website, see Apple Pay on Web for more information.

Set up Google Pay

Google Pay is only supported by the following payment gateway integrations in Zuora for now:

To set up and use a Google Pay payment method on the supported payment gateway integrations, see the following articles:

Best practice

It is recommended to provide the city and country information when creating a payment method. The information will be sent to the gateway and be used to process payments with this payment method. If the information is not provided during payment method creation, the city and country data will be missing during payment processing. The bill-to or sold-to address information of your account will not be included in the request to the gateway.

Manage stored credential profiles for credit cards

A stored credential profile within a payment method is a container for data of a credential that has been stored in accordance with a customer consent agreement. Each stored credential profile includes a transaction identifier, which Zuora sends to the payment gateway whenever the payment method is used in a payment.

When you create a credit card payment method through the Zuora UI, API, or Payment Pages 2.0, you can create a stored credential profile within the payment method if the customer has given consent for their information to be stored. See Stored credential transactions for more information.