---
title: "Get notified when a transaction is refunded"
method: POST
path: "refund"
tags: ["Webhooks"]
---

# Get notified when a transaction is refunded

`POST refund` (webhook)

Monato sends this webhook when a refund transaction is created. This happens when you call the refund endpoint for a Money In, and also when an outbound SPEI transfer is reversed by the banking network without any action from you. The `body` describes the refund transaction and links back to the original one through the `original_transaction_*` fields.

## Payload

- WebhookRefundEvent: Webhook event sent when a refund transaction is created.
  - `id_msg` string, uuid, required: Unique message identifier (use for idempotency/deduplication)
  - `msg_name` 'REFUND', required: Event name. For refund notifications it is always REFUND.
  - `msg_date` string, date, required: Event date (YYYY-MM-DD)
  - `body` object, required: Refund transaction payload.
    - `id` string, uuid: Transaction ID of the refund itself, not of the original transaction.
    - `tracking_key` string: Tracking key of the refund transaction.
    - `beneficiary_account` string: CLABE receiving the refunded funds.
    - `beneficiary_name` string
    - `beneficiary_rfc` string, nullable
    - `payer_account` string: CLABE the refund is sent from.
    - `payer_name` string
    - `payer_rfc` string, nullable
    - `payer_institution` string: Institution code of the payer.
    - `amount` string: Refunded amount. Partial refunds are not supported, so this equals the original amount.
    - `transaction_date` string: Creation timestamp of the refund transaction.
    - `category` string
    - `sub_category` string
    - `payment_concept` string: Description of the refund.
    - `numeric_reference` string, nullable: Numeric reference of the refund transaction.
    - `original_transaction_id` string, uuid: Transaction ID of the original transaction being refunded.
    - `original_transaction_tracking_id` string: Tracking key of the original transaction being refunded.
    - `original_transaction_amount` string: Amount of the original transaction.

## Acknowledgement `200`

Refund notification received and accepted

## Other responses

- `202`: Refund notification received; additional processing will be done asynchronously
- `422`: Refund notification received, but not accepted

---

[API](https://skmtc.dev/monato/apis/fincore-api.md) - [All operations](https://skmtc.dev/monato/apis/fincore-api/llms.txt) - [OpenAPI document](https://skmtc.dev/monato/apis/fincore-api/revisions/e22ef66945df?raw)