Authorizations Report

Last updated: January 22, 2025

The Authorizations Report lists all authorization messages during a specified period. It provides information about:

The authorization, the related transaction, and their statuses
The card, its verification process, and any 3D Secure (3DS) challenge
The conditions at the point of sale (PoS)
Whether the authorization relay passed the authorization to you
Any user-defined fields you specified during setup

The report is provided as a CSV file. By default, the file name uses the following format:

issuing_authorizations_{EntityID}_{Start Date: YYYYMMDD}_{End Date:YYYYMMDD}_1.csv

The report data is refreshed daily at 01:00:00 UTC.

See instructions on how to download the report on demand or on a schedule:

Download a sample report (CSV file).

Information

If using Safari, hold down the Option key when selecting the link to download the file.

The report includes the following fields in this order:

Field name Description

Field name	Description
Message ID string	The unique identifier for the authorization message. Example – `msg_abcdef1ghijklmn23opq45r6st`
Client ID string	Your unique identifier from Checkout.com. Example – `cli_abcdef1ghijklmn23opq45r6st`
Client Name string	Your Checkout.com client name.
Entity ID string	The unique identifier for your Checkout.com entity. Example – `ent_abcdef1ghijklmn23opq45r6st`
Entity Name string	The name of your Checkout.com entity.
Cardholder ID string	The unique identifier for the cardholder. Example – `crh_abcdef1ghijklmn23opq45r6st`
Card ID string	The unique identifier for the card. Example – `crd_abcdef1ghijklmn23opq45r6st`
Transaction ID string	The unique identifier for the transaction, which links all related authorization, reversal, and clearing messages. Example – `trx_abcdef1ghijklmn23opq45r6st`
Type string	The type of message. This can be one of: `authorization_advice` – A transaction to modify an authorization – For example, an adjustment, amount change, or card hold `authorization` – An authorization request `reversal` – A request to undo an authorization before presentment or clearing `reversal_advice` – A message from the acquirer reversing an authorization request
Indicator string	The type of authorization. This can be one of: `deferred_authorization` – When the merchant sends you an authorization to indicate transactions that were mainly done during mass transit, from automated fuel dispensers (AFD), or offline mode `incremental_pre_authorization` – A request to increase the total authorized amount before the payment is captured `final_authorization` – When the final amount is known, unless there is a technical issue between the merchant and the card scheme `full_reversal` – A reversal of the full transaction amount `normal_authorization` – The transaction was fully processed by the merchant at the point of sale `partial_reversal` – A reversal of part of the transaction amount `pre_authorization` – A temporary hold on funds on the card to cover the transaction amount `unknown` – Any other type of authorization
Transaction Type string	The type of transaction. This can be one of: `cash_advance` – A short-term cash loan you give to a cardholder `cashback` – When cash is returned on top of a purchase `balance_inquiry` – When the cardholder checks the balance on the card `payment` – A payment for goods or service `pin_change` – When the cardholder changes their PIN at an ATM `pin_unblock` – When the cardholder unblocks their PIN at an ATM `purchase` – A purchase of goods or services `refund` – A credit to the cardholder's account as a full or partial refund for a purchase `remittance_funding` – When funds are added to a remittance account `remittance_payment` – When the cardholder transfers funds to another party, often internationally `withdrawal` – A cash withdrawal from an ATM `unique transaction` – A quasi-cash payment using, for example, gaming tokens, cryptocurrency, travelers' cheques `unknown` – Any other type of transaction
Is Cleared boolean	Indicates whether the payment has cleared: `false` (default) – The payment is not yet cleared. `true` – The payment is cleared.
Is Relayed boolean	Indicates whether authorization relay sent you the authorization to approve or decline: `false` (default) – The authorization was not relayed. `true` – The authorization was relayed.
Status string	The status of the authorization. This can be one of: `approved` – You approved the authorization. `declined` – You declined the authorization.
Decline Reason string	The decline code you provided when you declined the authorization. If you approved the authorization, this field is empty.
Verification Result Cryptogram string	Indicates whether the card’s identity was successfully verified. This can be one of: `unverified` – The card’s identity was not successfully verified. `verified` – The card’s identity was successfully verified.
Verification Result CVC1 string	Indicates whether the card validation code (CVC1) encoded in the magnetic stripe was successfully verified. This can be one of: `unverified` – The CVC1 was not successfully verified. `verified` – The CVC1 was successfully verified.
Verification Result CVC2 string	Indicates whether the card validation code (CVC2) printed on the card is valid. This can be one of: `invalid` – The CVC2 is not valid. `valid` – The CVC2 is valid.
Verification Result Expiry Date string	Indicates whether the card’s expiry date is still valid. This can be one of: `invalid` – The card has expired. `valid` – The card has not expired.
Verification Result PVV string	Indicates whether the pin verification value (PVV) was successfully verified. This can be one of: `unverified` – The PVV was not successfully verified. `verified` – The PVV was successfully verified.
Verification Result Service Code string	Indicates whether the three or four-digit number that specifies the card’s acceptance requirements and transaction limitations was successfully verified. This can be one of: `unverified` – The service code was not successfully verified. `verified` – The service code was successfully verified.
Transaction Currency string	The acquirer's local currency or the local currency where the transaction took place. Format – ISO 4217 code
Transaction Amount decimal	The amount for the transaction in the major currency unit. Format – Fixed-point notation with up to eight decimal places Example – 500 USD is represented as `500.00` More information – Calculating the amount
Billing Currency string	The currency you bill the cardholder in. Format – ISO 4217 code
Billing Amount decimal	The amount to bill the cardholder in the major currency unit. Format – Fixed-point notation with up to eight decimal places Example – 500 USD is represented as `500.00` More information – Calculating the amount
Is Issuer Reversed boolean	Indicates whether you, as the issuer, reversed the transaction: `false` (default) – You have not reversed the transaction. `true` – You reversed the transaction.
Issuer Reversed Billing Amount decimal	The billing amount you reversed for the transaction in the major currency unit. Format – Fixed-point notation with up to eight decimal places Example – 500 USD is represented as `500.00` More information – Calculating the amount
3DS Version string	The 3D Secure (3DS) protocol version used for authorization. This can be one of: `1` – 3DS version 1 `2` – 3DS version 2 empty – 3DS was not used
Requested Exemption Type string	The type of exemption from 3DS requested for the transaction. This can be one of: `acquirer_transaction_risk_analysis` – The acquirer performed a risk analysis on the transaction. `authentication_outage_exception` – An outage prevented the merchant or acquirer from completing authentication. `low_value_payment` – The transaction amount is less than 30 EUR. `merchant_initiated_transaction` – The merchant initiated the transaction under a previous agreement with the cardholder. `not_applicable` – 3DS is not required for this transaction. `not_requested` – 3DS was not requested for this transaction. `recurring_payment` – This is a recurring payment under a previous agreement with the cardholder. `secure_corporate_payment` – The transaction was initiated by a corporate customer, or from a secure corporate environment. `secure_customer_authentication_delegation` – The transaction carries low fraud risk, is with a trusted merchant, or passed a risk analysis.
Has ECB Conversion Rate boolean	Indicates whether currency conversion is required at the European Central Bank (ECB) rate: `false` (default) – Currency conversion is not required. `true` – Currency conversion is required.
ECB Conversion Rate decimal	The European Central Bank (ECB) currency conversion rate against the euro applied to the transaction. Example – For GBP:EUR, the conversion rate is represented as `0.842293`
Merchant ID string	The unique identifier for the merchant. This may vary per acquirer.
Merchant Category Code integer	The merchant's four-digit category code. Merchants can have multiple category codes.
Merchant Name string	The merchant's company name.
Merchant Country Code string	The country where the merchant is registered. Format – ISO alpha-3 country code
Merchant State string	For US merchants, the state where they are registered. For merchants outside the US, this value is `null`.
Merchant City string	The city where the merchant is registered.
POS Entry Mode string	The way the payment was captured at the point of sale (PoS). This can be one of: `contact_chip` – The card chip touched the PoS terminal. `contactless_chip` – The terminal read the card chip via near-field communication (NFC). `contactless_magstripe`– The terminal read the card's magnetic stripe via NFC. `ecommerce` – The card details were entered in a website or app. `magstripe` – The card's magnetic stripe touched the terminal. `manual` - The card details were manually entered into the terminal, or the customer used cash, check, or money order. `optical_character_recognition` – The card details were captured using optical character recognition (OCR). `optical_code` – The merchant's optical scanner or device read a Quick Response (QR) code. `server` – The card details were passed directly from the merchant's server to the payment platform. `other` – Any other way of capturing payment.
Digital Card ID string	The unique identifier for the digital card. For a physical card, this field is empty.
Verification Result Digital Card Expiry Date string	Indicates whether the digital card was successfully verified. This can be one of: `unverified` – The digital card was not successfully verified. `verified` – The digital card was successfully verified.
Xpay Device Type string	The type of device used for an Xpay transaction. Example – Smartphone, smartwatch If not relevant, this field is empty.
Xpay Wallet Type string	The type of digital wallet used for an Xpay transaction. Example – Apple Pay, Google Pay If not relevant, this field is empty.
Created On UTC datetime	The date and time when the transaction was initiated in UTC. Format – ISO 8601 Example – `2020-01-31T10:20:30.456`
Transmitted By Scheme on UTC datetime	The date and time when the card scheme transmitted the authorization in UTC. Format – ISO 8601 Example – `2020-01-31T10:20:30.456`
Card Type string	The type of card. This can be one of: `physical` – A physical card `virtual` – A non-physical card for card-not-present transactions only
Card Status string	The current status of the card. This can be one of: `active` – The card is activated and not subject to any restrictions. `inactive` – The card is awaiting activation. `revoked` – You have canceled the card and all incoming authorizations will be declined. `suspended` – You have frozen the card and all transactions will be declined.
Card Masked PAN string	The masked primary account number (PAN) for the card. Example – `1234 56 ** 7890`
Card Expiry Date datetime	The date and time when the card expires in UTC. Format – ISO 8601 Example – `2020-01-31T10:20:30.456`
Card Issuing Country string	The country where you issued the card. Format – ISO alpha-3 country code
Card Display Name string	The display name you provided when creating the card.
Card Reference string	The identification reference you provided when creating the card.
Card UDF 1 string	A user-defined field (UDF) you specified during setup.
Card UDF 2 string	A UDF you specified during setup.
Card UDF 3 string	A UDF you specified during setup.
Card UDF 4 string	A UDF you specified during setup.
Card UDF 5 string	A UDF you specified during setup.

