Skip to main content

Field mappings for credit card reference transactions through Braintree v2.0

Zuora

Field mappings for credit card reference transactions through Braintree v2.0

The following tables describe the mappings of key identifier fields for credit card reference transactions between Zuora and Braintree through the Braintree v2.0 payment gateway integration.

To find out more information about the communication between Zuora and the gateway for payment method creation, verification, and payment processing, you can use the information in the following tables in combination with the information in the payment method transaction log and payment transaction log. For how to export transaction logs, see Discover information about payment method creation and payment processing.

Payment method validation

Braintree API Field Zuora Field Request/ Response Description

paymentMethodId

TokenId

Request

Multi-use reference to payment information provided by the customer 

data.verifyPaymentMethod.verification.paymentMethod.id

GatewayReferenceId

Response

Unique identifier for payment Method Token from the gateway

data.verifyPaymentMethod.verification.id

GatewaySecondReferenceId

Response

Unique identifier of the Verify transaction from the gateway

Payment

Braintree API Field Zuora Field Request/ Response Description

paymentMethodId

TokenId

Request

multi-use reference to payment information provided by the customer 

transaction.orderId

PaymentNumber

Request

Such as P-00020909

transaction.merchantAccountId

MerchantAccountId

Request

Merchant account ID that is used to process the transaction

data.captureTransaction.transaction.id

GatewayReferenceId

Response

Unique identifier of the Verify transaction from the gateway

data.captureTransaction.transaction.paymentMethod.id

GatewaySecondReferenceId

Response

Unique identifier for payment Method Token from the gateway

Payment cancel

Braintree API Field Zuora Field Request/Response Description

transactionId

ReferenceID

Request

Received from the payment transaction

data.reverseTransaction.reversal.id

GatewayReferenceId

Response

Unique identifier of the Void transaction from the gateway

Referenced refund

Braintree API Field Zuora Field Request/Response Description

transactionId

Reference ID

Request

Received from the payment transaction

refund.orderId

RefundNumber

Request

Such as R-00020909

data.rrefundTransction.refund.id

GatewayReferenceId

Response

Unique identifier of the Refund transaction from the gateway