IssuerTransactionId

The issuer transaction Id is an authentication code for recurrent or stored credential transactions returned in the authorization or card validation (ZeroAuth) response.

1. The merchant sends request for first transaction authorization or card validation (ZeroAuth);
2. Cielo E-Commerce API requests authorization for acquirer, card brand, and issuer;
3. The card brand authorizes transaction or validates card and returns IssuerTransactionId;
4. Cielo E-Commerce API returns IssuerTransactionId to the merchant;
5. In the next requests, the merchant sends IssuerTransactionId obtained from the first or following transactions.

Why sending the issuer transaction Id?

The issuer transaction Id is important to improve authorization rates, because when the current transaction is related to the previous one, the issuer is able to identify that there has already been a previous transaction initiated by the cardholder.

The issuer transaction Id returned in the last transaction must be informed in the next requests.

Supported card brands:

• Mastercard;
• Visa;
• Elo.

Response example

The IssuerTransactionId is returned:

• After validating a card through ZeroAuth or
• In the authorization response for a cardholder-initiated transaction, in Payment.

Note: The IssuerTransactionId value may be different in each response for an authorization or card validation.

Please refer to the default request examples in Creating a credit card payment or validanting a card with ZeroAuth

See below a response example for a credit card transaction returning the IssuerTransactionId:

{  
   "MerchantOrderId":"2014111701",
   "Payment":{  
     "Type":"CreditCard",
     "Amount":15700,
     "Capture":true,
     "Recurrent":"true",
     "IssuerTransactionId": "580027442382078",
     "Installments" 1,
     "CreditCard":{  
         "CardNumber":"1234123412341231",
         "Holder":"Teste Holder",
         "ExpirationDate":"12/2030",
         "SaveCard":"false",
         "Brand":"Visa",
         "CardOnFile":{
            "Usage": "Used",
            "Reason":"Recurring"
         }
     }
   }
}