Message ID

string

The unique identifier for the authorization message.
Example – msg_abcdef1ghijklmn23opq45r6st

Client ID

string

Your unique identifier from Checkout.com.
Example – cli_abcdef1ghijklmn23opq45r6st

Client Name

string

Your Checkout.com client name.

Entity ID

string

The unique identifier for your Checkout.com entity.
Example – ent_abcdef1ghijklmn23opq45r6st

Entity Name

string

The name of your Checkout.com entity.

Cardholder ID

string

The unique identifier for the cardholder.
Example – crh_abcdef1ghijklmn23opq45r6st

Card ID

string

The unique identifier for the card.
Example – crd_abcdef1ghijklmn23opq45r6st

Transaction ID

string

The unique identifier for the transaction, which links all related authorization, reversal, and clearing messages.
Example – trx_abcdef1ghijklmn23opq45r6st

Type

string

The type of message. This can be one of:

authorization_advice – A transaction to modify an authorization – For example, an adjustment, amount change, or card hold
authorization – An authorization request
reversal – A request to undo an authorization before presentment or clearing
reversal_advice – A message from the acquirer reversing an authorization request

Indicator

string

The type of authorization. This can be one of:

deferred_authorization – When the merchant sends you an authorization to indicate transactions that were mainly done during mass transit, from automated fuel dispensers (AFD), or offline mode
incremental_pre_authorization – A request to increase the total authorized amount before the payment is captured
final_authorization – When the final amount is known, unless there is a technical issue between the merchant and the card scheme
full_reversal – A reversal of the full transaction amount
normal_authorization – The transaction was fully processed by the merchant at the point of sale
partial_reversal – A reversal of part of the transaction amount
pre_authorization – A temporary hold on funds on the card to cover the transaction amount
unknown – Any other type of authorization

