The idempotencykey header is required. Generate a new key for every new exchange. Only reuse a key when retrying the same request after a timeout or network error.
Fees may apply and will be deducted from the wallet balance.
For XOF and XAF, the iso2 field is mandatory and must match the selected country.
Always fetch providers from /transaction/{method}/providers before initiating transfers.
Transfers are subject to mobile network processing times.
Invalid phone numbers, unsupported providers, or incorrect country codes will result in validation errors.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Monirates","colors":{"primary":"#EB2E67","light":"#EB2E67","dark":"#17298F"},"logo":{"light":"https://mintcdn.com/monirateslimited/mzmSK7TCWuM4cbvc/logo/Primary%20Logo%20PNG.png?fit=max\u0026auto=format\u0026n=mzmSK7TCWuM4cbvc\u0026q=85\u0026s=9b54e6fb32800af25dd2a878e795bb7b","dark":"https://mintcdn.com/monirateslimited/mzmSK7TCWuM4cbvc/logo/Primary%20Logo%20PNG_White%20new.png?fit=max\u0026auto=format\u0026n=mzmSK7TCWuM4cbvc\u0026q=85\u0026s=c0c75e546fe8e6ee2f4abf4c78db5751"},"favicon":"https://mintcdn.com/monirateslimited/mzmSK7TCWuM4cbvc/logo/M.png?fit=max\u0026auto=format\u0026n=mzmSK7TCWuM4cbvc\u0026q=85\u0026s=a559bbdf60c5e9cf3f0b71d274d4f4ea","api":{},"appearance":{},"navbar":{"links":[{"href":"mailto:info@monirates.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://business.monirates.com"}},"footer":{"socials":{"x":"https://x.com/monirates","github":"https://github.com/monirates","linkedin":"https://linkedin.com/company/monirates"}},"contextual":{"options":["copy","chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"monirateslimited","hasAudioNarration":false,"actualSubdomain":"monirateslimited","customDomains":["docs.monirates.com"],"gitSource":{"type":"github","owner":"monirates","repo":"api-docs","deployBranch":"prod","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad2219b8aaa47060682289f","collectionId":"c7f397ef-42ba-4e25-99e4-066683a95b92","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad2219b8aaa47060682289f"},"entitlements":{},"buildId":"6ad2219b8aaa47060682289f","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API Reference","count":47},{"language":"default","tag":"Business","count":47},{"language":"default","tag":"Guides","count":16},{"language":"default","tag":"Stable Wallet","count":15},{"language":"default","tag":"Payment Link","count":10},{"language":"default","tag":"Wallet","count":8},{"language":"default","tag":"Documentation","count":7},{"language":"default","tag":"Getting Started","count":7},{"language":"default","tag":"Exchange","count":7},{"language":"default","tag":"Transaction","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"[data-layout=default] main{padding-top:0!important}[data-layout=default] [data-content],[data-layout=default] main>div{padding-top:.5rem!important}[data-layout=default] h1{margin-top:0!important;margin-bottom:.5rem!important}[data-layout=default] header{margin-bottom:.5rem!important;padding-bottom:0!important}[data-layout=default] section{margin-top:.5rem!important}[data-layout=default] p{margin-top:.4rem;margin-bottom:.4rem}"}],"page":{"pagePath":"guides/withdraw-funds-to-mobile-money","slug":"/guides/withdraw-funds-to-mobile-money","pageMetadata":{"title":"Withdraw to Mobile Money","description":"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies","icon":"mobile","href":"/guides/withdraw-funds-to-mobile-money"},"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: \"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies\"\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`,em:`em`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`mobile-money-transfer`,children:`Mobile Money Transfer`}),`\n`,_jsx(_components.p,{children:`This endpoint supports wallet withdrawals to mobile money accounts for supported currencies.`}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`supported-currencies`,children:`Supported Currencies`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Currency`}),_jsx(_components.th,{children:`Country/Region`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GHS`})}),_jsx(_components.td,{children:`Ghana`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`XOF`})}),_jsx(_components.td,{children:`Benin, Ivory Coast, Burkina Faso, Senegal`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`XAF`})}),_jsx(_components.td,{children:`Cameroon`})]})]})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`transfer-flow`,children:`Transfer Flow`}),`\n`,_jsx(Heading,{level:`3`,id:`step-1-ensure-sufficient-balance`,children:`Step 1: Ensure Sufficient Balance`}),`\n`,_jsx(_components.p,{children:`Ensure the user has sufficient wallet balance for the selected currency before initiating a transfer.`}),`\n`,_jsx(Heading,{level:`3`,id:`step-2-fetch-supported-mobile-money-providers`,children:`Step 2: Fetch Supported Mobile Money Providers`}),`\n`,_jsx(_components.p,{children:`Retrieve the list of supported mobile money providers for the selected country and currency by calling the utility endpoint:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /transaction/{method}/providers?currency={currency}\u0026iso2={iso2}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Example:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,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:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET /transaction/MOBILE_MONEY/providers?currency=XOF\u0026iso2=BJ`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`Use the returned provider `,_jsx(_components.code,{children:`code`}),` as the value for the `,_jsx(_components.code,{children:`network`}),` field when initiating the transfer.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`headers`,children:`Headers`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Header`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`idempotencykey`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`A unique value for each exchange you create.`})]})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`idempotencykey`}),` header is `,_jsx(_components.strong,{children:`required`}),`. Generate a new key for every new exchange. Only reuse a key when retrying the `,_jsx(_components.em,{children:`same`}),` request after a timeout or network error.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`fields`,children:`Fields`}),`\n`,_jsx(Heading,{level:`3`,id:`required`,children:`Required`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsxs(_components.td,{children:[`Wallet currency — `,_jsx(_components.code,{children:`GHS`}),`, `,_jsx(_components.code,{children:`XOF`}),`, or `,_jsx(_components.code,{children:`XAF`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`amount`})}),_jsx(_components.td,{children:`Amount to transfer`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`phoneNumber`})}),_jsx(_components.td,{children:`Recipient mobile money number`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`network`})}),_jsxs(_components.td,{children:[`Mobile money provider code (e.g. `,_jsx(_components.code,{children:`MTN`}),`, `,_jsx(_components.code,{children:`MTN_MOMO_BEN`}),`)`]})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`conditionally-required`,children:`Conditionally Required`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`iso2`})}),_jsxs(_components.td,{children:[`Required when currency is `,_jsx(_components.code,{children:`XOF`}),` or `,_jsx(_components.code,{children:`XAF`}),`. Must match the selected country (e.g. `,_jsx(_components.code,{children:`BJ`}),`, `,_jsx(_components.code,{children:`CI`}),`, `,_jsx(_components.code,{children:`BF`}),`, `,_jsx(_components.code,{children:`SN`}),`, `,_jsx(_components.code,{children:`CM`}),`)`]})]})})]}),`\n`,_jsx(Heading,{level:`3`,id:`optional`,children:`Optional`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Field`}),_jsx(_components.th,{children:`Description`})]})}),_jsx(_components.tbody,{children:_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`narration`})}),_jsx(_components.td,{children:`Transaction description`})]})})]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`sample-request-payloads`,children:`Sample Request Payloads`}),`\n`,_jsx(Heading,{level:`3`,id:`ghs-mobile-money-transfer`,children:`GHS Mobile Money Transfer`}),`\n`,_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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GHS\"`}),_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:`10`}),_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:` \"narration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Gift\"`}),_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:` \"phoneNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+233237867135\"`}),_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:` \"network\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MTN\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`xof-mobile-money-transfer`,children:`XOF Mobile Money Transfer`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,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:`8`,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:` \"currency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"XOF\"`}),_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:` \"iso2\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"BJ\"`}),_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:`10`}),_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:` \"narration\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Refund\"`}),_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:` \"phoneNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"+22990123456\"`}),_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:` \"network\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MTN_MOMO_BEN\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Fees may apply and will be deducted from the wallet balance.`}),`\n`,_jsxs(_components.li,{children:[`For `,_jsx(_components.code,{children:`XOF`}),` and `,_jsx(_components.code,{children:`XAF`}),`, the `,_jsx(_components.code,{children:`iso2`}),` field is mandatory and must match the selected country.`]}),`\n`,_jsxs(_components.li,{children:[`Always fetch providers from `,_jsx(_components.code,{children:`/transaction/{method}/providers`}),` before initiating transfers.`]}),`\n`,_jsx(_components.li,{children:`Transfers are subject to mobile network processing times.`}),`\n`,_jsx(_components.li,{children:`Invalid phone numbers, unsupported providers, or incorrect country codes will result in validation errors.`}),`\n`]})]})}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 to Mobile Money","description":"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies","icon":"mobile","href":"/guides/withdraw-funds-to-mobile-money"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Mobile Money Transfer","slug":"mobile-money-transfer","depth":2,"children":[]},{"title":"Supported Currencies","slug":"supported-currencies","depth":2,"children":[]},{"title":"Transfer Flow","slug":"transfer-flow","depth":2,"children":[{"title":"Step 1: Ensure Sufficient Balance","slug":"step-1-ensure-sufficient-balance","depth":3,"children":[]},{"title":"Step 2: Fetch Supported Mobile Money Providers","slug":"step-2-fetch-supported-mobile-money-providers","depth":3,"children":[]}]},{"title":"Headers","slug":"headers","depth":2,"children":[]},{"title":"Fields","slug":"fields","depth":2,"children":[{"title":"Required","slug":"required","depth":3,"children":[]},{"title":"Conditionally Required","slug":"conditionally-required","depth":3,"children":[]},{"title":"Optional","slug":"optional","depth":3,"children":[]}]},{"title":"Sample Request Payloads","slug":"sample-request-payloads","depth":2,"children":[{"title":"GHS Mobile Money Transfer","slug":"ghs-mobile-money-transfer","depth":3,"children":[]},{"title":"XOF Mobile Money Transfer","slug":"xof-mobile-money-transfer","depth":3,"children":[]}]},{"title":"Notes","slug":"notes","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"monirateslimited","siteName":"Monirates","title":"Withdraw to Mobile Money - Monirates","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-30T14:43:37.314Z","originalFileLocation":"guides/withdraw-funds-to-mobile-money.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=\"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies\">\u003cmeta data-mint-head name=\"application-name\" content=\"Monirates\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/monirateslimited/9S3NzQI7XuuhACOq/_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/monirateslimited/9S3NzQI7XuuhACOq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/monirateslimited/9S3NzQI7XuuhACOq/_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/monirateslimited/9S3NzQI7XuuhACOq/_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/monirateslimited/9S3NzQI7XuuhACOq/_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/monirateslimited/9S3NzQI7XuuhACOq/_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/monirateslimited/9S3NzQI7XuuhACOq/_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/monirateslimited/9S3NzQI7XuuhACOq/_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/monirateslimited/9S3NzQI7XuuhACOq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Withdraw to Mobile Money - Monirates\">\u003cmeta data-mint-head property=\"og:description\" content=\"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Monirates\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://monirateslimited.mintlify.app/_mintlify/api/og/v2?division=Wallet\u0026amp;title=Withdraw+to+Mobile+Money\u0026amp;description=Endpoint+reference+for+withdrawing+funds+to+mobile+money+accounts+across+supported+currencies\u0026amp;theme=ddf365d67ed6a218c2984a33\u0026amp;signature=6147ca49bbc800c177df712c11fdc61c088c9ba26cdf872e93b72d0844b30256\">\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 to Mobile Money - Monirates\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://monirateslimited.mintlify.app/_mintlify/api/og/v2?division=Wallet\u0026amp;title=Withdraw+to+Mobile+Money\u0026amp;description=Endpoint+reference+for+withdrawing+funds+to+mobile+money+accounts+across+supported+currencies\u0026amp;theme=ddf365d67ed6a218c2984a33\u0026amp;signature=6147ca49bbc800c177df712c11fdc61c088c9ba26cdf872e93b72d0844b30256\">\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/monirateslimited/9S3NzQI7XuuhACOq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Monirates\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#EB2E67\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/withdraw-funds-to-mobile-money.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.monirates.com/#organization\",\"name\":\"Monirates\",\"url\":\"https://docs.monirates.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/monirateslimited/mzmSK7TCWuM4cbvc/logo/Primary%20Logo%20PNG.png?fit=max\u0026auto=format\u0026n=mzmSK7TCWuM4cbvc\u0026q=85\u0026s=9b54e6fb32800af25dd2a878e795bb7b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.monirates.com#website\",\"name\":\"Monirates\",\"url\":\"https://docs.monirates.com\",\"publisher\":{\"@id\":\"https://docs.monirates.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money#webpage\",\"url\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money\",\"name\":\"Withdraw to Mobile Money\",\"description\":\"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies\",\"dateModified\":\"2026-09-30T14:43:37.314Z\",\"isPartOf\":{\"@id\":\"https://docs.monirates.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Wallet\",\"item\":\"https://docs.monirates.com/guides/create-wallet\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Withdraw to Mobile Money\",\"item\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money#article\",\"headline\":\"Withdraw to Mobile Money\",\"name\":\"Withdraw to Mobile Money\",\"description\":\"Endpoint reference for withdrawing funds to mobile money accounts across supported currencies\",\"url\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money\",\"mainEntityOfPage\":{\"@id\":\"https://docs.monirates.com/guides/withdraw-funds-to-mobile-money#webpage\"},\"dateModified\":\"2026-09-30T14:43:37.314Z\",\"publisher\":{\"@id\":\"https://docs.monirates.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.monirates.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Monirates\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Monirates","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/getting-started"}]},{"tab":"Guides","icon":"map","pages":[{"group":"Exchange","icon":"","pages":[{"title":"Create an exchange","icon":"money-bill-transfer","href":"/guides"},{"title":"Payment Made","icon":"check-double","href":"/guides/payment-made"},{"title":"Get Rate","icon":"percent","href":"/guides/get-rate"}]},{"group":"Payment links","icon":"","pages":[{"title":"Create Payment Link","icon":"link","href":"/guides/create-payment-link"},{"title":"Create Exchange from Payment Link","icon":"arrow-right-arrow-left","href":"/guides/untitled-page"}]},{"group":"Wallet","icon":"","pages":[{"title":"Create Wallet","icon":"wallet","href":"/guides/create-wallet"},{"title":"Fund Wallet","icon":"money-bill-wave","href":"/guides/fund-wallet"},{"title":"Wallet Balance","icon":"equals","href":"/guides/wallet"},{"title":"Withdraw Funds to Bank","icon":"piggy-bank","description":"Endpoint reference for withdrawing Nigerian Naira via bank transfer","href":"/guides/withdraw-funds-from-bank"},{"title":"Withdraw to Mobile Money","icon":"mobile","href":"/guides/withdraw-funds-to-mobile-money"},{"title":"Virtual One Time Account","description":"How to use the virtual one time account","icon":"album-collection","href":"/guides/virtual-one-time-account"}]},{"group":"Stable Wallet","pages":[{"title":"Stable Currency Wallet","icon":"connectdevelop","sidebarTitle":"Stable Wallet","href":"/guides/stable-wallets"},{"title":"Stable Currency Sub-Wallet","icon":"sitemap","sidebarTitle":"Stable Sub-Wallet","href":"/guides/stable-sub-wallets"}]},{"group":"Quick Reference","pages":[{"title":"Supported Payment Methods","icon":"credit-card","sidebarTitle":"Payment Methods","href":"/guides/supported-payment-methods"},{"title":"Lookup Banks / Providers","icon":"building-magnifying-glass","sidebarTitle":"Lookup Institutions","href":"/guides/lookup-bank-provider"},{"title":"Sub-Account","icon":"users","sidebarTitle":"Sub-Account","href":"/untitled-page"}]}]},{"tab":"API Reference","icon":"code","pages":[{"title":"API Reference","href":"/api-reference/exchange/create-an-exchange"}]}]},"title":"Withdraw to Mobile Money - Monirates","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":[],"chunks":[]}
