Presentment reversed

Last updated: February 19, 2025

This Issuing event occurs when Checkout.com is notified of an error in or duplication of a previous presentment.

A presentment reversal is a technical cancellation where funds are moved from the merchant to the cardholder.


1{
2  "id": "evt_cz5sblvku4ge3dwpztvyizgczq",
3  "type": "presentment_reversed",
4  "version": "2.0.0",
5  "created_on": "2023-12-10T08:13:14Z",
6  "data": {
7    "id": "msg_ab5cde131fghj8qw5ertyu2372",
8    "card": {
9      "id": "crd_fa6psq242dcd6fdn5gifcq1491"
10    },
11    "entity": {
12      "id": "ent_fa6psq242dcd6fdn5gifcq1491"
13    },
14    "client": {
15      "id": "cli_fa6psq242dcd6fdn5gifcq1491"
16    },
17    "cardholder": {
18      "id": "crh_fa6psq242dcd6fdn5gifcq1491"
19    },
20    "transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",
21    "transmitted_by_scheme_on": "2018-04-10T08:12:14Z",
22    "transaction_locally_initiated_on": "2018-04-10T04:12:14",
23    "transaction_amount": 1000,
24    "transaction_currency": "GBP",
25    "billing_amount": 1200,
26    "billing_currency": "EUR",
27    "billing_conversion_rate": 0.92,
28    "reconciliation_amount": 1200,
29    "reconciliation_currency": "EUR",
30    "reconciliation_conversion_rate": 0.92,
31    "digital_card": {
32      "id": "dcr_fa6psq242dcd6fdn5gifcq1491",
33      "device_type": "phone",
34      "wallet_type": "applepay"
35    },
36    "original_transaction_type": "purchase",
37    "settled_on": "2018-04-11",
38    "transit_information": {
39      "transaction_type": "authorized_aggregated_split_clearing",
40      "transportation_mode": "urban_bus"
41    },
42    "merchant": {
43      "id": "59889",
44      "name": "Hannah Bret",
45      "city": "Paris",
46      "state": "",
47      "country": "FRA",
48      "category_code": "5021",
49      "street_address": "261, Example street"
50    },
51    "pos": {
52      "country_code": "GBR",
53      "postal_code": "SE100ER",
54      "card_present": "present",
55      "cardholder_present": "not_present",
56      "entry_mode": "contactless_chip"
57    }
58  }
59}

Field name Description

Field name	Description
`id` string	The transaction's unique Checkout.com identifier.
`card` object	Information about the card associated with this transaction. See the Card section for more details.
`cardholder` object	Information about the cardholder associated with this transaction. See the Cardholder section for more details.
`entity` object	Information about the entity associated with this transaction. See the Entity section for more details.
`client` object	Information about the client associated with this transaction. See the Client section for more details.
`transaction_id` string	The ID of the transaction, which links together all related authorization, reversal, and clearing messages.
`transmitted_by_scheme_on` string	The date and time a message is entered into the scheme network, in UTC format.
`transaction_locally_initiated_on` string	The local date and time indicating when the transaction was initiated.
`transaction_amount` uint64	The transaction’s amount, in minor currency units.
`transaction_currency` string	The transaction’s currency.
`billing_amount` uint64	The clearing's billing amount, in minor currency units. In case of a currency conversion, this will be based on Mastercard rates. For more information on how to calculate currency units, see Format the amount value.
`billing_conversion_rate` double	The scheme conversion rate used to convert the transaction amount to the billing amount.
`reconciliation_amount` uint64	Represents the amount converted to the reconciliation currency.
`reconciliation_currency` string	Represents the fee's reconciliation currency, as an ISO 4217 code.
`reconciliation_conversion_rate` double	The scheme conversion rate used to convert the transaction amount to the reconciliation amount.
`merchant` object	Information about the transaction’s merchant. See the Merchant section for more details.
`digital_card` object	Information about the digital card associated with this transaction. See the Digital Card section for more details.
`original_transaction_type` string	Type of the original transaction. This can be one of: `purchase` `withdrawal` `cashback` `cash_advance` `refund` `remittance_payment` `payment` `remittance_funding` `balance_inquiry` `pin_unblock` `pin_change` `unique_transaction` `payment_or_balance_transfer` `convenience_check` `fee_collection_credit_to_transaction_originator` `fee_collection_debit_to_transaction_originator`
`settled_on` string	Represents the date on which the scheme expects funds transfer to take place.
`transit_information` object	Information used to identify transit transactions. See the Transit information section for more details.
`pos` object	Indicates the conditions that exist at the point of sale at the time of the transaction. See the POS section for more details.

id

string

The transaction's unique Checkout.com identifier.

card

object

Information about the card associated with this transaction. See the Card section for more details.

