# Presentment received

This [Issuing](https://www.checkout.com/docs/card-issuing.md) event occurs when:
- Checkout.com receives a presentment from the acquirer that matches an existing authorization, pre-authorization, or incremental authorization.
- The merchant or acquirer forced the transaction through clearing with no previous authorization, which you can [create a dispute](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/manage-issuing-disputes.md) for if needed.

## Example webhook

```json
{
  "id": "evt_az5sblvku4ge3dwpztvyizgcau",
  "type": "presentment_received",
  "version": "2.0.0",
  "created_on": "2024-04-10T08:13:14Z",
  "data": {
    "id": "msg_abcd5fg6hievapshljklmnop4",
    "card": {
      "id": "crd_fa6psq242dcd6fdn5gifcq1491",
      "scheme" : "mastercard",
      "metadata": {
        "reference": "X-123456-N11",
        "udf1": "metadata1",
        "udf2": "metadata2",
        "udf3": "metadata3",
        "udf4": "metadata4",
        "udf5": "metadata5"
      }
    },
    "cardholder":{
      "id": "crh_urdihafyo75evcr55s62jmwwhy"
    },
    "entity":{
      "id": "ent_urdihafyo75evcr55s62jmwwhy"
    },
    "client":{
      "id": "cli_urdihafyo75evcr55s62jmwwhy"
    },
    "initiator": "acquirer",
    "transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",
    "transmission_date_time": "2024-04-10T08:12:14Z",
    "clearing_type": "debit",
    "transaction_amount": 900,
    "transaction_currency": "EUR",
    "billing_amount": 900,
    "billing_currency": "EUR",
    "billing_conversion_rate": 0.925643,
    "reconciliation_amount": 900,
    "reconciliation_currency": "EUR",
    "reconciliation_conversion_rate": 0.925643,
    "ecb_conversion_rate": 0.9,
    "digital_card_information": {
      "digital_card_id": "dcr_fa6psq242dcd6fdn5gifcq1491",
      "device_type": "phone",
      "wallet_type": "ApplePay"
    },
    "local_transaction_date_time": "2024-04-10T04:12:14",
    "original_transaction_type": "purchase",
    "is_forced_posted": false,
    "settlement_date": "2024-04-11",
    "transit_information": {
        "transaction_type": "authorized_aggregated_split_clearing",
        "transportation_mode": "urban_bus"
    },
    "pos": {
      "card_present": "present",
      "cardholder_present": "not_present",
      "entry_mode": "ecommerce"
    }
  }
}
```

---

## 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_`. |
| `transmission_date_time`<br>`datetime` | The date and time when the transaction message entered the scheme network, in UTC. <br>Standard – ISO 8601 code <br>Format – `yyyy-mm-ddThh:mm:ss.sss` |
| `local_transaction_date_time`<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` |
| `clearing_type`<br>`string` | The type of clearing. This can be one of:<br><br>- `credit`<br>- `debit` |
| `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_currency`<br>`string` | The currency in which the issuer will bill the cardholder. <br>Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/testing/codes/currency-codes.md) <br>Example – `USD` |
| `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. |
| `ecb_conversion_rate`<br>`double`<br>`optional` | The European Central Bank (ECB) comparative rate that will be communicated to the cardholder for a currency conversion when the `transaction_currency` and `billing_currency` are different. |
| `digital_card_information`<br>`object`<br>`optional` | The digital card's details. <br><br>See the [Digital card information](#Digital_card_information_object) object. |
| `local_transaction_time`<br>`string` | The local date and time when the transaction was initiated. <br>Standard – ISO 8601 code <br>Format – `yyyy-mm-ddThh:mm:ss.sss` |
| `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` |
| `is_forced_posted`<br>`boolean` | Indicates whether the merchant or acquirer forced the transaction through clearing with no previous authorization.<br><br>You can use this field to identify forced presentments.<br>If you want to contest the transaction, create a dispute within the specified time frame.<br>For more information, see [Manage Issuing disputes](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/manage-issuing-disputes.md). |
| `settlement_date`<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` |
| `metadata`<br>`object`<br>`optional` | Your user-defined metadata details. <br><br>See the request body of the [Create a card endpoint](https://api-reference.checkout.com/tag/Cards/#operation/createCard!path=0/reference&t=request). |

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

## Digital card information object

| Field name | Description |
| --- | --- |
| `digital_card_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>- `device_peripheral`<br>- `domestic_appliance`<br>- `fashion_accessory`<br>- `garment`<br>- `jewelry`<br>- `key_fob`<br>- `media_or_gaming_device`<br>- `mobile_phone_case_or_sleeve`<br>- `mobile_phone_network_operator_controlled_fixed_secure_element`<br>- `mobile_phone_network_operator_controlled_removable_secure_element`<br>- `mobile_phone_not_network_operator_controlled_fixed_secure_element`<br>- `mobile_phone_not_network_operator_controlled_removable_secure_element`<br>- `mobile_phone_payment_application_host_processor`<br>- `mobile_phone_payment_application_tee_host_processor`<br>- `mobile_tag`<br>- `pc`<br>- `phone`<br>- `removable_secure_element_not_network_operator_controlled`<br>- `sticker`<br>- `tablet_or_e_reader`<br>- `tablet_or_e_book_network_operator_controlled_fixed_secure_element`<br>- `tablet_or_e_book_not_network_operator_controlled_fixed_secure_element`<br>- `tablet_or_e_reader_network_operator_controlled_removable_secure_element`<br>- `tablet_or_e_reader_payment_application_host_processor`<br>- `tablet_or_e_reader_payment_application_tee_host_processor`<br>- `tag`<br>- `vehicle`<br>- `watch_payment_application_host_processor`<br>- `watch_payment_application_tee_host_processor`<br>- `watch_contactless_chip_or_not_network_operator_controlled_secure_element`<br>- `watch_or_wristband`<br>- `wristband` |
| `wallet_type`<br>`string`<br>`optional` | The type of wallet. This can be one of:<br>- `apple_pay`<br>- `google_pay`<br>- `samsung_pay`<br>- `merchant_tokenization_program` |

## Transit information object

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