Authorization advice received
Last updated: September 24, 2025
This Issuing event occurs when the card scheme responds to an authorization request on our behalf because Checkout.com is not reachable, or when a transaction is performed at a gas station or ATM.
If the notification is for:
- An automated fuel dispenser (AFD) transaction – Debit the cardholder's balance accordingly.
- A decline – No further action is required.
1{2"id": "evt_az5sblvku4ge3dwpztvyizgcau",3"type": "authorization_advice_received",4"version": "2.0.0",5"created_on": "2018-04-10T08:13:14Z",6"data": {7"id": "msg_abcd5fg6hievapshljklmnop4",8"card": {9"id": "crd_fa6psq242dcd6fdn5gifcq1491",10"scheme" : "mastercard"11},12"cardholder":{13"id": "crh_urdihafyo75evcr55s62jmwwhy"14},15"entity":{16"id": "ent_urdihafyo75evcr55s62jmwwhy"17},18"client":{19"id": "cli_urdihafyo75evcr55s62jmwwhy"20},21"transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",22"transaction_type": "purchase",23"transmission_date_time": "2018-04-10T08:12:14Z",24"local_transaction_date_time": "2018-04-10T08:12:14",25"transaction_amount": 1000,26"transaction_currency": "GBP",27"billing_amount": 900,28"billing_currency": "EUR",29"billing_conversion_rate": 0.925643,30"scheme_response_summary": "do_not_honour",31"digital_card_information": {32"digital_card_id": "dcr_fa6psq242dcd6fdn5gifcq1491",33"device_type": "phone",34"wallet_type": "apple_pay"35},36"merchant": {37"merchant_id": "59889",38"name" : "Carrefour",39"city": "Paris",40"state": "",41"country": "FRA",42"category_code": "5021",43"street_address": "Wenlock Works, Shepherdess Walk"44},45"advice_reason": "banknet_system_not_available",46"advice_initiator": "scheme",47"transit_information": {48"transaction_type": "authorized_aggregated_split_clearing",49"transportation_mode": "urban_bus"50},51"point_of_sale_transaction_date" : "2023-04-25",52"pos": {53"country_code": "GBR",54"postal_code": "SE100ER",55"card_present": "present",56"cardholder_present": "not_present",57"entry_mode": "ecommerce"58}59}60}
Field name | Description |
---|---|
string | The transaction message's unique identifier, prefixed with |
object | The card details. |
object | The cardholder's details. See the Cardholder object. |
object | The entity details. See the Entity object. |
object | Your details as a Checkout.com client. See the Client object. |
string | The transaction's unique identifier, prefixed with |
string | The type of transaction. This can be one of:
|
string | The date and time when the message was received from the scheme, in UTC. |
string optional | The local date and time indicating when the transaction was initiated. |
uint64 | The authorization's transaction amount, in minor currency units. |
string | The acquirer’s local currency, or the local currency of the transaction’s source location. |
uint64 | The clearing's billing amount, in minor currency units. If currency conversion is required, this is based on Mastercard rates. |
string | The currency in which you will bill the cardholder. |
double | The scheme conversion rate used to convert the transaction amount to the billing amount. |
object optional | The digital card's details. |
object | The merchant's details. See the Merchant object. |
string | The response decision received from the scheme's network. This can be one of:
|
string | The general purpose of the advice message. This can be one of:
|
string | The party that initiated the advice. This can be one of:
|
object optional | The transit transaction details. |
string optional | The date of the transaction at the point of sale. |
object optional | The conditions at the point of sale (PoS) at the time of the transaction. |
Field name | Description |
---|---|
string | The card's unique identifier, prefixed with |
string | The card scheme that processed the payment.
|
Field name | Description |
---|---|
string | The digital card's unique identifier, prefixed with |
string | The type of device used for the transaction. This can be one of:
|
string optional | The type of wallet. This can be one of:
|
Field name | Description |
---|---|
string | The merchant's unique identifier. This may vary from one acquirer to another. |
string | The merchant's name. |
string | The city of the merchant's address. |
string optional | For US merchants, the state of the merchant's address. For other merchants, the value is |
string | The country of the merchant's address. |
string | The four-digit merchant category code (MCC) for this transaction. Merchants can have multiple category codes. |
string | The street of the merchant's address. |
Field name | Description |
---|---|
string | The authorization model used by the transit operator. This can be one of:
|
string | The transport method used to travel. This can be one of:
|
Field name | Description |
---|---|
string | The cardholder's unique identifier, prefixed with |
Field name | Description |
---|---|
string | The entity's unique identifier, prefixed with |
Field name | Description |
---|---|
string | Your unique identifier as a Checkout.com client, prefixed with |
Field name | Description |
---|---|
string | The country where the point of sale is located. |
string | The ZIP or postal code where the point of sale is located. |
string | Indicates if the card was present to initiate the transaction. This can be one of:
|
string | Indicates if the cardholder was present to initiate the transaction. This can be one of:
|
string | The method by which the card initiated the transaction at a terminal. This can be one of:
|