{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/fincore/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Money In confirmation","siteUrl":"https://docs.monato.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"money-in-confirmation","__idx":0},"children":["Money In confirmation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This guide explains how to receive notifications every time you get a Money In transaction into your Monato accounts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Money In notifications are sent as webhooks with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["msg_name = \"MONEY_IN\""]}," and a common payload format for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["External credits (SPEI)"]}," coming from other banks."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Internal credits"]}," generated by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/transactions/internal_transaction"]}," (book-to-book transfers between Monato accounts)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can distinguish between these cases using fields such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sub_category"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_institution"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"register-for-money-in-notifications","__idx":1},"children":["Register for Money In notifications"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In order to receive ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONEY_IN"]}," notifications, you must register the endpoint where you expect the webhook."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/clients/{client_id}/webhooks"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Path parameters"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["client_id"]}," – your Monato client identifier."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query Parameters"]},": none",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Headers"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <token>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/json"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"client_id\": \"{{clientId}}\",\n  \"url\": \"https://example.com/money-in-webhook\",\n  \"token\": \"secretToken0123\",\n  \"webhook_type\": \"MONEY_IN\",\n  \"auth_type\": \"AUTH\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status Code"]},": 200 OK",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response Body"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"0c2d358f-0626-4c4e-b40b-9ab7c9dffe71\",\n  \"clientId\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n  \"url\": \"https://example.com/money-in-webhook\",\n  \"token\": \"secretToken0123\",\n  \"webhookType\": \"MONEY_IN\",\n  \"webhookStatus\": \"ACTIVE\",\n  \"createdAt\": \"2025-05-19 15:52:51.593012-06:00\",\n  \"updatedAt\": \"2025-05-19 15:52:51.593012-06:00\",\n  \"deletedAt\": null,\n  \"blockedAt\": null,\n  \"deletedBy\": null,\n  \"blockedBy\": null\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The request body uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["snake_case"]}," (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_type"]},") while the response uses ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["camelCase"]}," (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookType"]},"). This is expected and consistent across the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"managing-client-webhooks-list-update-delete","__idx":2},"children":["Managing client webhooks (list, update, delete)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can manage your webhooks via the client-scoped API:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Method"},"children":["Method"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Path"},"children":["Path"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/clients/{client_id}/webhooks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List client webhooks"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["POST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/clients/{client_id}/webhooks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a client webhook"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["GET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/clients/{client_id}/webhooks/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Get a client webhook by ID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DELETE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/clients/{client_id}/webhooks/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Delete a client webhook"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PATCH"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/clients/{client_id}/webhooks/{id}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Update a client webhook"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Typical fields in the response include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["clientId"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["url"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["token"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookType"]}," (for example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONEY_IN"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CEP"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STATUS_UPDATE"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authType"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AUTH"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhookStatus"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACTIVE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INACTIVE"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Audit fields such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["createdAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["updatedAt"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deletedAt"]},", etc."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A more detailed guide on payloads and error codes for webhook management will be added soon. For now, use this section together with the examples above and the OpenAPI reference."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhook-notification","__idx":3},"children":["Webhook notification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you register your endpoint for our webhook, you will get a POST request every time a Money In arrives."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Common envelope"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We always send a JSON object with the following envelope:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id_msg\": \"a7a126e8-fa74-411c-ad2b-b000f277bb0d\",\n  \"msg_name\": \"MONEY_IN\",\n  \"msg_date\": \"2025-04-02\",\n  \"body\": {\n    \"...\": \"...\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id_msg"]},": unique identifier of the message."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["msg_name"]},": for Money In notifications it is always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"MONEY_IN\""]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["msg_date"]},": message date (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD"]},")."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body"]},": contains the Money In details."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example – External Money In (SPEI)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id_msg\": \"a7a126e8-fa74-411c-ad2b-b000f277bb0d\",\n  \"msg_name\": \"MONEY_IN\",\n  \"msg_date\": \"2025-04-02\",\n  \"body\": {\n    \"id\": \"0196da9a-8947-703e-9a3b-bf8c7d9f6059\",\n    \"beneficiary_account\": \"734180123045603216\",\n    \"beneficiary_name\": \"John Smith\",\n    \"beneficiary_rfc\": \"XYZ123456789\",\n    \"payer_account\": \"137180210044008609\",\n    \"payer_name\": \"Juan Perez\",\n    \"payer_rfc\": \"XYZ987654321\",\n    \"payer_institution\": \"40002\",\n    \"amount\": \"123.00\",\n    \"transaction_date\": \"2025-04-02 10:14:05\",\n    \"tracking_key\": \"50118609TBRNZ00I07219647\",\n    \"payment_concept\": \"Payment for invoice 4567\",\n    \"numeric_reference\": \"2504021\",\n    \"sub_category\": \"SPEI_CREDIT\",\n    \"registered_at\": \"2025-04-02T10:14:05.915184-06:00\",\n    \"owner_id\": \"24f1e5d5-4045-4b1a-a0c4-5e6c6b1d44ef\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example – Internal Money In (book-to-book)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the type of Money In you will receive when funds are moved via"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/transactions/internal_transaction"]}," towards one of your Monato instruments."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id_msg\": \"6daea2d2-ccb0-48f3-917c-f387dc8e99b0\",\n  \"msg_name\": \"MONEY_IN\",\n  \"msg_date\": \"2025-11-20\",\n  \"body\": {\n    \"id\": \"a0037594-5064-4dda-896b-f9b5dd4988dd\",\n    \"beneficiary_account\": \"734185000000001177\",\n    \"beneficiary_name\": \"MERCHANT TEST\",\n    \"beneficiary_rfc\": \"FTR230125Q00\",\n    \"payer_account\": \"734185000000000822\",\n    \"payer_name\": \"Customer Test-1 Legal\",\n    \"payer_rfc\": \"ND\",\n    \"payer_institution\": \"90734\",\n    \"amount\": \"1.00\",\n    \"transaction_date\": \"2025-11-20 15:05:59\",\n    \"tracking_key\": \"20251120FINCHESDHI7FVTU\",\n    \"payment_concept\": \"CUST - SPEI\",\n    \"numeric_reference\": \"1100003\",\n    \"sub_category\": \"INT_CREDIT\",\n    \"registered_at\": \"2025-11-20T15:05:59.915184-06:00\",\n    \"owner_id\": \"24f1e5d5-4045-4b1a-a0c4-5e6c6b1d44ef\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Another example between customers of the same merchant:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id_msg\": \"2293f8fd-2fc5-4f4c-8985-e97466341b61\",\n  \"msg_name\": \"MONEY_IN\",\n  \"msg_date\": \"2025-11-20\",\n  \"body\": {\n    \"id\": \"ba964d20-c9dc-4bf1-8ffb-f0f9d5238485\",\n    \"beneficiary_account\": \"734185000000000819\",\n    \"beneficiary_name\": \"Customer Test-2 Legal\",\n    \"beneficiary_rfc\": \"ND\",\n    \"payer_account\": \"734185000000000822\",\n    \"payer_name\": \"Customer Test-1 Legal\",\n    \"payer_rfc\": \"ND\",\n    \"payer_institution\": \"90734\",\n    \"amount\": \"1.00\",\n    \"transaction_date\": \"2025-11-20 14:59:56\",\n    \"tracking_key\": \"20251120FINCHUSE4PV5VNY\",\n    \"payment_concept\": \"CUST - CUST\",\n    \"numeric_reference\": \"1100001\",\n    \"sub_category\": \"INT_CREDIT\",\n    \"registered_at\": \"2025-11-20T14:59:56.705283-06:00\",\n    \"owner_id\": \"fd140e3c-29d8-4e39-bdd8-6e82c94ecad3\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Money In body fields"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Main fields you will see in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["body"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," – Internal transaction identifier in Monato."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiary_account"]}," – Beneficiary CLABE (or Monato CLABE for internal credits)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiary_name"]}," – Beneficiary account holder name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["beneficiary_rfc"]}," – Beneficiary RFC."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_account"]}," – Payer account number (CLABE or internal account)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_name"]}," – Payer name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_rfc"]}," – Payer RFC, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"ND\""]}," when not provided."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_institution"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For SPEI credits: Banxico institution code of the originating bank (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["40002"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For internal credits: Monato internal institution code (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["90734"]},")."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," – Amount credited, as a string with 2 decimal places (e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"123.00\""]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction_date"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Date and time when the transaction was registered in the rail."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Format: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["YYYY-MM-DD HH:MM:SS"]},"."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracking_key"]}," – SPEI tracking key or internal tracking id."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_concept"]}," – Payment description / concept."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["numeric_reference"]}," – Numeric reference used by the payer."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sub_category"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Internal classification of the credit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Typical values:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SPEI_CREDIT"]}," – external SPEI credit."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["INT_CREDIT"]}," – internal credit from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internal_transaction"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["registered_at"]}," – Timestamp in Monato when the transaction was created / persisted (ISO-8601 with timezone)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["owner_id"]}," – Identifier of the owner of the destination instrument (e.g. the customer that owns the receiving account)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sub_category"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payer_institution"]}," together to identify if a Money In comes from an external SPEI transfer or from an internal transaction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"accepting-or-rejecting-a-money-in","__idx":4},"children":["Accepting or rejecting a Money In"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are two behaviors depending on the type of Money In:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-external-money-in-spei","__idx":5},"children":["1. External Money In (SPEI)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For SPEI Money In, you can accept or reject the transaction directly from the webhook response:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accept a Money In"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Respond to the Money In webhook with HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201 Created"]},"."," ","We will consider that you accepted the Money In."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Reject a Money In"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Respond to the Money In webhook with HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["422 Unprocessable Entity"]}," and the Money In will be automatically refunded."," ","Additionally, you can send a JSON body with the reason:"]}]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"refundReason\": \"Invalid Amount\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-internal-money-in","__idx":6},"children":["2. Internal Money In"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For internal credits (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sub_category = \"INT_CREDIT\""]},"), the funds have already been moved book-to-book by the time you receive the webhook. In this case:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Money In webhook is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["informational only"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["HTTP status codes on your response ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["do not"]}," trigger an automatic refund."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you need to reverse an internal movement, you must create a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internal_transaction"]}," in the opposite direction (see ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Internal Transactions API"]},")."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"refund-a-money-in-spei-only","__idx":7},"children":["Refund a Money In (SPEI only)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Sometimes you accept a Money In but later you need to refund it. For external SPEI credits, you can do this with the refund endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/clients/{{clientId}}/transactions/{{transactionId}}/refund"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Path parameters"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["clientId"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["c2d1d1e3-3340-4170-980e-e9269bbbc551"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transactionId"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e43171ad-af3b-40e3-913c-24cc386bf5ff"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is sent in the Money In webhook or can be retrieved via the Transactions API."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query Parameters"]},": none",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request Body"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"description\": \"Lorem ipsum\",\n    \"amount\": \"9.99\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status Code"]},": 200 OK",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response Body"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"id\": \"e43171ad-af3b-40e3-913c-24cc386bf5ff\",\n    \"bankId\": \"1953a92c-11e5-4315-b406-b89dd6b699b4\",\n    \"clientId\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n    \"externalReference\": \"2505201\",\n    \"trackingId\": \"20250520FINCHARNJK5NHQG\",\n    \"description\": \"Lorem ipsum\",\n    \"amount\": \"9.99\",\n    \"currency\": \"MXN\",\n    \"category\": \"DEBIT_TRANS\",\n    \"subCategory\": \"SPEI_DEBIT\",\n    \"transactionStatus\": \"LIQUIDATED\",\n    \"audit\": {\n        \"createdAt\": \"2025-05-20 10:57:44.220281-06:00\",\n        \"updatedAt\": \"2025-05-20 10:57:44.220281-06:00\",\n        \"deletedAt\": \"None\",\n        \"blockedAt\": \"None\"\n    },\n    \"originalTransactionId\": \"a1392ef1-75f2-457a-8203-d4fd4b435559\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint applies to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["external SPEI transactions"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To “reverse” an internal transaction, you must create a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["internal_transaction"]}," in the opposite direction."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take note that the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/refund"]}," endpoint return a transaction data, this is because we need to create a new SPEI transaction to return the money to the original sourcing account."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this case, you will have two transactions:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The original, with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionStatus = \"REFUNDED\""]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The refund transaction, with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionStatus = \"LIQUIDATED\""]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retrieve-a-transaction","__idx":8},"children":["Retrieve a transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can retrieve the details of a transaction with a call to:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/clients/{{clientId}}/transactions/{{transactionId}}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Request"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Path parameters"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["clientId"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["c2d1d1e3-3340-4170-980e-e9269bbbc551"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transactionId"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["e43171ad-af3b-40e3-913c-24cc386bf5ff"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"em","attributes":{},"children":["This is sent in the Money In webhook or known from your own records."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you don’t send query parameters, the transaction is retrieved by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionId"]}," only."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query parameters"]}," (optional):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transaction_status"]}," – Filter by transaction status.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LIQUIDATED"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["tracking_id"]}," – Filter by the SPEI tracking key associated with the transaction.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["20250520FINCHARNJK5NHQG"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["transaction_category"]}," – Filter by transaction category.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DEBIT_TRANS"]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["bank_id"]}," – Filter by bank identifier.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Example: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1953a92c-11e5-4315-b406-b89dd6b699b4"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example using tracking_id"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET /v1/clients/c2d1d1e3-3340-4170-980e-e9269bbbc551/transactions/e43171ad-af3b-40e3-913c-24cc386bf5ff?tracking_id=20250520FINCHARNJK5NHQG\n\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status Code"]},": 200 OK",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response Body"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"e43171ad-af3b-40e3-913c-24cc386bf5ff\",\n  \"bankId\": \"1953a92c-11e5-4315-b406-b89dd6b699b4\",\n  \"clientId\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n  \"externalReference\": \"2505201\",\n  \"trackingId\": \"20250520FINCHARNJK5NHQG\",\n  \"description\": \"Lorem ipsum\",\n  \"amount\": \"9.99\",\n  \"currency\": \"MXN\",\n  \"category\": \"DEBIT_TRANS\",\n  \"subCategory\": \"SPEI_DEBIT\",\n  \"transactionStatus\": \"LIQUIDATED\",\n  \"audit\": {\n    \"createdAt\": \"2025-05-20 10:57:44.220281-06:00\",\n    \"updatedAt\": \"2025-05-20 10:57:44.220281-06:00\",\n    \"deletedAt\": \"None\",\n    \"blockedAt\": \"None\"\n  },\n  \"jsonReference\": \"{'transaction_date': '2025-05-20 10:14:05', ...}\",\n  \"sourceInstrument\": { ... },\n  \"destinationInstrument\": { ... }\n}\n\n"},"children":[]}]},"headings":[{"value":"Money In confirmation","id":"money-in-confirmation","depth":1},{"value":"Register for Money In notifications","id":"register-for-money-in-notifications","depth":2},{"value":"Managing client webhooks (list, update, delete)","id":"managing-client-webhooks-list-update-delete","depth":3},{"value":"Webhook notification","id":"webhook-notification","depth":2},{"value":"Accepting or rejecting a Money In","id":"accepting-or-rejecting-a-money-in","depth":2},{"value":"1. External Money In (SPEI)","id":"1-external-money-in-spei","depth":3},{"value":"2. Internal Money In","id":"2-internal-money-in","depth":3},{"value":"Refund a Money In (SPEI only)","id":"refund-a-money-in-spei-only","depth":2},{"value":"Retrieve a transaction","id":"retrieve-a-transaction","depth":2}],"frontmatter":{"seo":{"title":"Money In confirmation"}},"lastModified":"2025-12-04T01:24:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/fincore/guides/money-in-validation","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}