cardholder

object

Information about the cardholder associated with this transaction. See the Cardholder section for more details.

entity

object

Information about the entity associated with this transaction. See the Entity section for more details.

client

object

Information about the client associated with this transaction. See the Client section for more details.

transaction_id

string

The ID of the transaction, which links together all related authorization, reversal, and clearing messages.

transmitted_by_scheme_on

string

The date and time a message is entered into the scheme network, in UTC format.

transaction_locally_initiated_on

string

The local date and time indicating when the transaction was initiated.

transaction_amount

uint64

The transaction’s amount, in minor currency units.

transaction_currency

string

The transaction’s currency.

billing_amount

uint64

The clearing's billing amount, in minor currency units. In case of a currency conversion, this will be based on Mastercard rates.

For more information on how to calculate currency units, see Format the amount value.

billing_conversion_rate

double

The scheme conversion rate used to convert the transaction amount to the billing amount.

reconciliation_amount

uint64

Represents the amount converted to the reconciliation currency.

reconciliation_currency

string

Represents the fee's reconciliation currency, as an ISO 4217 code.

reconciliation_conversion_rate

double

The scheme conversion rate used to convert the transaction amount to the reconciliation amount.

merchant

object

Information about the transaction’s merchant. See the Merchant section for more details.

digital_card

object

Information about the digital card associated with this transaction. See the Digital Card section for more details.

original_transaction_type

string

Type of the original transaction. This can be one of:

purchase
withdrawal
cashback
cash_advance
refund
remittance_payment
payment
remittance_funding
balance_inquiry
pin_unblock
pin_change
unique_transaction
payment_or_balance_transfer
convenience_check
fee_collection_credit_to_transaction_originator
fee_collection_debit_to_transaction_originator

settled_on

string

Represents the date on which the scheme expects funds transfer to take place.

transit_information

object

Information used to identify transit transactions. See the Transit information section for more details.

pos

object

Indicates the conditions that exist at the point of sale at the time of the transaction. See the POS section for more details.

Field name Description

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

id

string

The card's unique Checkout.com identifier

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
`id` string	The merchant's identifier. This may vary from one acquirer to another.
`name` string	The merchant’s name.
`city` string	The city where the merchant is located.
`state` string	(Optional, applicable only for USA) The state where the merchant is located.
`country` string	The country where the merchant is located, as an ISO-3 code.
`category_code` string	The merchant's category codes.
`street_address` string	The merchant’s street address.

Field name Description

Field name	Description
`id` string	The digital card’s unique Checkout.com identifier
`device_type` string	Type of device. This can be one of: `phone` `wearable` `pc` `vehicle` `tablet` `card` `other`
`wallet_type` string	Type of wallet. This can be one of: `googlepay` `applepay` `remote_commerce_programs` `other`

id

string

The digital card’s unique Checkout.com identifier

device_type

string

Type of device. This can be one of:

phone
wearable
pc
vehicle
tablet
card
other

wallet_type

string

Type of wallet. This can be one of:

googlepay
applepay
remote_commerce_programs
other

Field name Description

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

transaction_type

string

The authorization model used by the transit operator. This can be one of:

prefunded
real_time_authorized
post_authorized_aggregated
authorized_aggregated_split_clearing
other
post_authorized_aggregated_maestro
debt_recovery

transportation_method

string

The transport method used to travel. This can be one of:

urban_bus
interurban_bus
light_train_mass_transit
train
commuter_train
water_borne_vehicle
toll
parking
taxi
high_speed_train
rural_bus
express_commuter_train
para_transit
self_drive_vehicle
coach
locomotive
powered_motor_vehicle
trailer
regional_train
inter_city
funicular_train
cable_car
other

Field name Description

Field name	Description
`card_present` string	Indicates if the card was present to initiate the transaction. This can be one of: `present` `not_present` `unspecified`
`cardholder_present` string	Indicates if the cardholder was present to initiate the transaction. This can be one of: `present` `not_present` `unspecified`
`entry_mode` string	The method by which a card initiates a transaction at a terminal. This can be one of: `contact_chip` `contactless_chip` `contactless_magstripe` `ecommerce` `magstripe` `manual` `server` `other`

card_present

string

Indicates if the card was present to initiate the transaction. This can be one of:

present
not_present
unspecified

cardholder_present

string

Indicates if the cardholder was present to initiate the transaction. This can be one of:

present
not_present
unspecified

entry_mode

string

The method by which a card initiates a transaction at a terminal. This can be one of:

contact_chip
contactless_chip
contactless_magstripe
ecommerce
magstripe
manual
server
other

Presentment reversed

Example webhook

Webhook fields

Card

Cardholder

Entity

Client

Merchant

Digital card

Transit information

POS