Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mavapay","colors":{"primary":"#F2B246","light":"#07C983","dark":"#F2B246"},"logo":{"light":"https://mintcdn.com/mavapay/IhO63U3k6cpz2yeG/logo/mavapay-logo.png?fit=max\u0026auto=format\u0026n=IhO63U3k6cpz2yeG\u0026q=85\u0026s=5fc25cbb4aa682827a4cb16362e8ab13","dark":"https://mintcdn.com/mavapay/IhO63U3k6cpz2yeG/logo/mavapay-logo.png?fit=max\u0026auto=format\u0026n=IhO63U3k6cpz2yeG\u0026q=85\u0026s=5fc25cbb4aa682827a4cb16362e8ab13"},"favicon":"https://mintcdn.com/mavapay/IhO63U3k6cpz2yeG/favicon.svg?fit=max\u0026auto=format\u0026n=IhO63U3k6cpz2yeG\u0026q=85\u0026s=d28e365b2bddfcafa27bbc50edaacc85","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[{"href":"mailto:info@mavapay.co","label":"Support"}],"primary":{"type":"button","label":"Sign up","href":"https://mavapay.co/create-account"}},"footer":{"socials":{"x":"https://x.com/mavapay","github":"https://github.com/mavapay","linkedin":"https://www.linkedin.com/company/mavapay"}},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Products","icon":"product-hunt","href":"https://mavapay.co"},{"anchor":"Blog","icon":"newspaper","href":"https://blog.mavapay.co"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mavapay","hasAudioNarration":false,"actualSubdomain":"mavapay","customDomains":["docs.mavapay.co"],"gitSource":{"type":"github","owner":"stealthmoney","repo":"mavapay-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6ad725eb6cacb041d67e20ae","clientVersion":"0.0.4087","searchFilterCounts":[{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"API Endpoints","count":24},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"Payouts","count":5},{"language":"default","tag":"API Documentation","count":3},{"language":"default","tag":"Payment Link","count":3},{"language":"default","tag":"Withdraw","count":3},{"language":"default","tag":"Get Started","count":3},{"language":"default","tag":"Collections","count":3}]},"assistantConfig":{},"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":false},"customCss":[],"page":{"pagePath":"api-reference/endpoint/withdraw/withdraw-fiat","slug":"/api-reference/endpoint/withdraw/withdraw-fiat","pageMetadata":{"openapi":"post /withdraw","title":"Withdraw fiat","description":"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.","href":"/api-reference/endpoint/withdraw/withdraw-fiat"},"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: \"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.\"\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":{"config":{},"pageMetadata":{"openapi":"post /withdraw","title":"Withdraw fiat","description":"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.","href":"/api-reference/endpoint/withdraw/withdraw-fiat"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"security":["bd66083b-4338-4106-a88e-190239faa97d","4e0ca7ed-cdcc-4c74-9eac-4179a01d7894"],"tags":["Withdraw"],"operationId":"withdraw","summary":"Withdraw fiat","description":"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.","requestBody":"70da48b4-4260-4d65-9684-df6f76ed99c1","responses":{"200":"c8a55d79-60c8-4104-8258-1d2c0d8f87ff","400":"27e1e0cf-7195-4d63-b83e-3c6ee41bdbb0"},"method":"post","type":"path","servers":["6e53d903-b18d-4fea-9880-ddc2a2838465","fd35985e-2eff-4710-acd3-da256a5de9c8"],"path":"/withdraw","baseUrlOptions":["https://staging.api.mavapay.co/api/v1","https://api.mavapay.co/api/v1"],"title":"Withdraw fiat","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","required":["amount","currency","beneficiary"],"properties":{"amount":{"type":"string","description":"The amount to withdraw in the lowest denomination (e.g., Kobo for NGN). For example, 100000 = 1,000.00 NGN","example":"100000","isRequired":true,"uniqueKey":"amount","typeLabel":"string"},"currency":{"type":"string","description":"The currency to withdraw","enum":["NGN"],"isRequired":true,"uniqueKey":"currency","typeLabel":"enum\u003cstring>"},"beneficiary":{"type":"object","description":"The beneficiary bank account details. Use the exact values returned from the Name Enquiry endpoint.","required":["bankAccountNumber","bankAccountName","bankCode","bankName"],"properties":{"bankAccountNumber":{"type":"string","description":"The recipient's bank account number","example":"0123456789","isRequired":true,"uniqueKey":"beneficiary.bankAccountNumber","typeLabel":"string"},"bankAccountName":{"type":"string","description":"The account holder's name as returned by the Name Enquiry endpoint. Must match exactly.","example":"JOHN DOE","isRequired":true,"uniqueKey":"beneficiary.bankAccountName","typeLabel":"string"},"bankCode":{"type":"string","description":"The NIP bank code (nipBankCode) from the bank list","example":"000013","isRequired":true,"uniqueKey":"beneficiary.bankCode","typeLabel":"string"},"bankName":{"type":"string","description":"The bank name as returned from the bank list","example":"GTBANK PLC","isRequired":true,"uniqueKey":"beneficiary.bankName","typeLabel":"string"}},"isRequired":true,"uniqueKey":"beneficiary","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"withdrawNgn":{"title":"withdrawNgn","description":"Withdraw Nigerian Naira to a verified bank account","value":{"amount":"100000","currency":"NGN","beneficiary":{"bankAccountNumber":"0123456789","bankAccountName":"JOHN DOE","bankCode":"000013","bankName":"GTBANK PLC"}}}},"exampleType":"examples"}},"required":true,"exampleType":"examples"},"responses":{"c8a55d79-60c8-4104-8258-1d2c0d8f87ff":{"description":"Withdraw response","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","format":"string","example":"ok","uniqueKey":"status","typeLabel":"string\u003cstring>"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"d1614a76-9c7f-4111-98a7-43199f307e5b","description":"The unique identifier for the transaction","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"walletId":{"type":"string","format":"uuid","example":"d1614a76-9c7f-4111-98a7-43199f307e5b","description":"The unique identifier for the wallet","uniqueKey":"data.walletId","typeLabel":"string\u003cuuid>"},"ref":{"type":"string","format":"string","example":"99eeff854ffd345fffs67890","description":"The reference for the transaction","uniqueKey":"data.ref","typeLabel":"string\u003cstring>"},"hash":{"type":"string","format":"string","example":"189727ef2e0f35921af7858b96e27cbad960b0ec2bb2a4ab73b6a231f9ce8727","description":"The payment hash for the lightning invoice attached to the quote related to the transaction","uniqueKey":"data.hash","typeLabel":"string\u003cstring>"},"amount":{"type":"number","format":"number","example":1000,"description":"The amount of the transaction in its lowest denomination","uniqueKey":"data.amount","typeLabel":"number\u003cnumber>"},"fees":{"type":"number","format":"number","example":0,"description":"The fees for the transaction in its lowest denomination","uniqueKey":"data.fees","typeLabel":"number\u003cnumber>"},"currency":{"type":"string","format":"string","enum":["NGN","KES","BTC","ZAR","GHS","USDT"],"description":"The currency of the transaction","uniqueKey":"data.currency","typeLabel":"enum\u003cstring>"},"type":{"type":"string","format":"string","enum":["WITHDRAWAL","DEPOSIT"],"description":"The type of the transaction","uniqueKey":"data.type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","format":"string","enum":["SUCCESS","PENDING","FAILED"],"description":"The status of the transaction","uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"autopayout":{"type":"boolean","format":"boolean","example":true,"description":"Whether the transaction is an instant payout","uniqueKey":"data.autopayout","typeLabel":"boolean\u003cboolean>"},"createdAt":{"type":"string","format":"date-time","example":"2021-07-01T12:00:00Z","description":"The date and time the transaction was created","uniqueKey":"data.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","example":"2021-07-01T12:00:00Z","description":"The date and time the transaction was last updated","uniqueKey":"data.updatedAt","typeLabel":"string\u003cdate-time>"},"metadata":{"type":"object","properties":{"id":{"type":"string","format":"uuid","example":"d1614a76-9c7f-4111-98a7-43199f307e5b","uniqueKey":"data.metadata.id","typeLabel":"string\u003cuuid>"},"orderId":{"type":"string","format":"string","example":"99854-2345","uniqueKey":"data.metadata.orderId","typeLabel":"string\u003cstring>"},"bankCode":{"type":"string","format":"string","example":"090267","uniqueKey":"data.metadata.bankCode","typeLabel":"string\u003cstring>"},"bankAccountName":{"type":"string","format":"string","example":"Satoshi Nakamoto","uniqueKey":"data.metadata.bankAccountName","typeLabel":"string\u003cstring>"},"bankAccountNumber":{"type":"string","format":"string","example":"0123456789","uniqueKey":"data.metadata.bankAccountNumber","typeLabel":"string\u003cstring>"},"customerInternalFee":{"type":"number","format":"number","example":0,"uniqueKey":"data.metadata.customerInternalFee","typeLabel":"number\u003cnumber>"},"createdAt":{"type":"string","format":"date-time","example":"2021-07-01T12:00:00Z","uniqueKey":"data.metadata.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","example":"2021-07-01T12:00:00Z","uniqueKey":"data.metadata.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data.metadata","typeLabel":"object"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"ok","data":{"id":"d1614a76-9c7f-4111-98a7-43199f307e5b","walletId":"d1614a76-9c7f-4111-98a7-43199f307e5b","ref":"99eeff854ffd345fffs67890","hash":"189727ef2e0f35921af7858b96e27cbad960b0ec2bb2a4ab73b6a231f9ce8727","amount":1000,"fees":0,"currency":"NGN","type":"WITHDRAWAL","status":"SUCCESS","autopayout":true,"createdAt":"2021-07-01T12:00:00Z","updatedAt":"2021-07-01T12:00:00Z","metadata":{"id":"d1614a76-9c7f-4111-98a7-43199f307e5b","orderId":"99854-2345","bankCode":"090267","bankAccountName":"Satoshi Nakamoto","bankAccountNumber":"0123456789","customerInternalFee":0,"createdAt":"2021-07-01T12:00:00Z","updatedAt":"2021-07-01T12:00:00Z"}}}}},"exampleType":"generated"}},"exampleType":"generated"},"27e1e0cf-7195-4d63-b83e-3c6ee41bdbb0":{"description":"Unexpected error","content":{"application/json":{"schema":{"required":["error","message"],"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"status":{"type":"string","format":"string","example":"error","uniqueKey":"status","typeLabel":"string\u003cstring>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>","status":"error"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"bd66083b-4338-4106-a88e-190239faa97d":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"}},"4e0ca7ed-cdcc-4c74-9eac-4179a01d7894":{"bearerAuth":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"6e53d903-b18d-4fea-9880-ddc2a2838465":{"url":"https://staging.api.mavapay.co/api/v1","description":"Staging server"},"fd35985e-2eff-4710-acd3-da256a5de9c8":{"url":"https://api.mavapay.co/api/v1","description":"Live server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-KEY","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-KEY","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-KEY"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"mavapay","siteName":"Mavapay","title":"Withdraw fiat - Mavapay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-16T16:21:23.541Z","originalFileLocation":"api-reference/endpoint/withdraw/withdraw-fiat.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=\"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mavapay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mavapay/xSl2pWabxQlg23Z-/_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/mavapay/xSl2pWabxQlg23Z-/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mavapay/xSl2pWabxQlg23Z-/_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/mavapay/xSl2pWabxQlg23Z-/_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/mavapay/xSl2pWabxQlg23Z-/_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/mavapay/xSl2pWabxQlg23Z-/_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/mavapay/xSl2pWabxQlg23Z-/_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/mavapay/xSl2pWabxQlg23Z-/_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/mavapay/xSl2pWabxQlg23Z-/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Withdraw fiat - Mavapay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mavapay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mavapay.mintlify.site/_mintlify/api/og/v2?division=Withdraw\u0026amp;title=Withdraw+fiat\u0026amp;description=Withdraw+funds+to+a+bank+account.+The+amount+is+specified+in+the+lowest+denomination+of+the+currency+%28e.g.%2C+Kobo+for+NGN%29.+You+must+first+verify+the+bank+accoun\u0026amp;theme=039b026399252efad3a598ce\u0026amp;signature=9d1452ff39e763b91f6f2673f427d28dee50e6cb620c00a7a5e0daa62c3dedc6\">\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 fiat - Mavapay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mavapay.mintlify.site/_mintlify/api/og/v2?division=Withdraw\u0026amp;title=Withdraw+fiat\u0026amp;description=Withdraw+funds+to+a+bank+account.+The+amount+is+specified+in+the+lowest+denomination+of+the+currency+%28e.g.%2C+Kobo+for+NGN%29.+You+must+first+verify+the+bank+accoun\u0026amp;theme=039b026399252efad3a598ce\u0026amp;signature=9d1452ff39e763b91f6f2673f427d28dee50e6cb620c00a7a5e0daa62c3dedc6\">\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/mavapay/xSl2pWabxQlg23Z-/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mavapay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#F2B246\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/withdraw/withdraw-fiat.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mavapay.co/#organization\",\"name\":\"Mavapay\",\"url\":\"https://docs.mavapay.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mavapay/IhO63U3k6cpz2yeG/logo/mavapay-logo.png?fit=max\u0026auto=format\u0026n=IhO63U3k6cpz2yeG\u0026q=85\u0026s=5fc25cbb4aa682827a4cb16362e8ab13\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mavapay.co#website\",\"name\":\"Mavapay\",\"url\":\"https://docs.mavapay.co\",\"publisher\":{\"@id\":\"https://docs.mavapay.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat#webpage\",\"url\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat\",\"name\":\"Withdraw fiat\",\"description\":\"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.\",\"dateModified\":\"2026-02-16T16:21:23.541Z\",\"isPartOf\":{\"@id\":\"https://docs.mavapay.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Endpoints\",\"item\":\"https://docs.mavapay.co/api-reference/endpoint/price/get-price\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Withdraw fiat\",\"item\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat#apireference\",\"headline\":\"Withdraw fiat\",\"name\":\"Withdraw fiat\",\"description\":\"Withdraw funds to a bank account. The amount is specified in the lowest denomination of the currency (e.g., Kobo for NGN). You must first verify the bank account using the Name Enquiry endpoint before initiating a withdrawal.\",\"url\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mavapay.co/api-reference/endpoint/withdraw/withdraw-fiat#webpage\"},\"dateModified\":\"2026-02-16T16:21:23.541Z\",\"publisher\":{\"@id\":\"https://docs.mavapay.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mavapay.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mavapay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Mavapay","nav":{"global":{"anchors":[{"anchor":"Products","icon":"product-hunt","href":"https://mavapay.co"},{"anchor":"Blog","icon":"newspaper","href":"https://blog.mavapay.co"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors","href":"/api-reference/errors"}]},{"group":"API Endpoints","pages":[{"group":"Price","pages":[{"openapi":"get /price/ticker","title":"Get price ticker for currency pair","href":"/api-reference/endpoint/price/get-price"}]},{"group":"Bank Account","pages":[{"openapi":"get /bankaccount","title":"Get bank account details","href":"/api-reference/endpoint/bank-account/get-account"},{"openapi":"post /bankaccount","title":"Register a bank account","href":"/api-reference/endpoint/bank-account/register-account"}]},{"group":"Bank Info","pages":[{"openapi":"get /bank/bankcode","title":"Get bank code","href":"/api-reference/endpoint/bank-info/bank-code"},{"title":"Name Enquiry","openapi":"get /bank/name-enquiry","href":"/api-reference/endpoint/bank-info/name-enquiry"}]},{"group":"Order","pages":[{"openapi":"get /order","title":"Get order details","href":"/api-reference/endpoint/order/get-order-by-id"},{"openapi":"get /order/all","title":"Get all orders","href":"/api-reference/endpoint/order/get-all-orders"}]},{"group":"Quote","pages":[{"openapi":"post /quote","title":"Create a quote","href":"/api-reference/endpoint/quote/get-quote"},{"openapi":"post /quote/validate-kes-identifier","title":"Validate KES identifier","href":"/api-reference/endpoint/quote/validate-kes-identifier"}]},{"group":"Payment Link","pages":[{"openapi":"post /paymentlink","title":"Create a payment link","href":"/api-reference/endpoint/payment-link/create-payment-link"},{"openapi":"get /paymentlink/details","title":"Get payment link details","href":"/api-reference/endpoint/payment-link/get-payment-link-details"},{"openapi":"get /paymentlink/orders","title":"Get payment link orders","href":"/api-reference/endpoint/payment-link/get-payment-link-orders"}]},{"group":"Wallet","pages":[{"openapi":"get /wallet","title":"Get wallet details","href":"/api-reference/endpoint/wallet/get-wallets"},{"openapi":"post /wallet/payout/{quoteId}/accept","title":"Accept quote","href":"/api-reference/endpoint/wallet/accept-quote"}]},{"group":"Collection","pages":[{"openapi":"post /collections/stablecoin/generate-address","title":"Generate a stablecoin deposit address","href":"/api-reference/endpoint/collection/generate-stablecoin-address"},{"openapi":"get /collections/stablecoin/addresses","title":"List stablecoin deposit addresses","description":"Retrieve all previously generated USDT deposit addresses for your account. Filter by currency using the `currency` query parameter.","href":"/api-reference/endpoint/collection/get-stablecoin-addresses"}]},{"group":"Withdraw","pages":[{"openapi":"post /withdraw","title":"Withdraw fiat","href":"/api-reference/endpoint/withdraw/withdraw-fiat"},{"openapi":"post /withdraw/btc","title":"Withdraw BTC","description":"Withdraw BTC to a wallet","href":"/api-reference/endpoint/withdraw/withdraw-btc"},{"openapi":"post /withdraw/stablecoin","title":"Withdraw stablecoin","href":"/api-reference/endpoint/withdraw/withdraw-stablecoin"}]},{"group":"Transaction","pages":[{"openapi":"get /transaction","title":"Get transaction details","href":"/api-reference/endpoint/transaction/get-transaction"},{"openapi":"get /transactions","title":"Get all transactions","href":"/api-reference/endpoint/transaction/get-all-transactions"}]},{"group":"User","pages":[{"openapi":"get /user","title":"Get user profile","href":"/api-reference/endpoint/user/get-user-profile"}]},{"group":"Webhook","pages":[{"title":"Register Webhook","href":"/api-reference/endpoint/webhook/register-webhook"},{"title":"Update Webhook","href":"/api-reference/endpoint/webhook/update-webhook"}]}]}]}]},"basePath":"","title":"Withdraw fiat - Mavapay","buildId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","deploymentId":"dpl_FWZhTb2vab28gFGFH4ojka6qEznQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CBsVopKK.js","utils-DZAk68jJ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D32AYZrP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D_A5_cny.js","snippetPresets-xNRfS9th.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BIB25-tq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CydJ4w4j.js","shallow-CYPBeQSG.js","getApiPlaygroundDisplay-A5xJVBOu.js","CodeSnippet-BVRTgi3m.js","CodeSnippets-DjD6BSlt.js","Page-Dr40SSJq.js","getPastedJson-D4V4JyrR.js","icon-uhcnG22T.js","MethodPill-CM-ZQdGH.js","DuplicateIcon-B_WnOiNf.js","createIcon-CJsb8utt.js","DynamicMarkdown-D-2HDKEp.js","SectionHeading-KP5xmMgQ.js","axios-vUo_bRtp.js","Markdown-D_k0dg6k.js","clsx-DK3K4Z1S.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DE3EVdvd.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-fN9H9n9g.js"]}