Any fiat transactions submitted between 9:30 AM and 5:30 PM ET on a weekday are processed the same day. Transactions submitted outside these hours or on weekends will be settled the next business day.
This endpoint can only be used with beneficiaries created with auto_settlement set to false.
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"EngageXPay","description":"EngageXPay Orchestration API documentation. Guides and API reference for onboarding customers (KYB/KYC), managing beneficiaries, sending payouts, virtual accounts, balances, FX rates, and webhooks.","colors":{"primary":"#151515","light":"#ffffff","dark":"#151515"},"logo":{"light":"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/logo/engagexpay-light.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=4150a6758362fde0c5ab216d6382c1bd","dark":"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/logo/engagexpay-dark.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=fedf4d29a1a18785512adcf311045eb7"},"favicon":"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/favicon.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=68cef930bf5c9bcdb64b27f090c6c2b6","api":{"playground":{"display":"interactive","proxy":false},"examples":{"languages":["curl","node","java","python","go"]}},"appearance":{"default":"dark","strict":false},"background":{"color":{"dark":"#151515"}},"navbar":{"links":[],"primary":{"type":"button","label":"EngageXPay App","href":"https://app.engagexpay.com"}},"footer":{"socials":{}},"fonts":{"family":"Inter","weight":400},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/enagage-x-pay/jTINrWuRVZAADmLE/images/Thumbnail.png?fit=max\u0026auto=format\u0026n=jTINrWuRVZAADmLE\u0026q=85\u0026s=2ccd3da4235818679634f6957f5f91b6"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"enagage-x-pay","hasAudioNarration":false,"actualSubdomain":"enagage-x-pay","customDomains":["doc.engagexpay.com"],"gitSource":{"type":"github","owner":"engagexpay","repo":"doc","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"","_id":"6aea0d3f0fba27ac624555d0"},"chroma":{"latestBuiltDeploymentHistoryId":"6aeb2ac6d4e7ed0286063fab","collectionId":"c7801af1-ad9e-4164-9c06-424d4b732335","liveDeploymentHistoryId":"6aeb2ac6d4e7ed0286063fab","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb2b01119a07d709eaf68f","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API Reference","count":66},{"language":"default","tag":"Guides","count":28},{"language":"default","tag":"Transactions","count":22},{"language":"default","tag":"Beneficiaries","count":15},{"language":"default","tag":"Customers","count":14},{"language":"default","tag":"Webhooks","count":12},{"language":"default","tag":"Customers and compliance","count":11},{"language":"default","tag":"Catalogue","count":7},{"language":"default","tag":"All Catalogues","count":7},{"language":"default","tag":"Create now, settle later","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/transactions/create-a-transfer","slug":"/api-reference/transactions/create-a-transfer","pageMetadata":{"openapi":"POST /v1/transactions/transfer-payout","title":"Create a Transfer","description":"Initiate a transfer payout to a beneficiary.\n\n**Validation Rules:**\n- Minimum amount: 500 cents (5.00 in major currency units)\n- Attachments array is optional, but if provided must contain at least one item\n","href":"/api-reference/transactions/create-a-transfer"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n li: \"li\",\n p: \"p\",\n strong: \"strong\",\n ul: \"ul\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Initiate a transfer payout to a beneficiary.\"\n }), \"\\n\", _jsx(_components.p, {\n children: _jsx(_components.strong, {\n children: \"Validation Rules:\"\n })\n }), \"\\n\", _jsxs(_components.ul, {\n children: [\"\\n\", _jsx(_components.li, {\n children: \"Minimum amount: 500 cents (5.00 in major currency units)\"\n }), \"\\n\", _jsx(_components.li, {\n children: \"Attachments array is optional, but if provided must contain at least one item\"\n }), \"\\n\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components},{Note}=_components;if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(Note,{children:_jsx(_components.p,{children:`Any fiat transactions submitted between 9:30 AM and 5:30 PM ET on a weekday are processed the same day. Transactions submitted outside these hours or on weekends will be settled the next business day.`})}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`This endpoint can only be used with beneficiaries created with `,_jsx(_components.code,{children:`auto_settlement`}),` set to `,_jsx(_components.code,{children:`false`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"POST /v1/transactions/transfer-payout","title":"Create a Transfer","description":"Initiate a transfer payout to a beneficiary.\n\n**Validation Rules:**\n- Minimum amount: 500 cents (5.00 in major currency units)\n- Attachments array is optional, but if provided must contain at least one item\n","href":"/api-reference/transactions/create-a-transfer"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create a Transfer","description":"Initiate a transfer payout to a beneficiary.\n\n**Validation Rules:**\n- Minimum amount: 500 cents (5.00 in major currency units)\n- Attachments array is optional, but if provided must contain at least one item\n","x-mint":{"content":"\u003cNote>\n This endpoint can only be used with beneficiaries created with `auto_settlement` set to `false`.\n\u003c/Note>\n"},"tags":["Transactions"],"security":["bf87f242-324c-4fa0-9fb8-e04837f81679"],"requestBody":"487cd144-8fbb-474c-97ac-ede047d28c4b","responses":{"200":"eb88bf96-5504-4739-9257-3a1cde9ad52a","401":"afa32b65-83e2-449a-929e-4f09f1fc746b","422":"19a6ad94-9760-4b70-9af0-c0cb37aed99f"},"method":"post","type":"path","servers":["cbeade3a-6620-4ea8-a8b3-35acd1819633","dafcce7c-d9d9-422e-9aae-ab48e7d0edc1"],"path":"/v1/transactions/transfer-payout","baseUrlOptions":["https://sandbox.api.engagexpay.com","https://api.engagexpay.com"],"title":"Create a Transfer","codeSamples":[],"requestExampleLanguages":["bash","node","java","python","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["beneficiary_id","reference_id","amount","remarks"],"properties":{"beneficiary_id":{"type":"string","format":"uuid","example":"d6ae4ea6-0482-47ab-a895-02e50ea6358b","isRequired":true,"uniqueKey":"beneficiary_id","typeLabel":"string\u003cuuid>"},"reference_id":{"type":"string","example":"REF-12345-ABC","isRequired":true,"uniqueKey":"reference_id","typeLabel":"string"},"amount":{"type":"integer","description":"Amount in cents (multiply by 100). Minimum 500 cents required.","example":10000,"minimum":500,"isRequired":true,"uniqueKey":"amount","typeLabel":"integer"},"remarks":{"type":"string","example":"Monthly payment for services","isRequired":true,"uniqueKey":"remarks","typeLabel":"string"},"attachments":{"type":"array","minItems":1,"items":{"type":"object","required":["remark","uri"],"properties":{"remark":{"type":"string","example":"Invoice PDF DOC","isRequired":true,"uniqueKey":"attachments.items.[INDEX].remark","typeLabel":"string"},"uri":{"type":"string","example":"/XUOdWacK_Invoice.pdf","isRequired":true,"uniqueKey":"attachments.items.[INDEX].uri","typeLabel":"string"}},"uniqueKey":"attachments.items.[INDEX]","typeLabel":"object"},"uniqueKey":"attachments","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"beneficiary_id":"d6ae4ea6-0482-47ab-a895-02e50ea6358b","reference_id":"REF-12345-ABC","amount":10000,"remarks":"Monthly payment for services","attachments":[{"remark":"Invoice PDF DOC","uri":"/XUOdWacK_Invoice.pdf"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"eb88bf96-5504-4739-9257-3a1cde9ad52a":{"description":"Transfer created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"transfer_id":{"type":"string","format":"uuid","example":"c78dee10-7c46-4ad5-8ac8-070e39d87ff1","uniqueKey":"data.transfer_id","typeLabel":"string\u003cuuid>"},"reference_id":{"type":"string","example":"REF-12345-ABC","uniqueKey":"data.reference_id","typeLabel":"string"},"deposit_instruction":{"type":"object","properties":{"liquidation_address":{"type":"string","example":"0x203061afd3f3dd5f5756cec992d1d247f7668384","uniqueKey":"data.deposit_instruction.liquidation_address","typeLabel":"string"},"currency":{"type":"string","example":"USDC","uniqueKey":"data.deposit_instruction.currency","typeLabel":"string"},"rail":{"type":"string","example":"POLYGON","uniqueKey":"data.deposit_instruction.rail","typeLabel":"string"}},"uniqueKey":"data.deposit_instruction","typeLabel":"object"},"quotation":{"type":"object","properties":{"currency":{"type":"string","example":"EUR","uniqueKey":"data.quotation.currency","typeLabel":"string"},"to_amount":{"type":"integer","example":108,"uniqueKey":"data.quotation.to_amount","typeLabel":"integer"},"developer_fee":{"type":"integer","example":67,"uniqueKey":"data.quotation.developer_fee","typeLabel":"integer"}},"uniqueKey":"data.quotation","typeLabel":"object"},"created_at":{"type":"string","format":"date-time","example":"2026-01-01T07:35:53Z","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"expire_at":{"type":"string","format":"date-time","example":"2026-01-01T07:45:53Z","uniqueKey":"data.expire_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"transfer_id":"c78dee10-7c46-4ad5-8ac8-070e39d87ff1","reference_id":"REF-12345-ABC","deposit_instruction":{"liquidation_address":"0x203061afd3f3dd5f5756cec992d1d247f7668384","currency":"USDC","rail":"POLYGON"},"quotation":{"currency":"EUR","to_amount":108,"developer_fee":67},"created_at":"2026-01-01T07:35:53Z","expire_at":"2026-01-01T07:45:53Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"afa32b65-83e2-449a-929e-4f09f1fc746b":{"description":"Authentication failed due to invalid credentials","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Authentication failed","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Authentication failed"}}},"exampleType":"generated"}},"exampleType":"generated"},"19a6ad94-9760-4b70-9af0-c0cb37aed99f":{"description":"Failed due to a formatting error.","content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"errors":{"type":"array","items":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"errors.items.[INDEX].additionalProperties","typeLabel":"string"},"uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"uniqueKey":"errors","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","errors":[{}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bf87f242-324c-4fa0-9fb8-e04837f81679":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication. Obtain token from [Issue a Token](https://docs.engagexpay.com/api-reference/authentication/issue-a-token) endpoint","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"cbeade3a-6620-4ea8-a8b3-35acd1819633":{"url":"https://sandbox.api.engagexpay.com","description":"Sandbox server"},"dafcce7c-d9d9-422e-9aae-ab48e7d0edc1":{"url":"https://api.engagexpay.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication. Obtain token from [Issue a Token](https://docs.engagexpay.com/api-reference/authentication/issue-a-token) endpoint","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication. Obtain token from [Issue a Token](https://docs.engagexpay.com/api-reference/authentication/issue-a-token) endpoint","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"enagage-x-pay","siteName":"EngageXPay","title":"Create a Transfer - EngageXPay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T16:36:16.721Z","originalFileLocation":"api-reference/transactions/create-a-transfer.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Initiate a transfer payout to a beneficiary. Validation Rules: - Minimum amount: 500 cents (5.00 in major currency units) - Attachments array is optional, but if provided must contain at least one item\">\u003cmeta data-mint-head name=\"application-name\" content=\"EngageXPay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a Transfer - EngageXPay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiate a transfer payout to a beneficiary. Validation Rules: - Minimum amount: 500 cents (5.00 in major currency units) - Attachments array is optional, but if provided must contain at least one item\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"EngageXPay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://enagage-x-pay.mintlify.app/_mintlify/api/og/v2?division=Create+now%2C+settle+later\u0026amp;title=Create+a+Transfer\u0026amp;description=Initiate+a+transfer+payout+to+a+beneficiary.%0A%0A**Validation+Rules%3A**%0A-+Minimum+amount%3A+500+cents+%285.00+in+major+currency+units%29%0A-+Attachments+array+is+optional%2C+\u0026amp;theme=2356807b39eb913fdb8aabf5\u0026amp;signature=734d43eba30021c346c66220a4f7f316f15542472118ab9c1532e7c096b34c0e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create a Transfer - EngageXPay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiate a transfer payout to a beneficiary. Validation Rules: - Minimum amount: 500 cents (5.00 in major currency units) - Attachments array is optional, but if provided must contain at least one item\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://enagage-x-pay.mintlify.app/_mintlify/api/og/v2?division=Create+now%2C+settle+later\u0026amp;title=Create+a+Transfer\u0026amp;description=Initiate+a+transfer+payout+to+a+beneficiary.%0A%0A**Validation+Rules%3A**%0A-+Minimum+amount%3A+500+cents+%285.00+in+major+currency+units%29%0A-+Attachments+array+is+optional%2C+\u0026amp;theme=2356807b39eb913fdb8aabf5\u0026amp;signature=734d43eba30021c346c66220a4f7f316f15542472118ab9c1532e7c096b34c0e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/enagage-x-pay/rcU3n-36H6C4X8E2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"EngageXPay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#151515\">\u003clink data-mint-head rel=\"canonical\" href=\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/transactions/create-a-transfer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://doc.engagexpay.com/#organization\",\"name\":\"EngageXPay\",\"url\":\"https://doc.engagexpay.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/enagage-x-pay/FEj0pOmeiBFLeLWn/logo/engagexpay-light.svg?fit=max\u0026auto=format\u0026n=FEj0pOmeiBFLeLWn\u0026q=85\u0026s=4150a6758362fde0c5ab216d6382c1bd\"}},{\"@type\":\"WebSite\",\"@id\":\"https://doc.engagexpay.com#website\",\"name\":\"EngageXPay\",\"url\":\"https://doc.engagexpay.com\",\"publisher\":{\"@id\":\"https://doc.engagexpay.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer#webpage\",\"url\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer\",\"name\":\"Create a Transfer\",\"description\":\"Initiate a transfer payout to a beneficiary. Validation Rules: - Minimum amount: 500 cents (5.00 in major currency units) - Attachments array is optional, but if provided must contain at least one item\",\"dateModified\":\"2026-11-03T16:36:16.721Z\",\"isPartOf\":{\"@id\":\"https://doc.engagexpay.com#website\"},\"breadcrumb\":{\"@id\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Transactions\",\"item\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer-v3\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create now, settle later\",\"item\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer-v3\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create a Transfer\",\"item\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer#apireference\",\"headline\":\"Create a Transfer\",\"name\":\"Create a Transfer\",\"description\":\"Initiate a transfer payout to a beneficiary. Validation Rules: - Minimum amount: 500 cents (5.00 in major currency units) - Attachments array is optional, but if provided must contain at least one item\",\"url\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer\",\"mainEntityOfPage\":{\"@id\":\"https://doc.engagexpay.com/api-reference/transactions/create-a-transfer#webpage\"},\"dateModified\":\"2026-11-03T16:36:16.721Z\",\"publisher\":{\"@id\":\"https://doc.engagexpay.com/#organization\"},\"isPartOf\":{\"@id\":\"https://doc.engagexpay.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"EngageXPay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"EngageXPay","nav":{"global":null,"tabs":[{"tab":"Main Site","href":"https://engagexpay.com"},{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","pages":[{"group":"Authentication","pages":[{"openapi":"POST /v1/oauth/token","title":"Issue a Token","href":"/api-reference/authentication/issue-a-token"},{"openapi":"POST /v1/oauth/refresh-token","title":"Refresh a Token","href":"/api-reference/authentication/refresh-a-token"}]},{"group":"Customers","pages":[{"group":"Create Individual Customer","expanded":false,"pages":[{"openapi":"POST /v2/customers/individual","title":"Create Individual Customer","href":"/api-reference/customers/create-individual-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/individual/attach","title":"Attach Documents to Individual Customer","href":"/api-reference/customers/attach-documents-to-individual-customer-v2"}]},{"group":"Create Business Customer","expanded":false,"pages":[{"openapi":"POST /v2/customers/business","title":"Create Business Customer","href":"/api-reference/customers/create-business-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/business/attach","title":"Attach Documents to Business Customer","href":"/api-reference/customers/attach-documents-to-business-customer-v2"},{"openapi":"POST /v2/customers/{customer_id}/associated-parties/individual/attach","title":"Attach Documents to Associated Party","href":"/api-reference/customers/attach-documents-to-associated-party-v2"}]},{"openapi":"GET /v2/customers/{customer_id}","title":"Get Customer Details","href":"/api-reference/customers/get-customer-details-v2"},{"openapi":"GET /v2/customers","title":"List Customers","href":"/api-reference/customers/list-customers-v2"},{"openapi":"GET /v2/customers/{customer_id}/capabilities","title":"Get Customer Capabilities","href":"/api-reference/customers/get-customer-capabilities"},{"title":"Get Required Documents","openapi":"GET /v2/customers/required-documents","href":"/api-reference/customers/get-required-documents"},{"openapi":"POST /v1/customers/upload","title":"Upload Document","href":"/api-reference/customers/upload-document"},{"openapi":"PATCH /v1/customers/{customer_id}","title":"Patch Customer RFI","href":"/api-reference/customers/patch-customer-rfi"}]},{"group":"Beneficiaries","pages":[{"group":"Create Beneficiary","expanded":false,"pages":[{"openapi":"POST /v3/beneficiaries","title":"Create Beneficiary V3","href":"/api-reference/beneficiaries/create-beneficiary-v3"},{"openapi":"POST /v2/beneficiaries","title":"Create Beneficiary V2","href":"/api-reference/beneficiaries/create-beneficiary-v2"},{"openapi":"GET /v1/beneficiaries/countries","title":"List Available Countries","href":"/api-reference/beneficiaries/list-available-countries"},{"openapi":"GET /v1/beneficiaries/methods","title":"List Bank Identifiers","href":"/api-reference/beneficiaries/list-bank-identifiers"},{"openapi":"GET /v1/beneficiaries/methods/{method_id}/branches","title":"List Bank Branch Identifiers","href":"/api-reference/beneficiaries/list-bank-branch-identifiers"}]},{"openapi":"GET /v2/beneficiaries/details","title":"Fetch Beneficiary Details","href":"/api-reference/beneficiaries/fetch-beneficiary-details-v2"},{"openapi":"GET /v1/customers/{customer_id}/beneficiaries","title":"List Beneficiaries For a Customer","href":"/api-reference/beneficiaries/list-beneficiaries-for-a-customer"},{"openapi":"PATCH /v1/beneficiaries","title":"Update Beneficiary Active Status","href":"/api-reference/beneficiaries/update-beneficiary-active-status"},{"openapi":"POST /v1/beneficiaries/{beneficiary_id}/documents","title":"Upload Beneficiary Documents","href":"/api-reference/beneficiaries/upload-beneficiary-documents"}]},{"group":"Virtual Accounts","pages":[{"group":"Create Virtual Account","expanded":false,"pages":[{"openapi":"POST /v3/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V3","href":"/api-reference/virtual-accounts/create-virtual-account-v3"},{"openapi":"POST /v2/customers/{customer_id}/virtual-accounts","title":"Create Virtual Account V2","href":"/api-reference/virtual-accounts/create-virtual-account-v2"}]},{"openapi":"GET /v3/customers/{customer_id}/virtual-accounts","title":"List Virtual Accounts","href":"/api-reference/virtual-accounts/list-virtual-accounts-v3"},{"openapi":"GET /v3/customers/{customer_id}/virtual-accounts/{va_id}","title":"Get Virtual Account Details","href":"/api-reference/virtual-accounts/get-virtual-account-details"},{"openapi":"GET /v1/virtual-account/{virtual_account_id}/transactions","title":"Fetch Virtual Account Transactions","href":"/api-reference/virtual-accounts/fetch-virtual-account-transactions"}]},{"group":"Transactions","pages":[{"group":"Create now, settle later","expanded":false,"pages":[{"openapi":"POST /v3/transactions/transfer-payout","title":"Create a Transfer V3","description":"Initiate a transfer payout to a beneficiary.\n\n**Validation Rules:**\n- Send exactly one of `source_amount` or `destination_amount`, never both\n- `source_amount` minimum: 500 cents (5.00 in major currency units)\n- Attachments array is optional, but if provided must contain at least one item\n","href":"/api-reference/transactions/create-a-transfer-v3"},{"openapi":"POST /v1/transactions/transfer-payout","title":"Create a Transfer","href":"/api-reference/transactions/create-a-transfer"},{"openapi":"POST /v2/transactions/transfer-payout","title":"Create a Transfer V2","description":"Initiate a transfer payout to a beneficiary.\n\n**Validation Rules:**\n- Send exactly one of `source_amount` or `destination_amount`, never both\n- `source_amount` minimum: 500 cents (5.00 in major currency units)\n- Attachments array is optional, but if provided must contain at least one item\n","href":"/api-reference/transactions/create-a-transfer-v2"},{"openapi":"POST /v3/transactions/transfer-payout/settle","title":"Settle a Transfer V3","href":"/api-reference/transactions/settle-a-transfer-v3"},{"openapi":"POST /v1/transactions/transfer-payout/settle","title":"Settle a Transfer","href":"/api-reference/transactions/settle-a-transfer"},{"openapi":"POST /v2/transactions/transfer-payout/settle","title":"Settle a Transfer V2","href":"/api-reference/transactions/settle-a-transfer-v2"},{"openapi":"POST /v1/beneficiaries/{beneficiary_id}/documents","title":"Upload Beneficiary Documents","href":"/api-reference/transactions/upload-beneficiary-documents"}]},{"group":"Batch Transfer","expanded":false,"pages":[{"openapi":"POST /v3/batch/transactions/commit","title":"Execute Batch Transfer V3","href":"/api-reference/transactions/execute-batch-transfer-v3"},{"openapi":"POST /v1/batch/transactions/commit","title":"Execute Batch Transfer","href":"/api-reference/transactions/execute-batch-transfer"},{"openapi":"GET /v1/batch/transactions/commit/{batch_id}","title":"Fetch Batch Details","href":"/api-reference/transactions/fetch-batch-details"}]},{"group":"Crypto Transfer","expanded":false,"pages":[{"openapi":"POST /v3/transactions/quote","title":"Create Quote V3","href":"/api-reference/transactions/create-quote-v3"},{"openapi":"POST /v2/transactions/quote","title":"Create Quote","href":"/api-reference/transactions/create-quote"},{"openapi":"POST /v3/transactions","title":"Execute Quote V3","href":"/api-reference/transactions/execute-quote-v3"},{"openapi":"POST /v2/transactions","title":"Execute Quote","href":"/api-reference/transactions/execute-quote"}]},{"group":"Transactions List","expanded":false,"pages":[{"openapi":"GET /v3/transactions","title":"List Customer Transactions V3","href":"/api-reference/transactions/list-customer-transactions-v3"},{"openapi":"GET /v2/transactions","title":"List Customer Transactions","href":"/api-reference/transactions/list-customer-transactions"},{"openapi":"GET /v1/beneficiaries/{beneficiary_id}/transactions","title":"List Beneficiary Transactions","href":"/api-reference/transactions/list-beneficiary-transactions"}]},{"group":"Transaction Details","expanded":false,"pages":[{"openapi":"GET /v3/transactions/{transaction_id}","title":"Fetch Transaction Details V3","href":"/api-reference/transactions/fetch-transaction-details-v3"},{"openapi":"GET /v2/transactions/{transaction_id}","title":"Fetch Transaction Details","href":"/api-reference/transactions/fetch-transaction-details-v2"}]}]},{"group":"Balances","pages":[{"openapi":"GET /v1/wallet/balances","title":"Fetch Prefunded Balance","href":"/api-reference/balances/fetch-prefunded-balance"}]},{"group":"Fees \u0026 FX Rates","pages":[{"openapi":"GET /v1/fx-rate","title":"Fetch Exchange Rates","href":"/api-reference/fees-and-fx-rates/fetch-exchange-rates"},{"openapi":"POST /v1/fee-calculation","title":"Calculate Exchange Rates","href":"/api-reference/fees-and-fx-rates/calculate-exchange-rates"}]},{"group":"Catalogue","pages":[{"group":"All Catalogues","expanded":false,"pages":[{"openapi":"GET /v1/occupations","title":"List Occupations","href":"/api-reference/catalogue/list-occupations"},{"openapi":"GET /v1/source-of-funds","title":"List Source of Funds","href":"/api-reference/catalogue/list-source-of-funds"},{"openapi":"GET /v1/source-of-wealth","title":"List Source of Wealth","href":"/api-reference/catalogue/list-source-of-wealth"},{"openapi":"GET /v1/purposes","title":"List Account Purposes","href":"/api-reference/catalogue/list-account-purposes"},{"title":"List Generic Country Codes","openapi":"GET /v1/countries","href":"/api-reference/catalogue/list-countries"},{"openapi":"GET /v1/countries/{country_code}/subdivisions","title":"List Subdivision Codes: ISO 3166-1 alpha-2","href":"/api-reference/catalogue/list-subdivisions"},{"openapi":"GET /v1/transaction-purposes","title":"List Transaction Purposes","href":"/api-reference/catalogue/list-transaction-purposes"}]}]},{"group":"Webhooks","pages":[{"group":"Customers","expanded":false,"pages":[{"openapi":"WEBHOOK customer.created","title":"Customer Created","href":"/api-reference/webhooks/customer-created"},{"openapi":"WEBHOOK customer.status","title":"Customer Status","href":"/api-reference/webhooks/customer-status"},{"openapi":"WEBHOOK customer.rfi","title":"Customer RFI","href":"/api-reference/webhooks/customer-rfi"}]},{"group":"Beneficiaries","expanded":false,"pages":[{"openapi":"WEBHOOK beneficiary.created","title":"Beneficiary Created","href":"/api-reference/webhooks/beneficiary-created"},{"openapi":"WEBHOOK beneficiary.status","title":"Beneficiary Status","href":"/api-reference/webhooks/beneficiary-status"}]},{"group":"Virtual Accounts","expanded":false,"pages":[{"openapi":"WEBHOOK virtual_account.created.v2","title":"Virtual Account Created V2","href":"/api-reference/webhooks/virtual-account-created-v2"},{"openapi":"WEBHOOK virtual_account.status.v2","title":"Virtual Account Status V2","href":"/api-reference/webhooks/virtual-account-status-v2"}]},{"group":"Transactions","expanded":false,"pages":[{"openapi":"WEBHOOK transaction.status","title":"Transaction Status","href":"/api-reference/webhooks/transaction-status"},{"openapi":"WEBHOOK beneficiary.liquidation.deposit","title":"Beneficiary Liquidation Deposit","href":"/api-reference/webhooks/beneficiary-liquidation-deposit"},{"openapi":"WEBHOOK batch.transaction.item.status","title":"Batch Transaction Item Status","href":"/api-reference/webhooks/batch-transaction-item-status"}]}]}]},{"tab":"Changelogs","pages":[{"title":"Changelogs","href":"/changelogs/2026-10-27"}]},{"tab":"FAQs","pages":[{"title":"FAQs","href":"/faqs"}]}]},"basePath":"","title":"Create a Transfer - EngageXPay","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}