Skip to content

Token transactions

Token data

Use parameter TokenData for the token cryptogram. TAVV for Visa, DSRP for Mastercard. and Token Data Block A for Amex. If the the Amex cryptogram includes Token Data Block B, use parameter TransXID for that.

ClickToPay tokens can be used in token transactions.

EMV 3DS

When a merchant wants to authenticate a token transaction the parameters CAVD and dsTransId must be included.

ECI

The ECI value of the transaction should be included. If the transaction has been authenticated through EMV 3DS, use the value from the authentication response. Otherwise use the ECI value from the token provider.

Use additional data tag number 02 to indicate the ECI. See description -> Additional Data Details

MasterCard token transactions

Applicable TransType's are:

Number Description
1B tokenized transaction

MasterCard Token Identifier

Provides information about transactions initiated through the Masterpass Online platform or through the Mastercard Digital Enablement Service (MDES) and indicates who the Token Provider was for the transaction.

Use additional data tag number 05 to indicate the token identifier. See description -> Additional Data Details

MasterCard dynamic linking

To deliver increased transparency and security, MasterCard is providing dynamic linking of the authorization and cryptographic data. The new features consist of the introduction of a new cryptogram type that will contain the additional information needed to dynamically link the transaction to a specific amount and merchant. This amount may not always be the final amount

If you are using the new cryptogram, please provide the following parameters:

  • EstimatedAmount (will contain the estimated purchase amount of the transaction when the payment request is presented to the consumer during checkout)
  • RemoteCommerceAcceptorIdentifier (will be an identifier for the intended acceptor of payment credentials, usually the online store, merchant application and/or commerce platform facilitating the sale as presented to the consumer during checkout)

Use additional data tag number 06 and 07 -> Additional Data Details