# Authorization advice received

This [Issuing](https://www.checkout.com/docs/card-issuing.md) 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.

## Example webhook

```json
{
  "id": "evt_az5sblvku4ge3dwpztvyizgcau",
  "type": "authorization_advice_received",
  "version": "2.0.0",
  "created_on": "2018-04-10T08:13:14Z",
  "data": {
    "id": "msg_abcd5fg6hievapshljklmnop4",
    "card": {
      "id": "crd_fa6psq242dcd6fdn5gifcq1491",
      "scheme" : "mastercard"
    },
    "cardholder":{
      "id": "crh_urdihafyo75evcr55s62jmwwhy"
    },
    "entity":{
      "id": "ent_urdihafyo75evcr55s62jmwwhy"
    },
    "client":{
      "id": "cli_urdihafyo75evcr55s62jmwwhy"
    },
    "transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",
    "transaction_type": "purchase",
    "transmission_date_time": "2018-04-10T08:12:14Z",
    "local_transaction_date_time": "2018-04-10T08:12:14",
    "transaction_amount": 1000,
    "transaction_currency": "GBP",
    "billing_amount": 900,
    "billing_currency": "EUR",
    "billing_conversion_rate": 0.925643,
    "scheme_response_summary": "do_not_honour",
    "authorization_code": "03C0C0",
    "digital_card_information": {             
      "digital_card_id": "dcr_fa6psq242dcd6fdn5gifcq1491",
      "device_type": "phone",                 
      "wallet_type": "apple_pay"              
    },
    "acquirer": {
      "id": "748846"
    },
    "merchant": {
      "merchant_id": "59889",
      "name" : "Carrefour",
      "city": "Paris",
      "state": "",                            
      "country": "FRA",                   
      "category_code": "5021",
      "street_address": "Wenlock Works, Shepherdess Walk"
    },
    "advice_reason": "acquirer_decision",
    "advice_initiator": "scheme",
    "transit_information": {
        "transaction_type": "authorized_aggregated_split_clearing",
        "transportation_mode": "urban_bus"
    },
    "point_of_sale_transaction_date" : "2023-04-25",
    "pos": {
      "country_code": "GBR",
      "postal_code": "SE100ER",
      "card_present": "present",
      "cardholder_present": "not_present",
      "entry_mode": "ecommerce"
    }
  }
}
```
---

## Webhook fields

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The event's unique identifier, prefixed with `evt_`. |
| `type`<br>`string` | The type of event. <br><br>This value is `authorization_advice_received`. |
| `version`<br>`string` | The webhook's version. |
| `created_on`<br>`date-time` | The date and time when the event occurred, in UTC. <br>Standard – ISO 8601 code <br>Example – `yyyy-mm-ddThh:mm:ss.sss` |
| `data`<br>`object` | The webhook message. <br><br>See the [Data](#Data_object) object. |

## Data object

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The transaction message's unique identifier, prefixed with `msg_`. |
| `card`<br>`object` | The card details. <br><br>See the [Card](#Card_object) object. |
| `cardholder`<br>`object` | The cardholder's details. See the [Cardholder](#Cardholder_object) object. |
| `entity`<br>`object` | The entity details. See the [Entity](#Entity_object) object. |
| `client`<br>`object` | Your details as a Checkout.com client. See the [Client](#Client_object) object. |
| `transaction_id`<br>`string` | The transaction's unique identifier, prefixed with `trx_`. |
| `transaction_type`<br>`string` | The type of transaction. This can be one of:<br>- `balance_inquiry`<br>- `bill_payment`<br>- `cashback`<br>- `pin_change`<br>- `pin_unblock`<br>- `purchase`<br>- `purchase_account_inquiry`<br>- `refund`<br>- `remittance_funding`<br>- `withdrawal` |
| `transmission_date_time`<br>`string` | The date and time when the message was received from the scheme, in UTC. <br>Standard – ISO 8601 code <br>Format – `yyyy-mm-ddThh:mm:ss.sss` |
| `local_transaction_date_time`<br>`string`<br>`optional` | The local date and time indicating when the transaction was initiated. <br>Standard – ISO 8601 code <br>Format – `yyyy-mm-ddThh:mm:ss.sss` |
| `transaction_amount`<br>`uint64` | The authorization's transaction amount, in [minor currency units](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). |
| `transaction_currency`<br>`string` | The acquirer’s local currency, or the local currency of the transaction’s source location. <br>Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md) <br>Example – `USD` |
| `billing_amount`<br>`uint64` | The clearing's billing amount, in minor currency units. If currency conversion is required, this is based on [Mastercard rates](https://www.mastercard.com/global/en/personal/get-support/convert-currency.html). |
| `billing_currency`<br>`string` | The currency in which you will bill the cardholder. <br>Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md) <br>Example – `USD` |
| `billing_conversion_rate`<br>`double` | The scheme conversion rate used to convert the transaction amount to the billing amount. |
| `digital_card_information`<br>`object`<br>`optional` | The digital card's details. <br><br>See the [Digital card information](#Digital_card_information_object) object. |
| `acquirer`<br>`object` | The acquirer details. See the [Acquirer](#Acquirer_object) object. |
| `merchant`<br>`object` | The merchant's details. See the [Merchant](#Merchant_object) object. |
| `scheme_response_summary`<br>`string` | The response decision received from the scheme's network. This can be one of:<br>- `invalid_card_number`<br>- `system_malfunction`<br>- `do_not_honour`<br>- `invalid_pin`<br>- `security_violation`<br>- `approved`<br>- `restricted_card`<br>- `format_error`<br>- `security` |
| `authorization_code`<br>`string` | The authorization code we generate when we approve the transaction. |
| `advice_reason`<br>`string` | The general purpose of the advice message. This can be one of:<br><br>- `acquirer_decision`<br>- `issuer_operational_problem`<br>- `other`<br>- `processing_problem`<br>- `regulatory_or_rule_or_service_decision`<br>- `risk_and_fraud_management`<br>- `transaction_data_validation` |
| `advice_initiator`<br>`string` | The party that initiated the advice. This can be one of:<br><br>- `acquirer`<br>- `issuer`<br>- `scheme` |
| `transit_information`<br>`object`<br>`optional` | The transit transaction details. <br><br>See the [Transit information](#Transit_information_object) object. |
| `point_of_sale_transaction_date`<br>`string`<br>`optional` | The date of the transaction at the point of sale. <br>Format – `yyyy-mm-dd` |
| `pos`<br>`object`<br>`optional` | The conditions at the point of sale (PoS) at the time of the transaction. <br><br>See the [POS](#POS_object) object. |

## Card object

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The card's unique identifier, prefixed with `crd`. |
| `scheme`<br>`string` | The card scheme that processed the payment. <br><br>This can be one of:<br><br>- `mastercard`<br>- `visa` |

### Digital card information object

| Field name | Description |
| --- | --- |
| `digital_card_id`<br>`string` | The digital card's unique identifier, prefixed with `dcr_`. |
| `device_type`<br>`string` | The type of device used for the transaction. This can be one of:<br>- `card`<br>- `device_peripheral`<br>- `domestic_appliance`<br>- `fashion_accessory`<br>- `garment`<br>- `jewelry`<br>- `key_fob`<br>- `media_or_gaming_device`<br>- `mobile_phone_case_or_sleeve`<br>- `mobile_phone_network_operator_controlled_fixed_secure_element`<br>- `mobile_phone_network_operator_controlled_removable_secure_element`<br>- `mobile_phone_not_network_operator_controlled_fixed_secure_element`<br>- `mobile_phone_not_network_operator_controlled_removable_secure_element`<br>- `mobile_phone_payment_application_host_processor`<br>- `mobile_phone_payment_application_tee_host_processor`<br>- `mobile_tag`<br>- `pc`<br>- `phone`<br>- `removable_secure_element_not_network_operator_controlled`<br>- `sticker`<br>- `tablet_or_e_book_network_operator_controlled_fixed_secure_element`<br>- `tablet_or_e_book_not_network_operator_controlled_fixed_secure_element`<br>- `tablet_or_e_reader`<br>- `tablet_or_e_reader_payment_application_host_processor`<br>- `tablet_or_e_reader_payment_application_tee_host_processor`<br>- `tablet_or_e_reader_network_operator_controlled_removable_secure_element`<br>- `tag`<br>- `vehicle`<br>- `watch_contactless_chip_or_not_network_operator_controlled_secure_element`<br>- `watch_or_wristband`<br>- `watch_payment_application_host_processor`<br>- `watch_payment_application_tee_host_processor`<br>- `wristband` |
| `wallet_type`<br>`string`<br>`optional` | The type of wallet. This can be one of:<br><br>- `apple_pay`<br>- `google_pay`<br>- `merchant`<br>- `samsung_pay` |

### Acquirer object

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The unique identifier for the acquirer. |

### Merchant object

| Field name | Description |
| --- | --- |
| `merchant_id`<br>`string` | The merchant's unique identifier.<br><br>This may vary from one acquirer to another. |
| `name`<br>`string` | The merchant's name. |
| `city`<br>`string` | The city of the merchant's address. |
| `state`<br>`string`<br>`optional` | For US merchants, the state of the merchant's address.<br><br>For other merchants, the value is `null`. |
| `country`<br>`string` | The country of the merchant's address. <br>Standard – [ISO alpha-3 country code](https://www.checkout.com/docs/developer-resources/testing/codes/country-codes.md) <br>Example – `USA` |
| `category_code`<br>`string` | The four-digit [merchant category code (MCC)](https://www.checkout.com/docs/developer-resources/testing/codes/merchant-category-codes.md) for this transaction.<br><br>Merchants can have multiple category codes. |
| `street_address`<br>`string` | The street of the merchant's address. |

### Transit information object

| Field name | Description |
| --- | --- |
| `transaction_type`<br>`string` | The authorization model used by the transit operator. This can be one of:<br><br>- `authorized_aggregated_split_clearing`<br>- `debt_recovery`<br>- `other`<br>- `post_authorized_aggregated`<br>- `post_authorized_aggregated_maestro`<br>- `prefunded`<br>- `real_time_authorized` |
| `transportation_mode`<br>`string` | The transport method used to travel. This can be one of:<br><br>- `cable_car`<br>- `coach`<br>- `commuter_train`<br>- `express_commuter_train`<br>- `funicular_train`<br>- `high_speed_train`<br>- `inter_city`<br>- `interurban_bus`<br>- `light_train_mass_transit`<br>- `locomotive`<br>- `other`<br>- `para_transit`<br>- `parking`<br>- `powered_motor_vehicle`<br>- `regional_train`<br>- `rural_bus`<br>- `self_drive_vehicle`<br>- `taxi`<br>- `toll`<br>- `trailer`<br>- `train`<br>- `urban_bus`<br>- `water_borne_vehicle` |

### Cardholder object

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The cardholder's unique identifier, prefixed with `crh_`. |

### Entity object

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The entity's unique identifier, prefixed with `ent_`. |

### Client object

| Field name | Description |
| --- | --- |
| `id`<br>`string` | Your unique identifier as a Checkout.com client, prefixed with `cli_`. |

### POS object

| Field name | Description |
| --- | --- |
| `country_code`<br>`string` | The country where the point of sale is located. <br>Standard – [ISO alpha-3 country code](https://www.checkout.com/docs/developer-resources/testing/codes/country-codes.md) <br>Example – `USA` |
| `postal_code`<br>`string` | The ZIP or postal code where the point of sale is located. |
| `card_present`<br>`string` | Indicates if the card was present to initiate the transaction. This can be one of:<br>- `present`<br>- `not_present`<br>- `unspecified` |
| `cardholder_present`<br>`string` | Indicates if the cardholder was present to initiate the transaction. This can be one of:<br>- `present`<br>- `not_present`<br>- `unspecified` |
| `entry_mode`<br>`string` | The method by which the card initiated the transaction at a terminal. This can be one of:<br>- `contact_chip`<br>- `contactless_chip`<br>- `contactless_magstripe`<br>- `credential_on_file`<br>- `ecommerce`<br>- `magstripe`<br>- `manual`<br>- `optical_character_recognition`<br>- `optical_code`<br>- `server`<br>- `other` |