Set up payment methods on Braintree v2.0
Use the following instructions to set up payment methods on the Braintree v2.0 payment gateway integration:
- Set up ACH payment methods
- Set up Apple Pay payment methods
- Set up Credit Card payment methods
- Set up CC Ref payment methods
- Set up Google Pay payment methods
- Set up PayPal payment methods
Set up ACH payment methods
You can set up ACH 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 an ACH payment method through the Zuora UI or hosted payment page, tokens are 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 ACH payment method through the REST API operation, pass in the following required fields:
- accountKey
- bankABACode
- bankAccountName
- bankAccountNumber
- bankAccountType
- type
- tokenize
A token is generated when validating the payment method with the gateway. Both the account 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, enable the following settings on the gateway instance configuration page:
- Verify new payment method
- Verify updated payment method
Set up Apple Pay payment methods
You can implement an Apple Pay button on your checkout page through JavaScript SDK integration. See Set up Apple Pay for more information.
Set up Credit Card payment methods
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
Set up CC Ref payment methods
You can create Credit Card Reference Transaction (CC Ref) payment methods on Braintree v2.0 using the REST API operation. To create a CC Ref payment method, a multi-use payment method ID is required. See the following Braintree documentation for obtaining a multi-use payment method ID.
Set up Google Pay payment methods
You can implement a Google Pay button on your checkout page through JavaScript SDK integration. See Set up Google Pay with Zuora JavaScript SDK for more information.
Set up PayPal payment methods
You can set up PayPal on Braintree v2.0 through either of the following approaches:
- JavaScript SDK integration
- REST API operation
For more information, see Set up PayPal on Braintree v2.0.