authorization_approved
Last updated: April 10, 2024
1{2"id": "evt_az5sblvku4ge3dwpztvyizgcau",3"type": "authorization_approved",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"metadata": {11"reference": "X-123456-N11",12"udf1": "metadata1",13"udf2": "metadata2",14"udf3": "metadata3",15"udf4": "metadata4",16"udf5": "metadata5"17}18},19"cardholder":{20"id": "crh_urdihafyo75evcr55s62jmwwhy"21},22"entity":{23"id": "ent_urdihafyo75evcr55s62jmwwhy"24},25"client":{26"id": "cli_urdihafyo75evcr55s62jmwwhy"27},28"transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",29"transaction_type": "purchase",30"transmission_date_time": "2018-04-10T08:12:14Z",31"local_transaction_date_time": "2018-04-10T08:12:14",32"authorization_type": "final_authorization",33"transaction_amount": 1000,34"transaction_currency": "GBP",35"billing_amount": 900,36"billing_currency": "EUR",37"billing_conversion_rate": 0.925643,38"ecb_conversion_rate": 0.9,39"digital_card_information": {40"digital_card_id": "dcr_fa6psq242dcd6fdn5gifcq1491",41"device_type": "phone",42"wallet_type": "apple_pay"43},44"merchant": {45"merchant_id": "59889",46"name" : "Acme Corporation",47"city": "Paris",48"state": "",49"country": "FRA",50"category_code": "5021",51"street_address": "Wenlock Works, Shepherdess Walk"52},53"transit_information": {54"transaction_type": "authorized_aggregated_split_clearing",55"transportation_mode": "urban_bus"56},57"point_of_sale_transaction_date" : "2023-04-25",58"reference_transaction": {59"transaction_id": "trx_fa6psq242dcd6fdn5gifcq1491",60"reference_type": "original_recurring"61},62"three_d_secure": {63"requested_exemption_or_exclusion": "merchant_initiated_transaction",64"sca_not_required_reason": "merchant_initiated_transaction"65},66"pos": {67"country_code": "GBR",68"postal_code": "SE100ER",69"card_present": "present",70"cardholder_present": "not_present",71"entry_mode": "ecommerce"72}73}74}
Field name | Description |
---|---|
string | The transaction's unique Checkout.com identifier. |
object | Information about the card associated with this transaction. See the Card section for more details. |
object | Information about the cardholder associated with this transaction. See the Cardholder section for more details. |
object | Information about the entity associated with this transaction. See the Entity section for more details. |
object | Information about the client associated with this transaction. See the Client section for more details. |
string | The ID of the transaction, which links together all related authorization, reversal, and clearing messages. |
string | The nature of transaction. This can be one of:
|
string | The date and time a message is entered into the scheme network, in UTC format. |
string | The local date and time indicating when the transaction was initiated. |
string | Type of authorization we've received from the scheme. This can be one of:
|
uint64 | The authorization's transaction amount, in minor currency units. See our documentation on calculating currency values for more information. |
string | The acquirer’s local currency, or the local currency of the transaction’s source location, as an ISO 4217 code. |
uint64 | The authorization's billing amount, in minor currency units. In case of a currency conversion, this will be based on Mastercard rates. See our documentation on calculating currency values for more information. |
string | The currency in which the issuer will bill the cardholder, as an ISO 4217 code. |
double | The scheme conversion rate used to convert the transaction amount to the billing amount. |
double optional | The European Central Bank (ECB) comparative rate that will be communicated to the cardholder for a currency conversion when the |
object | Information about the digital card associated with this transaction. See the Digital card information section for more details. |
object | Information about the merchant associated with this transaction. See the Merchant section for more details. |
object | The information used to identify transit transactions. See the Transit information section for more details. |
string | The transaction date when the customer used the card at the point of sale. |
object optional | Information about the referenced transaction. See the Reference transaction section for more details. |
object optional | Information about the transaction's 3DS. See the ThreeDSecure section for more details. |
object | Indicates the conditions that exist at the point of sale (PoS) at the time of the transaction. See the POS section for more details. |
Field name | Description |
---|---|
string | The card's unique Checkout.com identifier. |
object optional | User-defined metadata. For more details, refer to the request body fields in the Create a card endpoint. |
Field name | Description |
---|---|
string | The cardholder's unique Checkout.com identifier |
Field name | Description |
---|---|
string | The entity's unique Checkout.com identifier |
Field name | Description |
---|---|
string | The client's unique Checkout.com identifier |
Field name | Description |
---|---|
string | The digital card's unique Checkout.com identifier |
string optional | Type of device. This can be one of:
|
string optional | Type of wallet. This can be one of:
|
Field name | Description |
---|---|
string | The merchant's identifier. This may vary from one acquirer to another. |
string | The merchant's name. |
string | The city where the merchant is located. |
string optional | (Applicable only for the United States) The state where the merchant is located. |
string | The country where the merchant is located, as an ISO-3 code. |
string | The merchant's category codes. |
string | The merchant's street 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 reference transaction's unique Checkout.com identifier |
string | Type of reference transaction. This can be one of:
|
Field name | Description |
---|---|
string optional | The exemption or exclusion requested by the acquirer/merchant. This can be one of:
|
string optional | The exemption or exclusion used to approve an unauthenticated authorization. This can be one of:
|
Field name | Description |
---|---|
string | The country code where the PoS is located. |
string | The postal code where the PoS 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 a card initiates a transaction at a terminal. This can be one of:
|