# Presentment reversed

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

## Example webhook

```json
{
  "id": "evt_cz5sblvku4ge3dwpztvyizgczq",
  "type": "presentment_reversed",
  "version": "2.0.0",
  "created_on": "2023-12-10T08:13:14Z",
  "data": {
    "id": "msg_ab5cde131fghj8qw5ertyu2372",
    "card": {
      "id": "crd_fa6psq242dcd6fdn5gifcq1491",
      "scheme" : "mastercard"
    },
    "entity": {
      "id": "ent_fa6psq242dcd6fdn5gifcq1491"
    },
    "client": {
      "id": "cli_fa6psq242dcd6fdn5gifcq1491"
    },
    "cardholder": {
      "id": "crh_fa6psq242dcd6fdn5gifcq1491"
    },
    "initiator": "acquirer",
    "transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",
    "transmitted_by_scheme_on": "2018-04-10T08:12:14Z",
    "transaction_locally_initiated_on": "2018-04-10T04:12:14",
    "transaction_amount": 1000,
    "transaction_currency": "GBP",
    "billing_amount": 1200,
    "billing_currency": "EUR",
    "billing_conversion_rate": 0.92,
    "reconciliation_amount": 1200,
    "reconciliation_currency": "EUR",
    "reconciliation_conversion_rate": 0.92,
    "digital_card": {
      "id": "dcr_fa6psq242dcd6fdn5gifcq1491",
      "device_type": "phone",
      "wallet_type": "applepay"
    },
    "original_transaction_type": "purchase",
    "settled_on": "2018-04-11",
    "transit_information": {
      "transaction_type": "authorized_aggregated_split_clearing",
      "transportation_mode": "urban_bus"
    },
    "merchant": {
      "id": "59889",
      "name": "Hannah Bret",
      "city": "Paris",
      "state": "",
      "country": "FRA",
      "category_code": "5021",
      "street_address": "261, Example street"
    },
    "pos": {
      "country_code": "GBR",
      "postal_code": "SE100ER",
      "card_present": "present",
      "cardholder_present": "not_present",
      "entry_mode": "contactless_chip"
    }
  }
}
```
---

## Webhook fields

| 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.<br>See the [Cardholder](#Cardholder_object) object. |
| `entity`<br>`object` | The entity's details. See the [Entity](#Entity_object) object. |
| `client`<br>`object` | Your details as a Checkout.com client. See the [Client](#Client_object) object. |
| `initiator`<br>`string`<br>`optional` | The party who initiated the message. <br><br>This value is always `acquirer`. |
| `transaction_id`<br>`string` | The transaction's unique identifier, which links together all related authorization, reversal, and clearing messages. This is prefixed with `trx_`. |
| `transmitted_by_scheme_on`<br>`datetime` | The date and time when the message entered the scheme network, in UTC. <br>Standard – ISO 8601 code <br>Format – `yyyy-mm-ddThh:mm:ss.sss` |
| `transaction_locally_initiated_on`<br>`string`<br>`optional` | The local date and time when the transaction was initiated. <br>Standard – ISO 8601 code <br>Format – `yyyy-mm-ddThh:mm:ss.sss` |
| `transaction_amount`<br>`uint64` | The transaction amount, in the [minor currency unit](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). |
| `transaction_currency`<br>`string` | The transaction currency. <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 amount you bill the cardholder for, in the [minor currency unit](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md).<br><br>If currency conversion is required, this is based on [Mastercard rates](https://www.mastercard.com/global/en/personal/get-support/convert-currency.html). |
| `billing_conversion_rate`<br>`double` | The scheme conversion rate used to convert the transaction amount to the billing amount. |
| `reconciliation_amount`<br>`uint64` | The amount you settled with the card scheme for the transaction, in the [major currency unit](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). <br><br>Format – Fixed-point notation with up to eight decimal places <br><br>Example – 500 USD is represented as `500.00` |
| `reconciliation_currency`<br>`string` | The fee's reconciliation currency. <br>Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md) <br>Example – `USD` |
| `reconciliation_conversion_rate`<br>`double` | The scheme conversion rate used to convert the transaction amount to the reconciliation amount. |
| `merchant`<br>`object` | The merchant's details. See the [Merchant](#Merchant_object) object. |
| `digital_card`<br>`object`<br>`optional` | The digital card's details. <br><br>See the [Digital card information](#Digital_card_information_object) object. |
| `original_transaction_type`<br>`string` | The type of the original transaction. This can be one of:<br><br>- `balance_inquiry`<br>- `cashback`<br>- `cash_advance`<br>- `convenience_check`<br>- `fee_collection_credit_to_transaction_originator`<br>- `fee_collection_debit_to_transaction_originator`<br>- `payment`<br>- `payment_or_balance_transfer`<br>- `pin_change`<br>- `pin_unblock`<br>- `purchase`<br>- `refund`<br>- `remittance_funding`<br>- `remittance_payment`<br>- `unique_transaction`<br>- `withdrawal` |
| `settled_on`<br>`string` | The date when the scheme expects the funds transfer to take place. <br>Format – `yyyy-mm-dd` |
| `transit_information`<br>`object`<br>`optional` | The transit transaction details. <br><br>See the [Transit information](#Transit_information_object) object. |
| `pos`<br>`object` | 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` |

### 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_`. |

### Merchant object

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The merchant's unique identifier.<br><br>This may vary from one acquirer to another.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/codes/merchant-category-codes.md) for the transaction.<br><br>Merchants can have multiple MCCs |
| `street_address`<br>`string` | The merchant’s street address. |

### Digital card object

| Field name | Description |
| --- | --- |
| `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><br>- `card`<br>- `other`<br>- `pc`<br>- `phone`<br>- `tablet`<br>- `vehicle`<br>- `wearable` |
| `wallet_type`<br>`string` | The type of wallet. This can be one of:<br><br>- `applepay`<br>- `googlepay`<br>- `other`<br>- `remote_commerce_programs` |

### Transit information object

| Field name | Description |
| --- | --- |
| `transaction_type`<br>`string` | The authorization model used by the transit operator. This can be one of:<br>- `prefunded`<br>- `real_time_authorized`<br>- `post_authorized_aggregated`<br>- `authorized_aggregated_split_clearing`<br>- `other`<br>- `post_authorized_aggregated_maestro`<br>- `debt_recovery` |
| `transportation_method`<br>`string` | The transport method used to travel. This can be one of:<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` |

### PoS object

| Field name | Description |
| --- | --- |
| `card_present`<br>`string` | Indicates if the card was present to initiate the transaction. This can be one of:<br><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 way the card initiated the transaction at the 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>- `server`<br>- `other` |