{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Hyperrails - Documentation","colors":{"primary":"#000000","light":"#B5FD85","dark":"#B5FD85"},"logo":{"light":"https://mintcdn.com/spotflow-35c4e57d/MzCwgkAXdZHJ-ozD/logo/hyperrail-logo.svg?fit=max\u0026auto=format\u0026n=MzCwgkAXdZHJ-ozD\u0026q=85\u0026s=36b2762fcd322fd0ead27debbfa4f0d2","dark":"https://mintcdn.com/spotflow-35c4e57d/MzCwgkAXdZHJ-ozD/logo/hyperrail-logo.svg?fit=max\u0026auto=format\u0026n=MzCwgkAXdZHJ-ozD\u0026q=85\u0026s=36b2762fcd322fd0ead27debbfa4f0d2"},"favicon":"https://mintcdn.com/spotflow-35c4e57d/uup8yiheAahgEkJJ/favicon.svg?fit=max\u0026auto=format\u0026n=uup8yiheAahgEkJJ\u0026q=85\u0026s=0cdc549443f5992203085786298dba72","appearance":{"default":"dark","strict":true},"background":{"decoration":"grid","color":{"light":"#ffffff","dark":"#000"}},"navbar":{"links":[{"href":"https://app.hyperrails.io/","label":"Get Started"}]},"fonts":{"family":"IBM Plex Sans"},"styling":{"codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spotflow-35c4e57d","hasAudioNarration":false,"actualSubdomain":"spotflow-35c4e57d","customDomains":["docs.hyperrails.io"],"gitSource":{"type":"github","owner":"hyper-rail","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ab3bc9ddd372f63393ce5ed","clientVersion":"0.0.4076","searchFilterCounts":[{"language":"default","tag":"API reference","count":31},{"language":"default","tag":"Documentation","count":25},{"language":"default","tag":"Exchange","count":12},{"language":"default","tag":"Features","count":11},{"language":"default","tag":"Guides","count":6},{"language":"default","tag":"Payout","count":5},{"language":"default","tag":"Wallets and Balances","count":4},{"language":"default","tag":"API Reference","count":3},{"language":"default","tag":"Dynamic Accounts","count":3},{"language":"default","tag":"Rates","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"editor-metadata","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},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/payout/withdrawal","slug":"/api-reference/payout/withdrawal","pageMetadata":{"title":"Create Fiat Payout","openapi":"POST /partners/payouts","description":"Processes a withdrawal request from a specified account to a destination bank account.","href":"/api-reference/payout/withdrawal"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Processes a withdrawal request from a specified account to a destination bank account.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Create Fiat Payout","openapi":"POST /partners/payouts","description":"Processes a withdrawal request from a specified account to a destination bank account.","href":"/api-reference/payout/withdrawal"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Initiate Bank Withdrawal","description":"Processes a withdrawal request from a specified account to a destination bank account.","tags":["Withdrawals"],"requestBody":"04b986f8-fc86-4478-a804-4e8e687f8c1e","responses":{"200":"01c5475c-3ccc-42ed-ba9f-9ad53f00f6a9","400":"7e294519-d2bf-41ac-a688-ae8bfd3a0f0e","401":"6208d37a-ae46-4d1a-bbbe-4b0260ef96e6","422":"a5b53568-de27-484b-b582-94db05ce0acc","503":"cd70feeb-8722-4a37-98df-fdac77da7daa"},"method":"post","type":"path","servers":["7acd88bb-7a76-4beb-9560-194f5533ef52"],"security":["f7386558-c10f-4119-a30c-2d0c5d1bf2c2"],"path":"/partners/payouts","baseUrlOptions":["https://api.hyperrails.io/api/v1"],"title":"Initiate Bank Withdrawal","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["reference","amount","currency","destination"],"properties":{"reference":{"type":"string","description":"Unique idempotency reference for this payout. Used to prevent duplicate transfers.","example":"payout-li","minLength":1,"maxLength":100,"isRequired":true,"uniqueKey":"reference","typeLabel":"string"},"amount":{"type":"number","example":100,"isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"currency":{"type":"string","description":"Currency code for the transfer","example":"NGN","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"destination":{"type":"object","required":["accountNumber","accountName","bankCode"],"properties":{"accountNumber":{"type":"string","description":"Recipient bank account number (10 digits for Nigerian banks)","example":"0123456789","pattern":"^[0-9]{10}$","isRequired":true,"uniqueKey":"destination.accountNumber","typeLabel":"string"},"accountName":{"type":"string","description":"Account holder name (must match bank records)","example":"Jane Doe","minLength":2,"maxLength":100,"isRequired":true,"uniqueKey":"destination.accountName","typeLabel":"string"},"bankCode":{"type":"string","description":"Bank code (3 digits for Nigerian banks, 6 digits for Ghanaian banks)","example":"058","isRequired":true,"uniqueKey":"destination.bankCode","typeLabel":"string"},"branchCode":{"type":"string","description":"Bank branch code (optional for most Nigerian banks)","example":"001","uniqueKey":"destination.branchCode","typeLabel":"string"}},"isRequired":true,"uniqueKey":"destination","typeLabel":"object"},"narration":{"type":"string","example":"..","uniqueKey":"narration","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"ngnPayout":{"title":"ngnPayout","value":{"reference":"payout-001","amount":10000,"currency":"NGN","destination":{"accountNumber":"0123456789","accountName":"Jane Doe","bankCode":"058","branchCode":"001"},"narration":"Vendor payout April"}},"ghsPayout":{"title":"ghsPayout","value":{"reference":"payout-002","amount":50000,"currency":"GHS","destination":{"accountNumber":"0987654321","accountName":"John Smith","bankCode":"030100","branchCode":"001"},"narration":"Salary payment"}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"01c5475c-3ccc-42ed-ba9f-9ad53f00f6a9":{"description":"Withdrawal initiated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"type":"number","format":"double","example":100,"uniqueKey":"amount","typeLabel":"number\u003cdouble>"},"currency":{"type":"string","example":"NGN","uniqueKey":"currency","typeLabel":"string"},"destination":{"type":"object","properties":{"accountNumber":{"type":"string","example":"8083233781","uniqueKey":"destination.accountNumber","typeLabel":"string"},"accountName":{"type":"string","example":"John Doe","uniqueKey":"destination.accountName","typeLabel":"string"},"bankCode":{"type":"string","example":"SPB-17646","uniqueKey":"destination.bankCode","typeLabel":"string"}},"uniqueKey":"destination","typeLabel":"object"},"providerStatus":{"type":"string","description":"Status of the transaction with the upstream provider.","example":"PROCESSING","uniqueKey":"providerStatus","typeLabel":"string"},"reference":{"type":"string","description":"Unique transaction reference.","example":"TRF-a633516c526a40c4b2ebc6e3c249c5f5","uniqueKey":"reference","typeLabel":"string"},"status":{"type":"string","description":"Internal processing status.","example":"PROCESSING","uniqueKey":"status","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"example":{"reference":"payout-001","hyperrailReference":"HPR-TRSF-3a1b2c3d4e5f","amount":10000,"fee":50,"currency":"NGN","destination":{"accountNumber":"0123456789","accountName":"Jane Doe","bankCode":"058","branchCode":"001","bankName":"GTBank"},"narration":"Vendor payout April","status":"processing","createdAt":"2026-04-24T10:30:00Z","estimatedCompletionAt":"2026-04-24T10:35:00Z"},"examples":{"Example":{"title":"Example","value":{"reference":"payout-001","hyperrailReference":"HPR-TRSF-3a1b2c3d4e5f","amount":10000,"fee":50,"currency":"NGN","destination":{"accountNumber":"0123456789","accountName":"Jane Doe","bankCode":"058","branchCode":"001","bankName":"GTBank"},"narration":"Vendor payout April","status":"processing","createdAt":"2026-04-24T10:30:00Z","estimatedCompletionAt":"2026-04-24T10:35:00Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"7e294519-d2bf-41ac-a688-ae8bfd3a0f0e":{"description":"Bad request - Invalid withdrawal details","content":{"application/json":{"schema":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Error code","example":"INVALID_CURRENCY","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Error message","example":"Invalid source currency. Supported: NGN, GHS","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","description":"Additional error details","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"insufficientBalance":{"title":"insufficientBalance","value":{"code":"INSUFFICIENT_BALANCE","message":"Account balance (5000 NGN) is less than requested amount (10000 NGN) plus fees (50 NGN)"}},"invalidBankCode":{"title":"invalidBankCode","value":{"code":"INVALID_BANK_CODE","message":"Bank code '999' is not a valid Nigerian bank code"}},"invalidAccountNumber":{"title":"invalidAccountNumber","value":{"code":"INVALID_ACCOUNT_NUMBER","message":"Account number must be 10 digits for Nigerian banks"}},"duplicateReference":{"title":"duplicateReference","value":{"code":"DUPLICATE_REFERENCE","message":"Payout with reference 'payout-001' already exists"}},"accountNameMismatch":{"title":"accountNameMismatch","value":{"code":"NAME_MISMATCH","message":"Provided account name 'Jane Doe' does not match bank records 'Jane D. Doe'"}}},"exampleType":"examples"}},"exampleType":"examples"},"6208d37a-ae46-4d1a-bbbe-4b0260ef96e6":{"description":"Unauthorized - Invalid or missing authentication token","content":{"application/json":{"schema":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Error code","example":"INVALID_CURRENCY","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Error message","example":"Invalid source currency. Supported: NGN, GHS","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","description":"Additional error details","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"INVALID_CURRENCY","message":"Invalid source currency. Supported: NGN, GHS","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"a5b53568-de27-484b-b582-94db05ce0acc":{"description":"Unprocessable entity - Amount below minimum threshold","content":{"application/json":{"schema":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Error code","example":"INVALID_CURRENCY","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Error message","example":"Invalid source currency. Supported: NGN, GHS","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","description":"Additional error details","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"AMOUNT_TOO_LOW","message":"Minimum withdrawal amount is 100 NGN"},"examples":{"Example":{"title":"Example","value":{"code":"AMOUNT_TOO_LOW","message":"Minimum withdrawal amount is 100 NGN"}}},"exampleType":"examples"}},"exampleType":"examples"},"cd70feeb-8722-4a37-98df-fdac77da7daa":{"description":"Service unavailable - Bank service temporarily unavailable","content":{"application/json":{"schema":{"required":["code","message"],"type":"object","properties":{"code":{"type":"string","description":"Error code","example":"INVALID_CURRENCY","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","description":"Error message","example":"Invalid source currency. Supported: NGN, GHS","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"details":{"type":"object","description":"Additional error details","additionalProperties":true,"uniqueKey":"details","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"code":"SERVICE_UNAVAILABLE"},"examples":{"Example":{"title":"Example","value":{"code":"SERVICE_UNAVAILABLE"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"f7386558-c10f-4119-a30c-2d0c5d1bf2c2":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"API key authentication using Bearer token","scopes":[]}}},"servers":{"7acd88bb-7a76-4beb-9560-194f5533ef52":{"description":"Live server","url":"https://api.hyperrails.io/api/v1"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"API key authentication using Bearer token","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key authentication using Bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"spotflow-35c4e57d","siteName":"Hyperrails - Documentation","title":"Create Fiat Payout - Hyperrails - Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-23T11:48:52.380Z","originalFileLocation":"api-reference/payout/withdrawal.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"Processes a withdrawal request from a specified account to a destination bank account.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Hyperrails - Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spotflow-35c4e57d/N33Z6y1gPffBO22K/_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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spotflow-35c4e57d/N33Z6y1gPffBO22K/_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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Fiat Payout - Hyperrails - Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Processes a withdrawal request from a specified account to a destination bank account.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Hyperrails - Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.hyperrails.io/api-reference/payout/withdrawal\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spotflow-35c4e57d.mintlify.site/_mintlify/api/og/v2?division=Payout\u0026amp;title=Create+Fiat+Payout\u0026amp;description=Processes+a+withdrawal+request+from+a+specified+account+to+a+destination+bank+account.\u0026amp;theme=53cf077eef7a68dff590df8a\u0026amp;signature=4ce9210f09cfeed138e6cf9582f924cf86a509d42be5e71a78fd78288848367f\">\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 Fiat Payout - Hyperrails - Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Processes a withdrawal request from a specified account to a destination bank account.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spotflow-35c4e57d.mintlify.site/_mintlify/api/og/v2?division=Payout\u0026amp;title=Create+Fiat+Payout\u0026amp;description=Processes+a+withdrawal+request+from+a+specified+account+to+a+destination+bank+account.\u0026amp;theme=53cf077eef7a68dff590df8a\u0026amp;signature=4ce9210f09cfeed138e6cf9582f924cf86a509d42be5e71a78fd78288848367f\">\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/spotflow-35c4e57d/N33Z6y1gPffBO22K/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Hyperrails - Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.hyperrails.io/api-reference/payout/withdrawal\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/payout/withdrawal.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.hyperrails.io/#organization\",\"name\":\"Hyperrails - Documentation\",\"url\":\"https://docs.hyperrails.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spotflow-35c4e57d/MzCwgkAXdZHJ-ozD/logo/hyperrail-logo.svg?fit=max\u0026auto=format\u0026n=MzCwgkAXdZHJ-ozD\u0026q=85\u0026s=36b2762fcd322fd0ead27debbfa4f0d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.hyperrails.io#website\",\"name\":\"Hyperrails - Documentation\",\"url\":\"https://docs.hyperrails.io\",\"publisher\":{\"@id\":\"https://docs.hyperrails.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal#webpage\",\"url\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal\",\"name\":\"Create Fiat Payout\",\"description\":\"Processes a withdrawal request from a specified account to a destination bank account.\",\"dateModified\":\"2026-09-23T11:48:52.380Z\",\"isPartOf\":{\"@id\":\"https://docs.hyperrails.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Hyperrails - Documentation\",\"item\":\"https://docs.hyperrails.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Fiat Payout\",\"item\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal#apireference\",\"headline\":\"Create Fiat Payout\",\"name\":\"Create Fiat Payout\",\"description\":\"Processes a withdrawal request from a specified account to a destination bank account.\",\"url\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal\",\"mainEntityOfPage\":{\"@id\":\"https://docs.hyperrails.io/api-reference/payout/withdrawal#webpage\"},\"dateModified\":\"2026-09-23T11:48:52.380Z\",\"publisher\":{\"@id\":\"https://docs.hyperrails.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.hyperrails.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Hyperrails - Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Hyperrails - Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"scroll","pages":[{"title":"Documentation","href":"/documentation/onboarding"}]},{"tab":"API reference","groups":[{"group":"API Reference","icon":"history","pages":[{"title":"API Reference","sidebarTitle":"Introduction","icon":"code","href":"/api-reference/introduction"},{"title":"Authentication","icon":"lock","href":"/api-reference/authentication"},{"title":"Error Codes","icon":"radiation","href":"/api-reference/error-codes"}]},{"group":" ISO20022 Compliance","icon":"wallet","pages":[{"title":"Endpoint Mapping","icon":"map","href":"/api-reference/iso20022/endpoint-mapping"}]},{"group":"Wallets and Balances","icon":"wallet","pages":[{"title":"Get All Balances","openapi":"GET /partners/balances","href":"/api-reference/hyperrail-wallet/get"},{"title":"Get Balance By ID","openapi":"GET /partners/balances/{accountId}","href":"/api-reference/hyperrail-wallet/get-balance-id"},{"title":"Get Balance By Currency","openapi":"GET /partners/balances/currency/{currency}","href":"/api-reference/hyperrail-wallet/get-balance-currency"},{"title":"Get Main Stablecoin balance","openapi":"GET /wallets/main/balances","href":"/api-reference/hyperrail-wallet/get-stablecoin-balance"}]},{"group":"Rates","icon":"arrow-up-right-dots","pages":[{"title":"Get Rate","openapi":"GET /partners/rates","href":"/api-reference/rate/get-rate"},{"title":"Get Rate Stream","openapi":"GET /partners/marketplace/rates/stream","href":"/api-reference/rate/rate-stream"}]},{"group":"Exchange","icon":"money-bill","pages":[{"title":"Create Instant Trade","openapi":"POST /partners/marketplace/express/quote","href":"/api-reference/hyperrail-quote/create-express-quote"},{"title":"Create Payment Intent","openapi":"POST /partners/marketplace/intent","href":"/api-reference/hyperrail-quote/create-payment-intent"},{"title":"Accept Quote","openapi":"PUT /partners/marketplace/quote/{id}/accept","href":"/api-reference/hyperrail-quote/accept-quote"},{"title":"Get Mobile Money Currencies","openapi":"GET /partners/marketplace/mobile-money/currencies","href":"/api-reference/hyperrail-quote/get-mmo-currencies"},{"title":"Get Mobile Money Providers","openapi":"GET /partners/marketplace/mobile-money/providers","href":"/api-reference/hyperrail-quote/get-mmo-providers"},{"title":"Get Trade Payment Status","openapi":"GET /partners/marketplace/quote/{id}/payment/status","href":"/api-reference/hyperrail-quote/get-order-status"},{"title":"Get Quote By ID","openapi":"GET /partners/marketplace/quote/{id}","href":"/api-reference/hyperrail-quote/get-quote-id"},{"title":"Complete a Quote By its ID","openapi":"PUT /partners/marketplace/quote/{id}/complete","href":"/api-reference/hyperrail-quote/get-complete-quote-id"},{"title":"Authorize Quote Payment","openapi":"PUT /partners/marketplace/quote/{id}/payment/authorize","href":"/api-reference/hyperrail-quote/authorize-quote-payment"},{"title":"Edit Quote","openapi":"PUT /partners/marketplace/quote/{id}/add","href":"/api-reference/hyperrail-quote/edit-quote"},{"title":"Cancel Quote","openapi":"PUT /partners/marketplace/quote/{id}/cancel","href":"/api-reference/hyperrail-quote/cancel-quote"},{"title":"Remove Quote Item","openapi":"PUT /partners/marketplace/quote/{id}/remove/{itemId}","description":"Removes a specific allocation or item from an existing quote session using the quote ID and item ID.","href":"/api-reference/hyperrail-quote/delete-quote-item"}]},{"group":"Payout","icon":"money-bill","pages":[{"title":"Create Fiat Payout","openapi":"POST /partners/payouts","href":"/api-reference/payout/withdrawal"},{"title":"Create Wallet Payout","openapi":"POST /partners/wallets/payouts","description":"Processes a withdrawal request from a partner wallet to an on-chain blockchain address. Supports USDC, USDT withdrawals on Ethereum, Polygon, and Base networks.","href":"/api-reference/payout/wallet-payout"},{"title":"Get Payout Status","openapi":"GET /partners/payouts/{reference}","href":"/api-reference/payout/payout-status"},{"title":"Get All Banks","openapi":"GET /transfers/banks/{currency}","href":"/api-reference/payout/list-banks"},{"title":"Resolve Bank Account","openapi":"GET /transfers/resolve-account","href":"/api-reference/payout/resolve-account"}]},{"group":"Dynamic Accounts","icon":"vault","pages":[{"openapi":"POST /accounts","title":"Create Dynamic Virtual Account","href":"/api-reference/dynamic-accounts/create-dynamic-account"},{"openapi":"GET /accounts/{id}","title":"Get Dynamic Virtual Account by ID","href":"/api-reference/dynamic-accounts/dynamic-account-id"},{"openapi":"GET /accounts","title":"Get All Dynamic Virtual Accounts","href":"/api-reference/dynamic-accounts/list-dynamic-account"}]},{"group":"Marketplace","pages":[{"title":"Exchange Clients List","openapi":"GET /partners/marketplace/listings","href":"/api-reference/listings/liquidity-providers"}]}]}]},"basePath":"","title":"Create Fiat Payout - Hyperrails - Documentation","buildId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","deploymentId":"dpl_8LJbrAiZvr1K98WQNZXCyY5AvT34","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-i2a3QZ8E.js","utils-ChLwp8m0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DRktVTDc.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CA2pEs4T.js","snippetPresets-ClQ6XrKD.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Ct_Lv36y.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-Cn2PYw9e.js","shallow-rkyymjXQ.js","getApiPlaygroundDisplay-BB9vkXtE.js","CodeSnippet-Bm5RU7m1.js","CodeSnippets-BgU9Deuz.js","Page-BUDYNlhG.js","getPastedJson-BD-6NNum.js","icon-8Z6tud2e.js","MethodPill-Tuzr4g3V.js","DuplicateIcon-0ceWFYhN.js","createIcon-FBXow_ST.js","DynamicMarkdown-CD8713Yy.js","SectionHeading-7zgzQbH-.js","axios-vUo_bRtp.js","Markdown-D7Ofw1oz.js","clsx-eKJ4rcii.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CwjSCXIK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-9EK5IAXV.js"]}