3D Secure Card Payments

3D Secure card payment data can be added to authorizations, purchases, and refunds. All fields should be included under the extra key in the request payload.

The values for sli, xid, cavv, par and ver should be supplied by the 3D Secure MPI being used for transaction authentication.

If you do not have an MPI, Fat Zebra can provide an MPI. Refer to the 3DS2 Integration documentation for more information.

Field nameTypeDescription
sliString (2-digits)The Security Level Indicator (SLI) indicates the type of card holder authentication used for the transaction. Accepted values are described in the table bellow.
xidStringThe XID is the transaction ID from the 3D Secure provider. This is Base64 encoded data.
cavvStringThe CAVV is the card authentication verification value, provided by the 3D Secure Provider. This is Base64 encoded data.
parStringThis is the PARes value from 3D Secure
verStringThis is the VERes value from 3D Secure
threeds_versionString3DS version used for authenticating the card. The version may include the major, minor, and build numbers, e.g. 2, 2.1, or 2.1.0 are all accepted values.
If omitted, this field will default to a value of 1.
directory_server_txn_idStringDirectory Server Transaction ID from the 3D Secure provider. This is commonly a string in UUID format.
Visa & eftpos SLIMastercard SLI (MPI compatibility)Description
"05""02"Secure, Authenticated transaction with XID and CAVV present
"06""01"Secure, Non-authenticated transaction (XID present, CAVV not present)
"07""00"Secure, Non-authenticated transaction (XID and CAVV not present). This is the default value.

Note: All fields should be included under the extra key in the request payload.

{
    "extra": {
        "sli": "05",
        "cavv": "MzM2OGI2ZjkwYjYwY2FjODQ3ZWU=",
        "xid": "ZGUzNzgwYzQxM2ZlMWM0MzVkMjc=",
        "par": "Y",
        "ver": "Y",
        "directory_server_txn_id": "5ddb4c13-2e30-4901-9854-5f0305097a25",
        "threeds_version": "2.1.0"
    }
}