Welcome to Zuora Product Documentation

Explore our rich library of product information

New payment methods

This document outlines the process for creating and activating stored credential profiles for new payment methods, including the necessary settings and conditions for successful profile activation.

For payment methods that are newly created through UI, API operations, or Payment Pages, the stored credential profiles including the NTI or equivalent will be created and activated for all supported card brands.

If you want the NTI to be returned from the gateway and added when creating a payment method, ensure that the Verify new payment method setting is enabled on the gateway instance configuration page. Otherwise, only an empty stored credential profile in Agreed status will be created.

If the Verify new payment method setting is enabled, a stored credential profile with the following properties is automatically created by Zuora.

Property

Value

Description

Profile action

Activate

Zuora will send a cardholder-initiated transaction (CIT) to the payment gateway to validate the stored credential profile. If the CIT succeeds, the status of the stored credential profile will be Active . If the CIT does not succeed, Zuora will not create a stored credential profile.

If the payment gateway does not support the stored credential transaction framework, the status of the stored credential profile will be Agreed .

Profile type

Recurring

The stored credential profile can be used to process recurring but not unscheduled transactions.

Consent agreement source

External

Indicates that you have established the consent agreement with your customers through an external system outside of Zuora.