MOmonato
Webhooks

Get notified when a transaction is refunded

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.

postWebhookrefund

Payload

id_msgstring uuid required

Unique message identifier (use for idempotency/deduplication)

msg_name'REFUND' required

Event name. For refund notifications it is always REFUND.

msg_datestring date required

Event date (YYYY-MM-DD)

Example payload

{
  "id_msg": "f0b1c6de-6a3c-4f2e-9d47-1c0a5b7e2d38",
  "msg_name": "REFUND",
  "msg_date": "2026-09-21",
  "body": {
    "id": "0f1e2d3c-4b5a-6978-8796-a5b4c3d2e1f0",
    "tracking_key": "20260921FINCHXXXXQ6RPX4",
    "beneficiary_account": "734180000000001004",
    "beneficiary_name": "Carolina Perez Marquez",
    "beneficiary_rfc": "XAXX010101000",
    "payer_account": "734185000000000055",
    "payer_name": "FINCO PAY",
    "payer_rfc": "XAXX010101000",
    "payer_institution": "90734",
    "amount": "150.00",
    "transaction_date": "2026-09-21 13:03:36",
    "category": "CREDIT_TRANS",
    "sub_category": "SPEI_REFUNDED_CREDIT",
    "payment_concept": "Refund due to incorrect amount",
    "numeric_reference": "1234567",
    "original_transaction_id": "1eb4b5ac-71f6-4203-aded-4fcb7fd21637",
    "original_transaction_tracking_id": "20260920FINCHZ43V14QILB",
    "original_transaction_amount": "150.00"
  }
}

Response

Refund notification received and accepted

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.