Transaction Type

string

The type of transaction. This can be one of:

cash_advance – A short-term cash loan you give to a cardholder
cashback – When cash is returned on top of a purchase
balance_inquiry – When the cardholder checks the balance on the card
payment – A payment for goods or service
pin_change – When the cardholder changes their PIN at an ATM
pin_unblock – When the cardholder unblocks their PIN at an ATM
purchase – A purchase of goods or services
refund – A credit to the cardholder's account as a full or partial refund for a purchase
remittance_funding – When funds are added to a remittance account
remittance_payment – When the cardholder transfers funds to another party, often internationally
withdrawal – A cash withdrawal from an ATM
unique transaction – A quasi-cash payment using, for example, gaming tokens, cryptocurrency, travelers' cheques
unknown – Any other type of transaction

Is Cleared

boolean

Indicates whether the payment has cleared:

false (default) – The payment is not yet cleared.
true – The payment is cleared.

Is Relayed

boolean

Indicates whether authorization relay sent you the authorization to approve or decline:

false (default) – The authorization was not relayed.
true – The authorization was relayed.

Status

string

The status of the authorization. This can be one of:

approved – You approved the authorization.
declined – You declined the authorization.

Decline Reason

string

The decline code you provided when you declined the authorization.

If you approved the authorization, this field is empty.

