---
title: "MONEY_IN webhook event."
method: POST
path: "money-in"
---

# MONEY_IN webhook event.

`POST money-in` (webhook)

Monato sends this webhook to notify you about new Money In events into your accounts. The payload covers both external SPEI credits and internal credits (book-to-book). Use fields such as `sub_category` and `payer_institution` to distinguish between them.

Internal credits note: `INT_CREDIT` webhooks are emitted only when the credit is inbound for a different owner than the initiator (e.g., different `owner_id`, even under the same `client_id`). Self-transfers under the same `client_id` + `owner_id` do not generate a `MONEY_IN` webhook event.

## Payload

- WebhookMoneyInEvent
  - `id_msg` string, uuid, required — Unique message identifier (use for idempotency/deduplication).
  - `msg_name` string, required — Event name. For Money In notifications it is always "MONEY_IN".
  - `msg_date` string, date, required — Event date (YYYY-MM-DD).
  - `body` object, required
    - `id` string, uuid
    - `beneficiary_account` string
    - `beneficiary_name` string
    - `beneficiary_rfc` string
    - `payer_account` string
    - `payer_name` string
    - `payer_rfc` string
    - `payer_institution` string — SPEI: Banxico institution code of the originating bank (e.g. 40002). Internal: Monato internal institution code (e.g. 90734).
    - `amount` string — Amount credited, with two decimal places.
    - `transaction_date` string — Date and time when the transaction was registered in the rail. Format: YYYY-MM-DD HH:MM:SS.
    - `tracking_key` string
    - `payment_concept` string
    - `numeric_reference` string
    - `sub_category` string — Internal classification of the credit. Possible values: - SPEI_CREDIT – external SPEI credit from a non-Finco Pay institution. - INT_CREDIT – internal credit (book-to-book). Can originate from `POST /v1/transactions/internal_transaction` or from `POST /v1/transactions/money_out` when the destination instrument belongs to a Finco Pay account.
    - `registered_at` string, date-time — Timestamp in Monato when the transaction was created / persisted (ISO-8601 with timezone).
    - `owner_id` string, uuid — Identifier of the owner of the destination instrument (e.g. the customer that owns the receiving account).

## Acknowledgement `200`

Money In notification received successfully. Treated as a technical acknowledgement (equivalent to 201).

## Other responses

- `201` — Money In notification received and accepted. Recommended status code when you accept the Money In (SPEI credits).
- `202` — Money In notification received successfully; extra validations will be done asynchronously on your side.
- `422` — Money In notification received, but not accepted. For external SPEI credits, Monato will automatically refund the transaction to the original source. Not applicable to internal Money In (`INT_CREDIT`).

---

[API](https://skmtc.net/monato/apis/fincore-api.md) · [All operations](https://skmtc.net/monato/apis/fincore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/monato/fincore-api/versions/a8263ed74545/schema)