Reversal approved

Last updated: September 24, 2025

This Issuing event occurs when a reversal is approved.

A reversal is a technical cancellation where an authorization hold is voided, without any movement of funds.

Information

For PIN change transactions, the online PIN is also reverted.


1{
2  "id": "evt_az5sblvku4ge3dwpztvyizgcau",
3  "type": "reversal_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      "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    "decision_source": "issuer",
22    "transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",
23    "transaction_type": "purchase",
24    "reversal_type": "full",
25    "transmission_date_time": "2018-04-10T08:12:14Z",
26    "local_transaction_date_time": "2018-04-10T08:12:14",
27    "reversal_amount": 1000,
28    "reversal_currency": "GBP",
29    "reversal_billing_amount": 900,
30    "reversal_billing_currency": "EUR",
31    "digital_card_information": {             
32      "digital_card_id": "dcr_fa6psq242dcd6fdn5gifcq1491",
33      "device_type": "phone",                 
34      "wallet_type": "apple_pay"              
35    }
36  }
37}

Field name Description

Field name	Description
`id` string	The transaction message's unique identifier, prefixed with `msg_`.
`card` object	The card details. See the Card object.
`cardholder` object	The cardholder's details. See the Cardholder object.
`entity` object	The entity's details. See the Entity object.
`client` object	Your details as a Checkout.com client. See the Client object.
`decision_source` string optional	The party that made the decision to approve or decline the authorization. This can be one of: `issuer` – You have authorization relay stand-in mode enabled and Checkout.com made the decision on your behalf while your server was temporarily unavailable. `scheme` – In the rare event that Checkout.com's server was temporarily unavailable, the card scheme made the decision based on risk rules.
`transaction_id` string	The transaction's unique identifier, which links together all related authorization, reversal, and clearing messages. This is prefixed with `trx_`.
`transaction_type` string	The type of transaction. This can be one of: `balance_inquiry` `bill_payment` `cashback` `pin_change` `pin_unblock` `purchase` `purchase_account_inquiry` `refund` `remittance_funding` `withdrawal`
`reversal_type` string	The type of the reversal received. This can be one of: `full` `partial`
`transmission_date_time` string	The date and time when the transaction message entered the scheme network, in UTC. Standard – ISO 8601 code Format – `yyyy-mm-ddThh:mm:ss.sss`
`local_transaction_date_time` string optional	The local date and time indicating when the transaction was initiated. Standard – ISO 8601 code Format – `yyyy-mm-ddThh:mm:ss.sss`
`reversal_amount` uint64	The reversal transaction amount, in the minor currency unit.
`reversal_currency` string	The acquirer’s local currency, or the local currency of the transaction’s source location. Standard – ISO 4217 code Example – `USD`
`reversal_billing_amount` uint64	The reversal's billing amount, in the minor currency unit. If currency conversion is required, this is based on Mastercard rates.
`reversal_billing_currency` string	The currency in which you will bill the cardholder. Standard – ISO 4217 code Example – `USD`
`digital_card_information` object optional	The digital card's details. See the Digital card information object.

id

string

The transaction message's unique identifier, prefixed with msg_.

card

object

The card details.
See the Card object.

cardholder

object

The cardholder's details. See the Cardholder object.

entity

object

The entity's details. See the Entity object.

client

object

Your details as a Checkout.com client. See the Client object.

decision_source

string

optional

The party that made the decision to approve or decline the authorization.
This can be one of:

issuer – You have authorization relay stand-in mode enabled and Checkout.com made the decision on your behalf while your server was temporarily unavailable.
scheme – In the rare event that Checkout.com's server was temporarily unavailable, the card scheme made the decision based on risk rules.

transaction_id

string

The transaction's unique identifier, which links together all related authorization, reversal, and clearing messages. This is prefixed with trx_.

transaction_type

string

The type of transaction. This can be one of:

balance_inquiry
bill_payment
cashback
pin_change
pin_unblock
purchase
purchase_account_inquiry
refund
remittance_funding
withdrawal

reversal_type

string

The type of the reversal received. This can be one of:

full
partial

transmission_date_time

string

The date and time when the transaction message entered the scheme network, in UTC.
Standard – ISO 8601 code
Format – yyyy-mm-ddThh:mm:ss.sss

local_transaction_date_time

string

optional

The local date and time indicating when the transaction was initiated.
Standard – ISO 8601 code
Format – yyyy-mm-ddThh:mm:ss.sss

reversal_amount

uint64

The reversal transaction amount, in the minor currency unit.

reversal_currency

string

The acquirer’s local currency, or the local currency of the transaction’s source location.
Standard – ISO 4217 code
Example – USD

reversal_billing_amount

uint64

The reversal's billing amount, in the minor currency unit.

If currency conversion is required, this is based on Mastercard rates.

reversal_billing_currency

string

The currency in which you will bill the cardholder.
Standard – ISO 4217 code
Example – USD

digital_card_information

object

optional

The digital card's details.
See the Digital card information object.

Field name Description

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

id

string

The card's unique identifier, prefixed with crd.

scheme

string

The card scheme that processed the payment.
This can be one of:

mastercard
visa

Field name Description

Field name	Description
`id` string	The cardholder's unique Checkout.com identifier.

id

string

The cardholder's unique Checkout.com identifier.

Field name Description

Field name	Description
`id` string	The entity's unique Checkout.com identifier.

id

string

The entity's unique Checkout.com identifier.

Field name Description

Field name	Description
`id` string	The client's unique Checkout.com identifier.

id

string

The client's unique Checkout.com identifier.

Field name Description

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

digital_card_id

string

The digital card's unique identifier, prefixed with dcr_.

device_type

string

The type of device used for the transaction. This can be one of:

card
device_peripheral
domestic_appliance
fashion_accessory
garment
jewelry
key_fob
media_or_gaming_device
mobile_phone_case_or_sleeve
mobile_phone_network_operator_controlled_fixed_secure_element
mobile_phone_network_operator_controlled_removable_secure_element
mobile_phone_not_network_operator_controlled_fixed_secure_element
mobile_phone_not_network_operator_controlled_removable_secure_element
mobile_phone_payment_application_host_processor
mobile_phone_payment_application_tee_host_processor
mobile_tag
pc
phone
removable_secure_element_not_network_operator_controlled
sticker
tablet_or_e_book_network_operator_controlled_fixed_secure_element
tablet_or_e_book_not_network_operator_controlled_fixed_secure_element
tablet_or_e_reader
tablet_or_e_reader_payment_application_host_processor
tablet_or_e_reader_payment_application_tee_host_processor
tablet_or_e_reader_network_operator_controlled_removable_secure_element
tag
vehicle
watch_contactless_chip_or_not_network_operator_controlled_secure_element
watch_or_wristband
watch_payment_application_host_processor
watch_payment_application_tee_host_processor
wristband

wallet_type

string

optional

The type of wallet. This can be one of:

apple_pay
google_pay
samsung_pay
merchant_tokenization_program

Reversal approved

Information

Example webhook

Webhook fields

Card object

Cardholder

Entity

Client

Digital card information