Welcome to Zuora Product Documentation

Explore our rich library of product information

3D Secure Response Parameters

This document details the parameters included in the 3D Secure response, explaining their roles and conditions under which they are returned.

This article mainly describes the parameters contained in the 3D Secure response.

The following table lists the parameters contained in the 3D Secure response when the 3D Secure process is successful.

Parameter

Description

Remarks

ThreeDSResult

The status result of the 3D Secure check.

For more information about the parameter values, see 3D Secure Status Results .

The general result of 3D Secure authentication. This parameter and its value are always returned as long as it is a 3D Secure hosted page and the authentication amount is greater than zero.

AuthorizeResult

The result of the authorization.

For more information about the parameter values, see 3D Secure Authorization Results .

The result of authorization. This parameter and its value are always returned in the response.

AuthTransactionId

The transaction ID that represents the authorization. You can use it to capture or void the authorization.

The unique identifier of authorization. It is required if you want to void or capture the authorization.

threedPaymentMethodId

The payment method ID that is created for this 3D Secure request. It can be used to create a billing account and associate with the billing account. It can also be used to capture the authorization.

Regardless of whether 3D Secure authentication is successful, Zuora creates a payment method and returns its ID as long as the authorization is successful.

CAVV

Cardholder Authentication Verification Value, a value that allows VisaNet to validate the integrity of the Verified by Visa (VbV) transaction data.

The value is responded from the corresponding payment gateway.

If the credit card is enrolled with 3D secure, this parameter and its value are returned in the response.

If the credit card is not enrolled with 3D secure, this parameter is returned in the response without any value.

ECI

Electronic Commerce Indicator, the two or three digit code that is returned by the credit card processing networks and issuing banks to notify an eCommerce merchant about the authentication of the cardholder and the status of the cardholder’s issuing bank under 3D Secure. Each credit card network has a specific type of ECI framework used.

The value is responded from the corresponding payment gateway.

If the credit card is enrolled with 3D secure, this parameter and its value are returned in the response.

If the credit card is not enrolled with 3D secure, this parameter is returned in the response without any value.

XID

The unique ID generated by the card issuer bank to represent this 3D Secure authentication request.

If the credit card is enrolled with 3D secure, this parameter and its value are contained in the response.

If the credit card is not enrolled with 3D secure, this parameter is returned in the response without any value.