Verification Result Cryptogram

string

Indicates whether the card’s identity was successfully verified. This can be one of:

unverified – The card’s identity was not successfully verified.
verified – The card’s identity was successfully verified.

Verification Result CVC1

string

Indicates whether the card validation code (CVC1) encoded in the magnetic stripe was successfully verified. This can be one of:

unverified – The CVC1 was not successfully verified.
verified – The CVC1 was successfully verified.

Verification Result CVC2

string

Indicates whether the card validation code (CVC2) printed on the card is valid. This can be one of:

invalid – The CVC2 is not valid.
valid – The CVC2 is valid.

Verification Result Expiry Date

string

Indicates whether the card’s expiry date is still valid. This can be one of:

invalid – The card has expired.
valid – The card has not expired.

Verification Result PVV

string

Indicates whether the pin verification value (PVV) was successfully verified. This can be one of:

unverified – The PVV was not successfully verified.
verified – The PVV was successfully verified.

Verification Result Service Code

string

Indicates whether the three or four-digit number that specifies the card’s acceptance requirements and transaction limitations was successfully verified. This can be one of:

unverified – The service code was not successfully verified.
verified – The service code was successfully verified.

Transaction Currency

string

The acquirer's local currency or the local currency where the transaction took place.
Format – ISO 4217 code

Transaction Amount

decimal

The amount for the transaction in the major currency unit.
Format – Fixed-point notation with up to eight decimal places
Example – 500 USD is represented as 500.00
More information – Calculating the amount

Billing Currency

string

The currency you bill the cardholder in.
Format – ISO 4217 code

Billing Amount

decimal

The amount to bill the cardholder in the major currency unit.
Format – Fixed-point notation with up to eight decimal places
Example – 500 USD is represented as 500.00
More information – Calculating the amount

Is Issuer Reversed

boolean

Indicates whether you, as the issuer, reversed the transaction:

false (default) – You have not reversed the transaction.
true – You reversed the transaction.

Issuer Reversed Billing Amount

decimal

The billing amount you reversed for the transaction in the major currency unit.
Format – Fixed-point notation with up to eight decimal places
Example – 500 USD is represented as 500.00
More information – Calculating the amount

3DS Version

string

The 3D Secure (3DS) protocol version used for authorization. This can be one of:

1 – 3DS version 1
2 – 3DS version 2
empty – 3DS was not used

Requested Exemption Type

string

The type of exemption from 3DS requested for the transaction. This can be one of:

