Set up Credit Card payment methods
Learn how to set up Credit Card payment methods on Braintree v2.0 using the Zuora UI, REST API, or Hosted Payment Pages 2.0, and understand the tokenization process for secure transactions.
You can set up Credit Card payment methods on Braintree v2.0 through any of the following methods:
-
Zuora UI
-
REST API operations
-
Hosted Payment Pages 2.0
If you create a Credit Card payment method through the Zuora UI or hosted payment page, a token is automatically generated and stored for the payment method. The tokens will be used for processing subsequent recurring payments. You can retrieve the following token information in the Electronic Payment Methods section of the customer account page.
|
Zuora UI Field |
Value |
|---|---|
|
Token ID |
Multi-use payment method ID |
|
Second Token ID |
Empty |
|
Third Token ID |
Empty |
If you want to create a tokenized Credit Card payment method through the REST API operation , pass in the following required fields:
-
accountKey
-
cardNumber
-
cardHolderInfo
-
cardType
-
expirationMonth
-
expirationYear
-
type
-
tokenize
A token is generated when validating the payment method with the gateway. Both the card information and the token are stored for the payment method but the token is used in processing subsequent payment transactions.
If the
tokenize
field is not provided or is set to
false
, the payment method is created but no tokens are generated or stored.
For tokenized payment methods, you must validate them in Zuora so that payments made with these payment methods are successful. To validate tokenized payment methods, turn on the following settings on the gateway instance configuration page:
-
Verify new payment method
-
Verify updated payment method
When customers create a credit card payment method on Braintree v2.0, Zuora now sends the postal code whenever it is provided. If only a postal code is available, Zuora can still send that value. If no billing address information is provided, Zuora does not send an empty address. This behavior helps reduce payment method validation failures and makes address handling more predictable across hosted and API-based flows.
No new setup is required. To benefit from postal code verification, ensure that your payment form or hosted payment page collects the postal code when appropriate for your business.