Debits the calling organisation’s own currency wallet. The request is created as Pending and the tokens are moved into escrow; it still needs to be approved before funds are disbursed. A withdrawal.created webhook is emitted.
Fees
The fee is taken out of the amount you request, not added on top. You ask to withdraw
₦5,000, the fee is ₦500, and ₦4,500 reaches the bank account.disburse_amount = amount − fee
Currency
Fee
NGN
₦500 flat, per withdrawal, regardless of amount
Each supported currency has its own flat fee. Fees change without an API version bump, so treat
the fee field on the response as authoritative for a given withdrawal rather than hard-coding a
figure — and if you show the user a net amount before they confirm, derive it from
disburse_amount on the response rather than computing it yourself.
Because the fee comes out of the amount, a withdrawal for less than the fee is rejected rather
than disbursing nothing — see Insufficient amount for fees below. A request for exactly the
fee is also rejected: disburse_amount would be zero.
Wallet balance < amount (checked before anything else).
400
Cannot withdraw less than 1000 NGN
Below MINIMUM_WITHDRAWAL_<CUR>.
400
child "Currency" fails because ["Currency" must be one of [NGN, KES, GHS, ZAR, UGX, TZS]]
Unsupported/invalid currency.
400
Withdrawals with automatic bank resolution are not supported for USD. Supported currencies: NGN, GHS, KES, ZAR, UGX, TZS.
Currency has no Flutterwave bank list.
404
Could not find a bank matching "Acess Bank" for NGN. Please check the bank name and try again.
bank_name didn’t match Flutterwave’s list.
412
Insufficient amount for fees
amount ≤ the withdrawal fee, so disburse_amount would be zero or negative. The response data carries the fee that was applied.
502
Could not fetch the bank list from our payment provider. Please try again later.
Flutterwave banks call failed.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"GetEquity","colors":{"primary":"#3d70fd","light":"#0d70fd","dark":"#3d70fd"},"logo":{"light":"https://mintcdn.com/getequity-9353cd69/vgtVmrBA2jLoPm-V/logo/Light-001.png?fit=max\u0026auto=format\u0026n=vgtVmrBA2jLoPm-V\u0026q=85\u0026s=515177515afb51f52b712858383b6be7","dark":"https://mintcdn.com/getequity-9353cd69/vgtVmrBA2jLoPm-V/logo/Light-001.png?fit=max\u0026auto=format\u0026n=vgtVmrBA2jLoPm-V\u0026q=85\u0026s=515177515afb51f52b712858383b6be7"},"favicon":"https://mintcdn.com/getequity-9353cd69/vgtVmrBA2jLoPm-V/favicon.png?fit=max\u0026auto=format\u0026n=vgtVmrBA2jLoPm-V\u0026q=85\u0026s=3246cacbdc90efd5ddb5dcf35616880c","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://ge-exchange-staging-1.herokuapp.com/v1/"}},"navbar":{"links":[{"href":"https://business.getequity.io/onboarding/signin","label":"Login"}],"primary":{"type":"button","label":"Create an account","href":"https://business.getequity.io/onboarding/data-collection/api-client"}},"footer":{"socials":{"twitter":"https://twitter.com/getequity","facebook":"https://www.facebook.com/getequityHQ?_rdc=1\u0026_rdr","linkedin":"https://www.linkedin.com/company/getequity","instagram":"https://www.instagram.com/getequity_hq"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"getequity-9353cd69","hasAudioNarration":false,"actualSubdomain":"getequity-9353cd69","customDomains":["getequity.io"],"gitSource":{"type":"github","owner":"getequity","repo":"api-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{},"buildId":"6afb7d6b143af715e14c5944","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Reference","count":82},{"language":"default","tag":"Investments API · Direct","count":34},{"language":"default","tag":"Investments API · Managed","count":17},{"language":"default","tag":"Webhook","count":17},{"language":"default","tag":"Members","count":16},{"language":"default","tag":"Events","count":16},{"language":"default","tag":"Trade","count":15},{"language":"default","tag":"On-Chain","count":14},{"language":"default","tag":"Credit API","count":12},{"language":"default","tag":"Wallet","count":6}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"api-reference/endpoint/Wallet/withdraw","slug":"/api-reference/endpoint/Wallet/withdraw","pageMetadata":{"title":"Withdraw from wallet","api":"POST api/wallet/withdraw","description":"Debit the calling organisation's own currency wallet to a bank account","href":"/api-reference/endpoint/Wallet/withdraw"},"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: \"Debit the calling organisation’s own currency wallet to a 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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Heading,ParamField,Table,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Debits the calling organisation’s own currency wallet. The request is created as `,_jsx(_components.code,{children:`Pending`}),` and the tokens are moved into escrow; it still needs to be approved before funds are disbursed. A `,_jsx(_components.code,{children:`withdrawal.created`}),` webhook is emitted.`]}),`\n`,_jsx(Heading,{level:`2`,id:`fees`,children:`Fees`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The fee is taken out of the amount you request, not added on top.`}),` You ask to withdraw\n₦5,000, the fee is ₦500, and ₦4,500 reaches the bank account.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`disburse_amount`}),` = `,_jsx(_components.code,{children:`amount`}),` − `,_jsx(_components.code,{children:`fee`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Currency`}),_jsx(_components.th,{children:`Fee`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`NGN`}),_jsx(_components.td,{children:`₦500 flat, per withdrawal, regardless of amount`})]})})]}),`\n`,_jsxs(_components.p,{children:[`Each supported currency has its own flat fee. Fees change without an API version bump, so treat\nthe `,_jsx(_components.code,{children:`fee`}),` field on the response as authoritative for a given withdrawal rather than hard-coding a\nfigure — and if you show the user a net amount before they confirm, derive it from\n`,_jsx(_components.code,{children:`disburse_amount`}),` on the response rather than computing it yourself.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Because the fee comes out of the amount, a withdrawal for less than the fee is rejected rather\nthan disbursing nothing — see `,_jsx(_components.code,{children:`Insufficient amount for fees`}),` below. A request for exactly the\nfee is also rejected: `,_jsx(_components.code,{children:`disburse_amount`}),` would be zero.`]})}),`\n`,`\n`,_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsxs(_components.p,{children:[`The amount to withdraw. Must be ≥ 1, ≤ your currency wallet balance, and ≥ `,_jsx(_components.code,{children:`MINIMUM_WITHDRAWAL_\u003cCUR>`}),`.`]})}),`\n`,_jsx(ParamField,{body:`bank_name`,type:`string`,required:true,id:`param-bank-name`,children:_jsxs(_components.p,{children:[`Matched against Flutterwave’s bank list to resolve the code — pass the full name (e.g. `,_jsx(_components.code,{children:`Guaranty Trust Bank`}),`, not `,_jsx(_components.code,{children:`GTBank`}),`).`]})}),`\n`,_jsx(ParamField,{body:`account_name`,type:`string`,required:true,id:`param-account-name`,children:_jsx(_components.p,{children:`The account holder’s name. For NGN it is replaced with Flutterwave’s resolved name when available.`})}),`\n`,_jsx(ParamField,{body:`account_number`,type:`string`,required:true,id:`param-account-number`,children:_jsx(_components.p,{children:`The destination account number.`})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsxs(_components.p,{children:[`The withdrawal currency. One of `,_jsx(_components.code,{children:`NGN`}),`, `,_jsx(_components.code,{children:`KES`}),`, `,_jsx(_components.code,{children:`GHS`}),`, `,_jsx(_components.code,{children:`ZAR`}),`, `,_jsx(_components.code,{children:`UGX`}),`, `,_jsx(_components.code,{children:`TZS`}),`.`]})}),`\n`,`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Message (example)`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Insufficient NGN balance. Available: 1200, requested: 5000.`})}),_jsx(_components.td,{children:`Wallet balance \u003c amount (checked before anything else).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Cannot withdraw less than 1000 NGN`})}),_jsxs(_components.td,{children:[`Below `,_jsx(_components.code,{children:`MINIMUM_WITHDRAWAL_\u003cCUR>`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`child \"Currency\" fails because [\"Currency\" must be one of [NGN, KES, GHS, ZAR, UGX, TZS]]`})}),_jsx(_components.td,{children:`Unsupported/invalid currency.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Withdrawals with automatic bank resolution are not supported for USD. Supported currencies: NGN, GHS, KES, ZAR, UGX, TZS.`})}),_jsx(_components.td,{children:`Currency has no Flutterwave bank list.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Could not find a bank matching \"Acess Bank\" for NGN. Please check the bank name and try again.`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`bank_name`}),` didn’t match Flutterwave’s list.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`412`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Insufficient amount for fees`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`amount`}),` ≤ the withdrawal fee, so `,_jsx(_components.code,{children:`disburse_amount`}),` would be zero or negative. The response `,_jsx(_components.code,{children:`data`}),` carries the `,_jsx(_components.code,{children:`fee`}),` that was applied.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Could not fetch the bank list from our payment provider. Please try again later.`})}),_jsx(_components.td,{children:`Flutterwave banks call failed.`})]})]})]})]})}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":{"title":"Withdraw from wallet","api":"POST api/wallet/withdraw","description":"Debit the calling organisation's own currency wallet to a bank account","href":"/api-reference/endpoint/Wallet/withdraw"}}},"mdxSourceWithNoJs":{"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`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,Heading,ParamField,RequestExample,ResponseExample,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Debits the calling organisation’s own currency wallet. The request is created as `,_jsx(_components.code,{children:`Pending`}),` and the tokens are moved into escrow; it still needs to be approved before funds are disbursed. A `,_jsx(_components.code,{children:`withdrawal.created`}),` webhook is emitted.`]}),`\n`,_jsx(Heading,{level:`2`,id:`fees`,children:`Fees`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`The fee is taken out of the amount you request, not added on top.`}),` You ask to withdraw\n₦5,000, the fee is ₦500, and ₦4,500 reaches the bank account.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`disburse_amount`}),` = `,_jsx(_components.code,{children:`amount`}),` − `,_jsx(_components.code,{children:`fee`})]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Currency`}),_jsx(_components.th,{children:`Fee`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`NGN`}),_jsx(_components.td,{children:`₦500 flat, per withdrawal, regardless of amount`})]})})]}),`\n`,_jsxs(_components.p,{children:[`Each supported currency has its own flat fee. Fees change without an API version bump, so treat\nthe `,_jsx(_components.code,{children:`fee`}),` field on the response as authoritative for a given withdrawal rather than hard-coding a\nfigure — and if you show the user a net amount before they confirm, derive it from\n`,_jsx(_components.code,{children:`disburse_amount`}),` on the response rather than computing it yourself.`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Because the fee comes out of the amount, a withdrawal for less than the fee is rejected rather\nthan disbursing nothing — see `,_jsx(_components.code,{children:`Insufficient amount for fees`}),` below. A request for exactly the\nfee is also rejected: `,_jsx(_components.code,{children:`disburse_amount`}),` would be zero.`]})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:``,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bank_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Access Bank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"John Doe\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0690000004\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NGN\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(ParamField,{body:`amount`,type:`number`,required:true,id:`param-amount`,children:_jsxs(_components.p,{children:[`The amount to withdraw. Must be ≥ 1, ≤ your currency wallet balance, and ≥ `,_jsx(_components.code,{children:`MINIMUM_WITHDRAWAL_\u003cCUR>`}),`.`]})}),`\n`,_jsx(ParamField,{body:`bank_name`,type:`string`,required:true,id:`param-bank-name`,children:_jsxs(_components.p,{children:[`Matched against Flutterwave’s bank list to resolve the code — pass the full name (e.g. `,_jsx(_components.code,{children:`Guaranty Trust Bank`}),`, not `,_jsx(_components.code,{children:`GTBank`}),`).`]})}),`\n`,_jsx(ParamField,{body:`account_name`,type:`string`,required:true,id:`param-account-name`,children:_jsx(_components.p,{children:`The account holder’s name. For NGN it is replaced with Flutterwave’s resolved name when available.`})}),`\n`,_jsx(ParamField,{body:`account_number`,type:`string`,required:true,id:`param-account-number`,children:_jsx(_components.p,{children:`The destination account number.`})}),`\n`,_jsx(ParamField,{body:`currency`,type:`string`,required:true,id:`param-currency`,children:_jsxs(_components.p,{children:[`The withdrawal currency. One of `,_jsx(_components.code,{children:`NGN`}),`, `,_jsx(_components.code,{children:`KES`}),`, `,_jsx(_components.code,{children:`GHS`}),`, `,_jsx(_components.code,{children:`ZAR`}),`, `,_jsx(_components.code,{children:`UGX`}),`, `,_jsx(_components.code,{children:`TZS`}),`.`]})}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:``,numberOfLines:`32`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`32`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"success\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Withdrawal request created successfully.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"withdrawalRequest\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"665f0c2e9a1b2c0012ab34cd\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"owner\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"64a1f0b39a1b2c0012aa11bb\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"owner_model\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"organisation\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GETXN_PAYOUT_8F3KD9ZQ2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"disburse_amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4500`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`500`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"gusd_amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"internal_fee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"internal_fee_type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NONE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NGN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"665f0c2e9a1b2c0012ab3400\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Pending\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"actioned_on\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-04T10:15:42.001Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"updatedAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-07-04T10:15:42.001Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"bank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"665f0c2e9a1b2c0012ab3400\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Access Bank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"044\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_number\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0690000004\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"account_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"JOHN DOE\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NGN\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Insufficient balance — 400`,numberOfLines:`4`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`4`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"failed\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Insufficient NGN balance. Available: 1200, requested: 5000.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`HTTP`}),_jsx(_components.th,{children:`Message (example)`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Insufficient NGN balance. Available: 1200, requested: 5000.`})}),_jsx(_components.td,{children:`Wallet balance \u003c amount (checked before anything else).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Cannot withdraw less than 1000 NGN`})}),_jsxs(_components.td,{children:[`Below `,_jsx(_components.code,{children:`MINIMUM_WITHDRAWAL_\u003cCUR>`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`child \"Currency\" fails because [\"Currency\" must be one of [NGN, KES, GHS, ZAR, UGX, TZS]]`})}),_jsx(_components.td,{children:`Unsupported/invalid currency.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`400`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Withdrawals with automatic bank resolution are not supported for USD. Supported currencies: NGN, GHS, KES, ZAR, UGX, TZS.`})}),_jsx(_components.td,{children:`Currency has no Flutterwave bank list.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`404`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Could not find a bank matching \"Acess Bank\" for NGN. Please check the bank name and try again.`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`bank_name`}),` didn’t match Flutterwave’s list.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`412`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Insufficient amount for fees`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`amount`}),` ≤ the withdrawal fee, so `,_jsx(_components.code,{children:`disburse_amount`}),` would be zero or negative. The response `,_jsx(_components.code,{children:`data`}),` carries the `,_jsx(_components.code,{children:`fee`}),` that was applied.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:`502`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`Could not fetch the bank list from our payment provider. Please try again later.`})}),_jsx(_components.td,{children:`Flutterwave banks call failed.`})]})]})]})]})}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":{"title":"Withdraw from wallet","api":"POST api/wallet/withdraw","description":"Debit the calling organisation's own currency wallet to a bank account","href":"/api-reference/endpoint/Wallet/withdraw"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Fees","slug":"fees","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">5000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"bank_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Access Bank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"account_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"John Doe\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"account_number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0690000004\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"NGN\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"32\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"success\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Withdrawal request created successfully.\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"withdrawalRequest\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"665f0c2e9a1b2c0012ab34cd\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"owner\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"64a1f0b39a1b2c0012aa11bb\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"owner_model\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"organisation\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"reference\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"GETXN_PAYOUT_8F3KD9ZQ2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">5000\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"disburse_amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">4500\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"fee\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">500\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"gusd_amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"internal_fee\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"internal_fee_type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"NONE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"NGN\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"bank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"665f0c2e9a1b2c0012ab3400\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Pending\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"actioned_on\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"createdAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-07-04T10:15:42.001Z\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"updatedAt\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"2026-07-04T10:15:42.001Z\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"bank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"665f0c2e9a1b2c0012ab3400\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Access Bank\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"044\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"account_number\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"0690000004\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"account_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"JOHN DOE\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"currency\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"NGN\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Insufficient balance — 400","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"4\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"failed\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Insufficient NGN balance. Available: 1200, requested: 5000.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Withdraw from wallet","path":"api/wallet/withdraw","servers":[{"url":"https://ge-exchange-staging-1.herokuapp.com/v1/"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"amount":[{"type":"number","description":"The amount to withdraw. Must be ≥ 1, ≤ your currency wallet balance, and ≥ `MINIMUM_WITHDRAWAL_\u003cCUR>` .","required":true}],"bank_name":[{"type":"string","description":"Matched against Flutterwave’s bank list to resolve the code — pass the full name (e.g. `Guaranty Trust Bank` , not `GTBank` ).","required":true}],"account_name":[{"type":"string","description":"The account holder’s name. For NGN it is replaced with Flutterwave’s resolved name when available.","required":true}],"account_number":[{"type":"string","description":"The destination account number.","required":true}],"currency":[{"type":"string","description":"The withdrawal currency. One of `NGN` , `KES` , `GHS` , `ZAR` , `UGX` , `TZS` .","required":true}]}}],"examples":{"example":{"value":{"amount":123,"bank_name":"\u003cstring>","account_name":"\u003cstring>","account_number":"\u003cstring>","currency":"\u003cstring>"}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"subdomain":"getequity-9353cd69","siteName":"GetEquity","title":"Withdraw from wallet - GetEquity","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T13:00:49.674Z","originalFileLocation":"api-reference/endpoint/Wallet/withdraw.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=\"system\"}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=\"Debit the calling organisation\u0026#x27;s own currency wallet to a bank account\">\u003cmeta data-mint-head name=\"application-name\" content=\"GetEquity\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_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=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Withdraw from wallet - GetEquity\">\u003cmeta data-mint-head property=\"og:description\" content=\"Debit the calling organisation\u0026#x27;s own currency wallet to a bank account\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GetEquity\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://getequity-9353cd69.mintlify.site/docs/_mintlify/api/og/v2?division=Wallet\u0026amp;title=Withdraw+from+wallet\u0026amp;description=Debit+the+calling+organisation%27s+own+currency+wallet+to+a+bank+account\u0026amp;theme=731223df73a14642bc06da65\u0026amp;signature=8004c0bfe3fcc883593d22160cfe10f60b8c0159e5e1bc5483b702119a9c36f2\">\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=\"Withdraw from wallet - GetEquity\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Debit the calling organisation\u0026#x27;s own currency wallet to a bank account\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://getequity-9353cd69.mintlify.site/docs/_mintlify/api/og/v2?division=Wallet\u0026amp;title=Withdraw+from+wallet\u0026amp;description=Debit+the+calling+organisation%27s+own+currency+wallet+to+a+bank+account\u0026amp;theme=731223df73a14642bc06da65\u0026amp;signature=8004c0bfe3fcc883593d22160cfe10f60b8c0159e5e1bc5483b702119a9c36f2\">\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=\"/docs/mintlify-assets/_mintlify/favicons/getequity-9353cd69/FVKdWr089E4fvxo8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GetEquity\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3d70fd\">\u003clink data-mint-head rel=\"canonical\" href=\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/endpoint/Wallet/withdraw.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://getequity.io/#organization\",\"name\":\"GetEquity\",\"url\":\"https://getequity.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/getequity-9353cd69/vgtVmrBA2jLoPm-V/logo/Light-001.png?fit=max\u0026auto=format\u0026n=vgtVmrBA2jLoPm-V\u0026q=85\u0026s=515177515afb51f52b712858383b6be7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://getequity.io/docs#website\",\"name\":\"GetEquity\",\"url\":\"https://getequity.io/docs\",\"publisher\":{\"@id\":\"https://getequity.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw#webpage\",\"url\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw\",\"name\":\"Withdraw from wallet\",\"description\":\"Debit the calling organisation's own currency wallet to a bank account\",\"dateModified\":\"2026-11-16T13:00:49.674Z\",\"isPartOf\":{\"@id\":\"https://getequity.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Investments API · Direct\",\"item\":\"https://getequity.io/docs/api-reference/investments/direct\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Wallet\",\"item\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/wallet\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Withdraw from wallet\",\"item\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw#apireference\",\"headline\":\"Withdraw from wallet\",\"name\":\"Withdraw from wallet\",\"description\":\"Debit the calling organisation's own currency wallet to a bank account\",\"url\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw\",\"mainEntityOfPage\":{\"@id\":\"https://getequity.io/docs/api-reference/endpoint/Wallet/withdraw#webpage\"},\"dateModified\":\"2026-11-16T13:00:49.674Z\",\"publisher\":{\"@id\":\"https://getequity.io/#organization\"},\"isPartOf\":{\"@id\":\"https://getequity.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GetEquity\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"GetEquity\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/endpoint/Wallet/withdraw.md","siteName":"GetEquity","nav":{"global":null,"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Choosing your integration","href":"/api-reference/choosing-your-integration"}]},{"group":"Investments API · Direct","pages":[{"title":"Direct model","href":"/api-reference/investments/direct"},{"group":"Trade","pages":[{"title":"Overview","href":"/api-reference/endpoint/Trade/trade"},{"title":"Fetch All Active Tokens","api":"GET api/tokens?closed=false\u0026exited=false","href":"/api-reference/endpoint/Trade/get-tokens"},{"title":"Fetch Raising Tokens","api":"GET api/tokens/raising","href":"/api-reference/endpoint/Trade/get-raising-tokens"},{"title":"Buy token","api":"POST api/token/{id}/buy","href":"/api-reference/endpoint/Trade/buy-token"},{"title":"Fund and Buy","api":"POST api/token/{id}/fund-buy","tag":"NEW","href":"/api-reference/endpoint/Trade/fund-buy"},{"title":"Sell token","api":"POST api/token/{id}/sell","href":"/api-reference/endpoint/Trade/sell-token"},{"title":"Get Asset","api":"GET api/asset/{id}","href":"/api-reference/endpoint/Trade/get-asset"},{"title":"Get Token","api":"GET api/token/{tokenId}","href":"/api-reference/endpoint/Trade/get-token"},{"title":"Token Historicals","api":"GET api/token/{id}/ohlvc","tag":"NEW","href":"/api-reference/endpoint/Trade/token-historicals"},{"title":"Search Token","api":"GET api/token/search","href":"/api-reference/endpoint/Trade/search-token"},{"title":"Bid into an offering","api":"POST api/token/{id}/commit","href":"/api-reference/endpoint/Trade/commit-to-offering"},{"title":"Fetch the order book","api":"GET api/token/{id}/book","href":"/api-reference/endpoint/Trade/offering-book"},{"title":"Amend a bid","api":"PATCH api/commitment/{commitmentId}","href":"/api-reference/endpoint/Trade/amend-commitment"},{"title":"Withdraw a bid","api":"DELETE api/commitment/{commitmentId}","href":"/api-reference/endpoint/Trade/withdraw-commitment"},{"title":"List your bids","api":"GET api/commitments","href":"/api-reference/endpoint/Trade/list-commitments"}]},{"group":"Customers","pages":[{"title":"Overview","href":"/api-reference/endpoint/Customers/customers"},{"title":"Fetch All Customers","api":"GET api/customers","href":"/api-reference/endpoint/Customers/get-customers"},{"title":"Search For a Customer","api":"GET api/customers/search","href":"/api-reference/endpoint/Customers/search-customers"}]},{"group":"Orders","pages":[{"title":"Overview","href":"/api-reference/endpoint/Orders/orders"},{"title":"Fetch Active Buy Orders","api":"GET api/orders/token/{id}?type=buy\u0026status=Active","href":"/api-reference/endpoint/Orders/get-buy-orders"},{"title":"Fetch Active Sell Orders","api":"GET api/orders/token/{id}?type=sell\u0026status=Active","href":"/api-reference/endpoint/Orders/get-sell-orders"},{"title":"Fetch an Order","api":"GET api/orders/{orderId}","href":"/api-reference/endpoint/Orders/get-order"},{"title":"Cancel an Order","api":"POST api/orders/{orderId}/cancel","tag":"NEW","href":"/api-reference/endpoint/Orders/cancel-order"}]},{"group":"Transactions","pages":[{"title":"Overview","href":"/api-reference/endpoint/Transactions/transactions"},{"title":"Fetch a transaction / verify a payment","api":"GET api/transactions/{reference}","tag":"NEW","href":"/api-reference/endpoint/Transactions/get-transaction"},{"title":"Fetch Customer Transactions","api":"GET api/customers/transactions","href":"/api-reference/endpoint/Transactions/get-customer-transactions"},{"title":"Fetch Total Transaction Volume","api":"GET api/transactions/volume","href":"/api-reference/endpoint/Transactions/get-total-transaction-volume"}]},{"group":"Wallet","pages":[{"title":"Overview","href":"/api-reference/endpoint/Wallet/wallet"},{"title":"Fund wallet","api":"POST api/wallet/fund","description":"Initiate a payment to fund your wallet","href":"/api-reference/endpoint/Wallet/fund-wallet"},{"title":"Withdraw from wallet","api":"POST api/wallet/withdraw","href":"/api-reference/endpoint/Wallet/withdraw"},{"title":"Get All Currencies Wallet Balance","api":"GET api/token/currencies/balance","description":"This endpoint is used to retrieve the balance and value of different currencies.","href":"/api-reference/endpoint/Wallet/get-currencies-balance"},{"title":"Fetch Wallet Balance","api":"GET api/token/{symbol}/balance","href":"/api-reference/endpoint/Wallet/get-wallet-balance"},{"title":"Refresh Wallet Balance","api":"GET api/wallet/refresh","href":"/api-reference/endpoint/Wallet/refresh-wallet-balance"}]}]},{"group":"Investments API · Managed","pages":[{"title":"Managed model","href":"/api-reference/investments/managed"},{"group":"Members","pages":[{"title":"Overview","href":"/api-reference/endpoint/Members/members"},{"title":"Create Member","api":"POST api/member","href":"/api-reference/endpoint/Members/create-member"},{"title":"Get Members","api":"GET api/member","href":"/api-reference/endpoint/Members/get-members"},{"title":"Get member by email","api":"GET api/member?email={email}","tag":"NEW","href":"/api-reference/endpoint/Members/get-member-by-email"},{"title":"Get member balance","api":"GET api/members/{id}/balance","href":"/api-reference/endpoint/Members/member-currency-balance"},{"title":"Get Member token balance","api":"GET api/members/{id}/tokens","href":"/api-reference/endpoint/Members/member-token-balance"},{"title":"Get Member transactions","api":"GET api/members/{id}/transactions","href":"/api-reference/endpoint/Members/member-transactions"},{"title":"Get member orders","api":"GET api/members/{id}/orders","href":"/api-reference/endpoint/Members/member-orders"},{"title":"Buy token as member","api":"POST api/members/{id}/token/{tokenId}/buy","href":"/api-reference/endpoint/Members/buy-token"},{"title":"Fund and Invest","api":"POST api/members/{id}/token/{tokenId}/fund-invest","href":"/api-reference/endpoint/Members/fund-invest"},{"title":"Get Fund and Invest Quote","api":"POST api/members/{id}/token/{tokenId}/fund-invest/quote","href":"/api-reference/endpoint/Members/fund-invest-quote"},{"title":"Sell token as member","api":"POST api/members/{id}/token/{tokenID}/sell","href":"/api-reference/endpoint/Members/sell-token"},{"title":"Fund member wallet","api":"POST api/members/{id}/wallet/fund","href":"/api-reference/endpoint/Members/fund-member-wallet"},{"title":"Withdraw from member wallet","api":"POST api/members/{id}/wallet/withdraw","href":"/api-reference/endpoint/Members/withdraw-member-wallet"},{"title":"Cancel a member order","api":"POST api/members/{id}/orders/{orderId}/cancel","tag":"NEW","href":"/api-reference/endpoint/Members/cancel-member-order"},{"title":"Bid into an offering for a member","api":"POST api/members/{id}/token/{tokenId}/commit","href":"/api-reference/endpoint/Members/member-commit-to-offering"},{"title":"Member amend commitment","href":"/api-reference/endpoint/Members/member-amend-commitment"},{"title":"Member withdraw commitment","href":"/api-reference/endpoint/Members/member-withdraw-commitment"},{"title":"Member list commitments","href":"/api-reference/endpoint/Members/member-list-commitments"}]}]},{"group":"Credit API","pages":[{"title":"Overview","href":"/api-reference/endpoint/CreditLoan/credit-loan"},{"title":"Get Loan Configuration","api":"GET api/credit/loan-configuration","href":"/api-reference/endpoint/CreditLoan/get-loan-configuration"},{"title":"Get User by ID","api":"POST api/user/safe/{userId}","href":"/api-reference/endpoint/CreditLoan/get-user-by-id"},{"title":"Get User Investments","api":"POST api/credit/user/portfolio/{userId}","href":"/api-reference/endpoint/CreditLoan/get-user-investments"},{"title":"Create Loan","api":"POST api/credit/loan","href":"/api-reference/endpoint/CreditLoan/create-loan"},{"title":"Get Loans By Creditor","api":"GET api/creditor/credit/loans","href":"/api-reference/endpoint/CreditLoan/get-creditor-loans"},{"title":"Get Loan By ID","api":"GET api/credit/loan/{loanId}","href":"/api-reference/endpoint/CreditLoan/get-loan-by-id"},{"title":"Repay Loan","api":"PUT api/borrower/credit/loan/{loanId}/repay","href":"/api-reference/endpoint/CreditLoan/repay-loan"},{"title":"Get Liquidation Quote","api":"GET api/creditor/credit/loan/{loanId}/liquidation","href":"/api-reference/endpoint/CreditLoan/get-liquidation-quote"},{"title":"Liquidate Loan","api":"POST api/creditor/credit/loan/{loanId}/liquidate","href":"/api-reference/endpoint/CreditLoan/liquidate-loan"},{"title":"Get Price Alerts","api":"GET api/credit/price-alerts","href":"/api-reference/endpoint/CreditLoan/get-price-alerts"},{"title":"Update Price Alerts","api":"PUT api/credit/price-alerts","href":"/api-reference/endpoint/CreditLoan/update-price-alerts"}]},{"group":"Webhook","pages":[{"title":"Overview","href":"/api-reference/endpoint/Webhook/webhook"},{"group":"Events","pages":[{"title":"member.created","href":"/api-reference/endpoint/Webhook/member-created"},{"title":"order.created","href":"/api-reference/endpoint/Webhook/order-created"},{"title":"order.cancelled","href":"/api-reference/endpoint/Webhook/order-cancelled"},{"title":"transaction.created","href":"/api-reference/endpoint/Webhook/transaction-created"},{"title":"wallet.funded","href":"/api-reference/endpoint/Webhook/wallet-funded"},{"title":"listing.created","href":"/api-reference/endpoint/Webhook/listing-created"},{"title":"token.transferred","href":"/api-reference/endpoint/Webhook/token-transferred"},{"title":"withdrawal.created","href":"/api-reference/endpoint/Webhook/withdrawal-created"},{"title":"withdrawal.approved","href":"/api-reference/endpoint/Webhook/withdrawal-approved"},{"title":"loan.created","href":"/api-reference/endpoint/Webhook/loan-created"},{"title":"loan.repaid","href":"/api-reference/endpoint/Webhook/loan-repaid"},{"title":"loan.liquidated","href":"/api-reference/endpoint/Webhook/loan-liquidated"},{"title":"token.price_changed","href":"/api-reference/endpoint/Webhook/token-price-changed"},{"title":"esop.transferred","href":"/api-reference/endpoint/Webhook/esop-transferred"},{"title":"token.gifted","href":"/api-reference/endpoint/Webhook/token-gifted"},{"title":"token.gift.accepted","href":"/api-reference/endpoint/Webhook/token-gift-accepted"}]}]}]},{"anchor":"On-Chain","icon":"link","pages":[{"title":"On-Chain","href":"/onchain/introduction"}]},{"anchor":"Change Log","icon":"clock","pages":[{"title":"Change Log","href":"/change-log/change-log"}]},{"anchor":"Blog","icon":"newspaper","href":"https://www.getequity.io/blog"},{"anchor":"FAQs","icon":"question","href":"https://www.getequity.io/faq/"},{"anchor":"Support","icon":"envelope","href":"mailto:support@getequity.io"}]},"basePath":"","title":"Withdraw from wallet - GetEquity","deploymentId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","buildId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DyP0AOE1.js","snippetPresets-CuYPAUIG.js","utils-ez5j6NBT.js","style-to-object-BY3JEAdk.js","utils-DG4aeUOF.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DFhcMUrP.js","conditional-requirements-CFM0id0Q.js","cloneDeep-ByDTqllG.js","_Uint8Array-CJ2WjX_H.js","isObject-FP1Yky1u.js","ApiExamples-fyn9sMD9.js","usePlaygroundInputsStore-Bf0N_Y6L.js","shallow-CnU26VTn.js","isEqual-OWIKZzop.js","CodeSnippets-CZ9-M31v.js","CodeSnippet-CCk6UVRR.js","getApiPlaygroundDisplay-BUw5JwZB.js","Page-CInwEL5w.js","DynamicMarkdown-CU5QIokU.js","SectionHeading-BoT1NwPU.js","icon-MsvNhD56.js","MethodPill-CC7p0-fp.js","getPastedJson-BOWYR2ND.js","DuplicateIcon-DOWJyC1b.js","createIcon-BsNyCaLY.js","axios-CsQoIw0U.js"]}