acquirer_transaction_risk_analysis – The acquirer performed a risk analysis on the transaction.
authentication_outage_exception – An outage prevented the merchant or acquirer from completing authentication.
low_value_payment – The transaction amount is less than 30 EUR.
merchant_initiated_transaction – The merchant initiated the transaction under a previous agreement with the cardholder.
not_applicable – 3DS is not required for this transaction.
not_requested – 3DS was not requested for this transaction.
recurring_payment – This is a recurring payment under a previous agreement with the cardholder.
secure_corporate_payment – The transaction was initiated by a corporate customer, or from a secure corporate environment.
secure_customer_authentication_delegation – The transaction carries low fraud risk, is with a trusted merchant, or passed a risk analysis.

Has ECB Conversion Rate

boolean

Indicates whether currency conversion is required at the European Central Bank (ECB) rate:

false (default) – Currency conversion is not required.
true – Currency conversion is required.

ECB Conversion Rate

decimal

The European Central Bank (ECB) currency conversion rate against the euro applied to the transaction.
Example – For GBP:EUR, the conversion rate is represented as 0.842293

Merchant ID

string

The unique identifier for the merchant.

This may vary per acquirer.

Merchant Category Code

integer

The merchant's four-digit category code.

Merchants can have multiple category codes.

Merchant Name

string

The merchant's company name.

Merchant Country Code

string

The country where the merchant is registered.
Format – ISO alpha-3 country code

Merchant State

string

For US merchants, the state where they are registered.

For merchants outside the US, this value is null.

Merchant City

string

The city where the merchant is registered.

POS Entry Mode

string

The way the payment was captured at the point of sale (PoS). This can be one of:

contact_chip – The card chip touched the PoS terminal.
contactless_chip – The terminal read the card chip via near-field communication (NFC).
contactless_magstripe– The terminal read the card's magnetic stripe via NFC.
ecommerce – The card details were entered in a website or app.
magstripe – The card's magnetic stripe touched the terminal.
manual - The card details were manually entered into the terminal, or the customer used cash, check, or money order.
optical_character_recognition – The card details were captured using optical character recognition (OCR).
optical_code – The merchant's optical scanner or device read a Quick Response (QR) code.
server – The card details were passed directly from the merchant's server to the payment platform.
other – Any other way of capturing payment.

Digital Card ID

string

The unique identifier for the digital card.

For a physical card, this field is empty.

Verification Result Digital Card Expiry Date

string

Indicates whether the digital card was successfully verified. This can be one of:

unverified – The digital card was not successfully verified.
verified – The digital card was successfully verified.

Xpay Device Type

string

The type of device used for an Xpay transaction.
Example – Smartphone, smartwatch

If not relevant, this field is empty.

Xpay Wallet Type

string

The type of digital wallet used for an Xpay transaction.
Example – Apple Pay, Google Pay

If not relevant, this field is empty.

Created On UTC

datetime

The date and time when the transaction was initiated in UTC.
Format – ISO 8601
Example – 2020-01-31T10:20:30.456

Transmitted By Scheme on UTC

datetime

The date and time when the card scheme transmitted the authorization in UTC.
Format – ISO 8601
Example – 2020-01-31T10:20:30.456

Card Type

string

The type of card. This can be one of:

physical – A physical card
virtual – A non-physical card for card-not-present transactions only

Card Status

string

The current status of the card. This can be one of:

active – The card is activated and not subject to any restrictions.
inactive – The card is awaiting activation.
revoked – You have canceled the card and all incoming authorizations will be declined.
suspended – You have frozen the card and all transactions will be declined.

Card Masked PAN

string

The masked primary account number (PAN) for the card.
Example – 1234 56** **** 7890

Card Expiry Date

datetime

The date and time when the card expires in UTC.
Format – ISO 8601
Example – 2020-01-31T10:20:30.456

Card Issuing Country

string

The country where you issued the card.
Format – ISO alpha-3 country code

Card Display Name

string

The display name you provided when creating the card.

Card Reference

string

The identification reference you provided when creating the card.

Card UDF 1

string

A user-defined field (UDF) you specified during setup.

Card UDF 2

string

A UDF you specified during setup.

Card UDF 3

string

A UDF you specified during setup.

Card UDF 4

string

A UDF you specified during setup.

Card UDF 5

string

A UDF you specified during setup.

Authorizations Report

Report format

Report availability

Sample report

Information

Report fields