# Reversal declined

This [Issuing](https://www.checkout.com/docs/card-issuing.md) event occurs when a reversal is declined because no match was found with a previous authorization approval, or because the transaction is already voided.

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

## Example webhook

```json
{
  "id": "evt_az5sblvku4ge3dwpztvyizgcau",
  "type": "reversal_declined",
  "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"              
    },
    "decline_reason": "original_transaction_not_found"
  }
}
```

> **Note**
>
> If you receive a `decline_reason` field in your response, refer to the [Issuing decline codes](https://www.checkout.com/docs/developer-resources/testing/codes/issuing-decline-codes.md) documentation for more information.

---

## Webhook fields

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The transaction's unique Checkout.com identifier. |
| `card`<br>`object` | Information about the card used for this transaction. <br><br>See the [Card](#Card_object) object for more details. |
| `cardholder`<br>`object` | Information about the cardholder associated with this transaction. See the [Cardholder](#Cardholder) section for more details. |
| `entity`<br>`object` | Information about the entity associated with this transaction. See the [Entity](#Entity) section for more details. |
| `client`<br>`object` | Information about the client associated with this transaction. See the [Client](#Client) section for more details. |
| `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 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 in the transaction’s source location, as an [ISO 4217 code](https://www.checkout.com/docs/developer-resources/codes/currency-codes.md). |
| `reversal_billing_amount`<br>`uint64` | The reversal's billing amount, in minor currency units. In case of a currency conversion, this will be based on [Mastercard rates](https://www.mastercard.com/global/en/personal/get-support/convert-currency.html).<br><br>For more information on how to calculate currency units, see [Format the amount value](https://www.checkout.com/docs/payments/accept-payments/format-the-amount-value.md). |
| `reversal_billing_currency`<br>`string` | The currency in which the issuer will bill the cardholder, as an [ISO 4217 code](https://www.checkout.com/docs/developer-resources/codes/currency-codes.md). |
| `digital_card_information`<br>`object`<br>`optional` | The digital card's details. <br><br>See the [Digital card information](#Digital_card_information_object) object. |
| `decline_reason` | The reason why the reversal was declined. This can be one of:<br><br>- `account_currency_mismatched`<br>- `amount_invalid`<br>- `authorization_relay_unreachable`<br>- `authorization_relay_verification_failed`<br>- `balance_verification_failed`<br>- `billing_amount_threshold_exceeded`<br>- `card_authentication_failed`<br>- `card_control_failed`<br>- `card_data_verification_failed`<br>- `card_expired`<br>- `card_inactive`<br>- `card_number_invalid`<br>- `card_number_not_found`<br>- `card_revoked`<br>- `card_suspended`<br>- `contactless_pin_change_not_allowed`<br>- `cvc2_invalid`<br>- `digital_card_deleted`<br>- `digital_card_expired`<br>- `digital_card_inactive`<br>- `digital_card_number_not_found`<br>- `digital_card_transaction_analysis_declined`<br>- `expiry_date_invalid`<br>- `insufficient_funds`<br>- `low_value_payment_amount_failed`<br>- `low_value_payment_count_failed`<br>- `merchant_category_not_allowed`<br>- `new_pin_data_not_received`<br>- `original_merchant_initiated_transaction_not_found`<br>- `original_recurring_transaction_not_found`<br>- `original_transaction_not_found`<br>- `partial_reversal_amount_invalid`<br>- `pin_change_failed`<br>- `pin_invalid`<br>- `reversal_currency_mismatched`<br>- `reversal_exceeds_authorized_amount`<br>- `scheme_fraud_score_missing`<br>- `scheme_fraud_score_threshold_exceeded`<br>- `scheme_merchant_data_validation_failed`<br>- `state_or_country_invalid`<br>- `system_malfunction`<br>- `three_d_secure_soft_declined`<br>- `transaction_invalid`<br>- `transaction_not_permitted_to_cardholder`<br>- `user_authentication_amount_mismatched`<br>- `user_authentication_currency_mismatched`<br>- `user_authentication_verification_failed`<br>- `user_authentication_verification_unavailable`<br>- `velocity_reached`<br>- `wallet_type_unsupported` |

## 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 identifier, prefixed with `crh_`. |

### Entity

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The entity's unique identifier, prefixed with `ent_`. |

### Client

| Field name | Description |
| --- | --- |
| `id`<br>`string` | The client's unique identifier, prefixed with `cli_`. |

### 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>- `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>- `merchant_tokenization_program`<br>- `samsung_pay` |