Field mappings for credit card transactions through Global Payments
This payment gateway integration can be requested through the Specialized Payment Connections service at an additional cost.
The following tables describe the mappings of key identifier fields for credit card transactions through the Global Payments 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 and authorization
| Global Payments API Field | Zuora Field | Request/Response | Description |
|---|---|---|---|
|
Authorize.Paymentdata.VaultToken |
TokenId |
Request |
The vault token. |
|
Authorize.Request.Amount |
DefaultAuthAmount |
Request |
Can be 0 for card validation. Otherwise, any amount can be used for other cases. |
|
Token |
GatewayReferenceId |
Response |
Reference Token, which can be used to capture the transaction if the authoriazation amount is not $0. |
|
VaultBoardingResponse.VaultVaultToken |
GatewayResponseToken1 |
Response |
Unique ID of payment method that can be used in place of actual card details. |
Capture
| Global Payments API Field | Zuora Field | Request/Response | Description |
|---|---|---|---|
|
Capture.Request.Token |
ReferenceId |
Request |
Previous TransactionToken from authorize. Example: |
| CaptureResult.Token |
GatewayReferenceId |
Response |
|
| VaultBoardingResponse.VaultVaultToken |
GatewayResponseToken1 |
Response |
|
Payment
| Global Payments API Field | Zuora Field | Request/Response | Description |
|---|---|---|---|
|
Sale.Paymentdata.VaultToken |
TokenId |
Request |
If a vault token is already created. |
|
Sale.Request.MerchantTransactionId |
PaymentNumber |
Request |
|
|
SaleResult.Token |
GatewayReferenceId |
Response |
Reference Token, which can be used if subsequent refunds need to be done for the same payment. |
|
VaultBoardingResponse.VaultVaultToken |
GatewayResponseToken1 |
Response |
Unique ID of payment method that can be used in place of actual card details. |
Payment cancel (void)
| Global Payments API Field | Zuora Field | Request/Response | Description |
|---|---|---|---|
| Void.Request.Token |
ReferenceId |
Request |
Previous TransactionToken from authorize. Example: |
| Void.Request.MerchantTransactionId | PaymentNumber | Request |
|
| VoidResult.Token | GatewayReferenceId | Response | Reference token that can be used if a subsequent refund needs to be done for the same payment. |
Referenced refund
| Global Payments API Field | Zuora Field | Request/Response | Description |
|---|---|---|---|
|
Refund.PaymentData.Token |
ReferenceId |
Request |
|
|
Refund.PaymentData.VaultToken |
TokenId |
Request |
Used when Source is Vault |
|
Sale.Request.MerchantTransactionId |
RefundNumber |
Request |
|
|
RefundResult.Token |
GatewayReferenceId |
Response |
|
|
VaultBoardingResponse.VaultVaultToken |
GatewayResponseToken1 |
Response |
Unique ID of payment method that can be used in place of actual card details. |