# Reversal approved

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

## Example webhook

```json
{
  "id": "evt_az5sblvku4ge3dwpztvyizgcau",
  "type": "reversal_approved",
  "version": "2.0.0",
  "created_on": "2018-04-10T08:13:14Z",
  "data": {
    "id": "msg_abcd5fg6hievapshljklmnop4",
    "card": {
      "id": "crd_fa6psq242dcd6fdn5gifcq1491",
      "scheme" : "mastercard"
    },
    "cardholder":{
      "id": "crh_urdihafyo75evcr55s62jmwwhy"
    },
    "entity":{
      "id": "ent_urdihafyo75evcr55s62jmwwhy"
    },
    "client":{
      "id": "cli_urdihafyo75evcr55s62jmwwhy"
    },
    "initiator": "acquirer",
    "decision_source": "issuer",
    "transaction_id": "trx_y3oqhf46pyzuxjbcn2giaqnb44",
    "transaction_type": "purchase",
    "reversal_type": "full",
    "transmission_date_time": "2018-04-10T08:12:14Z",
    "local_transaction_date_time": "2018-04-10T08:12:14",
    "reversal_amount": 1000,
    "reversal_currency": "GBP",
    "reversal_billing_amount": 900,
    "reversal_billing_currency": "EUR",
    "digital_card_information": {             
      "digital_card_id": "dcr_fa6psq242dcd6fdn5gifcq1491",
      "device_type": "phone",                 
      "wallet_type": "apple_pay"              
    }
  }
}
```

---

## 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`. |
| `decision_source`<br>`string`<br>`optional` | The party that made the decision to approve or decline the authorization. <br><br>This can be one of:<br><br>- `issuer` – You have authorization relay [stand-in mode](https://www.checkout.com/docs/card-issuing/manage-issuing-transactions/relay-authorization-requests.md) enabled and Checkout.com made the decision on your behalf while your server was temporarily unavailable.<br>- `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`<br>`string` | The transaction's unique identifier, which links together all related authorization, reversal, and clearing messages. This is prefixed with `trx_`. |
| `transaction_type`<br>`string` | The type of transaction. This can be one of:<br>- `balance_inquiry`<br>- `bill_payment`<br>- `cashback`<br>- `pin_change`<br>- `pin_unblock`<br>- `purchase`<br>- `purchase_account_inquiry`<br>- `refund`<br>- `remittance_funding`<br>- `withdrawal` |
| `reversal_type`<br>`string` | The type of the reversal received. This can be one of:<br><br>- `full`<br>- `partial` |
| `transmission_date_time`<br>`string` | 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 indicating when the transaction was initiated. <br>Standard – ISO 8601 code <br>Format – `yyyy-mm-ddThh:mm:ss.sss` |
| `reversal_amount`<br>`uint64` | The reversal transaction amount, in the [minor currency unit](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). |
| `reversal_currency`<br>`string` | The acquirer’s local currency, or the local currency of the transaction’s source location. <br>Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/codes/currency-codes.md) <br>Example – `USD` |
| `reversal_billing_amount`<br>`uint64` | The reversal's billing amount, in the minor currency unit.<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). |
| `reversal_billing_currency`<br>`string` | The currency in which you will bill the cardholder. <br>Standard – [ISO 4217 code](https://www.checkout.com/docs/developer-resources/codes/currency-codes.md) <br>Example – `USD` |
| `digital_card_information`<br>`object`<br>`optional` | The digital card's details. <br><br>See the [Digital card information](#Digital_card_information_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

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The cardholder's unique Checkout.com identifier. |

### Entity

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The entity's unique Checkout.com identifier. |

### Client

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The client's unique Checkout.com identifier. |

### Digital card information

| 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_book_network_operator_controlled_fixed_secure_element`<br>- `tablet_or_e_book_not_network_operator_controlled_fixed_secure_element`<br>- `tablet_or_e_reader`<br>- `tablet_or_e_reader_payment_application_host_processor`<br>- `tablet_or_e_reader_payment_application_tee_host_processor`<br>- `tablet_or_e_reader_network_operator_controlled_removable_secure_element`<br>- `tag`<br>- `vehicle`<br>- `watch_contactless_chip_or_not_network_operator_controlled_secure_element`<br>- `watch_or_wristband`<br>- `watch_payment_application_host_processor`<br>- `watch_payment_application_tee_host_processor`<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` |