{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/fincore/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Money Out to Debit Card","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-out-to-debit-card","__idx":0},"children":["Money Out to Debit Card"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Debit cards have a CLABE associated with them, but sometimes you will only have the debit card number (16 digits) and not the associated CLABE. You can send a SPEI transaction directly to a debit card. To do this, you must first register an Instrument with the card's details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-an-instrument","__idx":1},"children":["Create an Instrument"]},{"$$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":["POST /v1/clients/{{clientId}}/instruments"]}]},{"$$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":"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  \"source_bank_id\": \"9d84b03a-28d1-4898-a69c-38824239e2b1\",\n  \"client_id\": \"{{clientId}}\",\n  \"customer_id\": \"{{customerId}}\",\n  \"type\": \"RECEIVER\",\n  \"rfc\": \"XAXX010101000\",\n  \"alias\": \"Tarjeta de Debito A\",\n  \"debit_card\": {\n    \"destination_bank_id\": \"d3435bd9-998d-4e8a-9067-6b71d5fd3ac7\",\n    \"card_number\": \"5579072268574100\",\n    \"holder_name\": \"Pedro Navajas Dos\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Notes:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["holder_name"]}," must have a maxLength of 40 characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If you don’t have the RFC for the card holder, you can send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ND"]},"."]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In this example we are using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_id"]}," for Banamex, you can use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v1/banks"]}," endpoint to search for other Banks."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field notes"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer_id"]}," (string, optional)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If provided, the instrument will be owned by this customer."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If omitted, the instrument belongs to the client itself."]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," (string, required)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For debit card instruments, only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RECEIVER"]}," is supported."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rfc"]}," (string, required)"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Tax identifier of the card holder. If you don’t have it, you can send ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ND"]},"."]}]}]}]},{"$$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\": \"dd7f8d89-94dd-43ca-871b-720fde378b52\",\n  \"bankId\": \"d3435bd9-998d-4e8a-9067-6b71d5fd3ac7\",\n  \"clientId\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n  \"ownerId\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n  \"alias\": \"Tarjeta con expiracion\",\n  \"type\": \"RECEIVER\",\n  \"instrumentDetail\": {\n    \"cardNumber\": \"5579072268574100\",\n    \"expirationDate\": \"None\",\n    \"holderName\": \"Pedro Navajas Dos\"\n  },\n  \"audit\": {\n    \"createdAt\": \"2025-05-19 19:03:51.084659-06:00\",\n    \"updatedAt\": \"2025-05-19 19:03:51.084659-06:00\",\n    \"deletedAt\": \"None\",\n    \"blockedAt\": \"None\"\n  },\n  \"rfc\": \"XAXX010101000\",\n  \"customerId\": \"bb1e8fde-e68e-48e9-a483-d32153c752c2\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response field notes"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customerId"]}," (string, optional) – Present when the instrument belongs to a customer. Omitted for client-level instruments."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"money-out","__idx":2},"children":["Money Out"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With the instrument associated to the recipient's Debit Card, and the default Instrument associated with your Centralizing Account, we have all the required data to initiate Money Out transactions."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the destination instrument belongs to a Finco Pay (Monato) account, this endpoint automatically routes the transaction as an internal book-to-book transfer — no SPEI, near-real-time settlement. No changes to the request body are required."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint supports ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Idempotency"]}," via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key"]}," header (TTL: 24 hours).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Reuse the same key ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["with the exact same body"]}," for safe retries.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"See ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Guides → Idempotency"]}," for details and code snippets."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v1/transactions/money_out"]}]},{"$$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"]},": none",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Query Parameters"]},": none",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Headers"]},":",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization: Bearer <token>"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/json"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Idempotency-Key: <uuid-v5>"]}," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(optional but recommended)"]},".",{"$$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  \"client_id\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n  \"source_instrument_id\":  \"709448c3-7cbf-454d-a87e-feb23801269a\",\n  \"destination_instrument_id\":\"dd7f8d89-94dd-43ca-871b-720fde378b52\",\n  \"transaction_request\": {\n    \"external_reference\":\"7654329\",\n    \"description\":\"lorem ipsum dolor sit amet\",\n    \"amount\":\"1.95\",\n    \"currency\":\"MXN\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The value for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_instrument_id"]}," is your default ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#collecting-information"},"children":["instrument"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"The value for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destination_instrument_id"]}," is from the previous ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#create-an-instrument"},"children":["request"]}]},{"$$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\": \"16811ee8-1ef9-4dd4-8d84-9c2df89cf302\",\n \"bankId\": \"9d84b03a-28d1-4898-a69c-38824239e2b1\",\n \"clientId\": \"c2d1d1e3-3340-4170-980e-e9269bbbc551\",\n \"externalReference\": \"1234567\",\n \"trackingId\": \"20250306FINCHVLIKQ5SKUM\",\n \"description\": \"lorem ipsum dolor sit amet\",\n \"amount\": \"1.95\",\n \"currency\": \"MXN\",\n \"category\": \"DEBIT_TRANS\",\n \"subCategory\": \"SPEI_DEBIT\",\n \"transactionStatus\": \"INITIALIZED\",\n \"audit\": {\n  \"createdAt\": \"2025-03-06 11:57:55.408000-06:00\",\n  \"updatedAt\": \"2025-03-06 11:57:55.408000-06:00\",\n  \"deletedAt\": \"None\",\n  \"blockedAt\": \"None\"\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"idempotency--common-outcomes","__idx":3},"children":["Idempotency — common outcomes"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Invalid key format"]}," (not UUID v5) → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400 Bad Request"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key–body mismatch"]}," (same key, different body) → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Duplicate while first is in-flight"]}," → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["409 Conflict"]}," (“operation … in progress”)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identical retry"]}," (same key + same body within 24h) → ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]}," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(same payload, served from cache)"]}]}]}]},"headings":[{"value":"Money Out to Debit Card","id":"money-out-to-debit-card","depth":1},{"value":"Create an Instrument","id":"create-an-instrument","depth":2},{"value":"Money Out","id":"money-out","depth":2},{"value":"Idempotency — common outcomes","id":"idempotency--common-outcomes","depth":3}],"frontmatter":{"seo":{"title":"Money Out to Debit Card"}},"lastModified":"2026-05-07T22:34:49.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/fincore/guides/money-out-to-debit-card","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}