Payouts debit the merchant wallet and are processed asynchronously.
Authorizations
X-Api-Key
string
header
required
Public API key from the merchant dashboard.
X-Api-Secret
string
header
required
Secret shown once when the API key is created.
Headers
Idempotency-Key
string
required
Unique key for this business intent. Reuse only when retrying the same request body.
Body
application/json
quote_id
string<uuid>
required
customer_id
string<uuid>
required
recipient
object
required
Recipient details for a payout. Routing (country, rail and operator) is
taken from the quote, so it is not repeated here. Send the fields for the
quote's rail: phone for mobile_money, or the four bank fields for
bank_transfer. Fields belonging to the other rail are rejected.
Show child attributes
payment_reason_code
string
Example:
"OTHER"
payment_reason_text
string
Example:
"Merchant payout"
Response
Payout created.
id
string<uuid>
merchant_id
string<uuid>
customer_id
string<uuid>
quote_id
string<uuid>
send_amount
string
Pattern: ^[0-9]+(\.[0-9]+)?$
Example:
"10000"
send_currency
enum<string>
Supported currencies for payins, payouts, and transfers.
Available options:
XAF,
XOF
Example:
"XAF"
receive_amount
string
Pattern: ^[0-9]+(\.[0-9]+)?$
Example:
"10000"
receive_currency
enum<string>
Supported currencies for payins, payouts, and transfers.
Available options:
XAF,
XOF
Example:
"XAF"
country_code
string
Required string length: 2
Example:
"CM"
rail_type
enum<string>
Available options:
mobile_money,
bank_transfer
operator_code
string
provider_reference
string | null
wallet_impact
object
pricing
object
history
object[]
Show child attributes
created_at
string<date-time>
updated_at
string<date-time>
status
enum<string>
Available options:
created,
pending,
completed,
failed
recipient
object
Show child attributes
Last modified on September 22, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Saapay Business","description":"Developer documentation for the Saapay Business merchant API.","colors":{"primary":"#7135E8","light":"#A47BFF","dark":"#5E29C8"},"logo":{"light":"https://mintcdn.com/saapay/_YVRfN6Mkf9LqInJ/logo/light.svg?fit=max\u0026auto=format\u0026n=_YVRfN6Mkf9LqInJ\u0026q=85\u0026s=43c39495b8a295ef0d7bfd01e9b0b14f","dark":"https://mintcdn.com/saapay/_YVRfN6Mkf9LqInJ/logo/dark.svg?fit=max\u0026auto=format\u0026n=_YVRfN6Mkf9LqInJ\u0026q=85\u0026s=b26ba96fe4c3e4b93d4cfe9970e8081c"},"favicon":"https://mintcdn.com/saapay/_YVRfN6Mkf9LqInJ/favicon.svg?fit=max\u0026auto=format\u0026n=_YVRfN6Mkf9LqInJ\u0026q=85\u0026s=b5cb934f31b9741b8f80b2e67f032c3a","api":{"openapi":"openapi.yaml","playground":{"display":"interactive"},"examples":{"defaults":"all","languages":["curl"],"prefill":true},"url":"full"},"appearance":{"default":"dark"},"background":{"color":{"light":"#FFFFFF","dark":"#18181B"}},"navbar":{"links":[{"href":"https://portal.saapay.cm","label":"Merchant Dashboard"}],"primary":{"type":"button","label":"Get API keys","href":"https://portal.saapay.cm"}},"footer":{"links":[{"items":[{"label":"Merchant Dashboard","href":"https://portal.saapay.cm"}]}]},"fonts":{"family":"Inter"},"icons":{"library":"lucide"},"styling":{"eyebrows":"section","codeblocks":"system","latex":false},"contextual":{"options":["copy","download-spec","view","chatgpt","claude","perplexity","cursor","vscode"],"display":"header"},"metadata":{"timestamp":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"saapay","hasAudioNarration":false,"actualSubdomain":"saapay","customDomains":["developers.saapay.cm"],"gitSource":{"type":"github","owner":"sa-a-sas","repo":"saapay-business-documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ab2478d1a82fb5814da9675","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Guides","count":22},{"language":"default","tag":"API Reference","count":15},{"language":"default","tag":"Getting started","count":6},{"language":"default","tag":"Supporting documentation","count":6},{"language":"default","tag":"Core concepts","count":5},{"language":"default","tag":"Quotes","count":4},{"language":"default","tag":"Transfers","count":3},{"language":"default","tag":"Practical flows","count":3},{"language":"default","tag":"Customer KYC","count":2},{"language":"default","tag":"Customers","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"site-roles","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":"control","enabled":true,"payload":{"type":"string","value":"control"},"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/payouts/create-payout","slug":"/api-reference/payouts/create-payout","pageMetadata":{"title":"Create payout","description":"Create a quote-backed payout.","openapi":"POST /payouts","href":"/api-reference/payouts/create-payout"},"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: \"Create a quote-backed payout.\"\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{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={p:`p`,..._provideComponents(),...props.components};return _jsx(_components.p,{children:`Payouts debit the merchant wallet and are processed asynchronously.`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create payout","description":"Create a quote-backed payout.","openapi":"POST /payouts","href":"/api-reference/payouts/create-payout"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Payouts"],"summary":"Create payout","description":"Create a quote-backed payout.","operationId":"createPayout","parameters":["b32beb8d-3fc4-403f-8c0d-7b3e86ac8a81"],"requestBody":"d2bcc23f-36b5-4e96-89f8-917a30c7a720","responses":{"201":"64f0cf55-7446-46d7-aa0c-efdf86b34fa2","400":"6bc75e56-839b-4ef4-bfc9-750536b80c69","401":"94386e63-7892-406f-88c7-bb14f06d9371","409":"f16da207-e3cb-44b4-98e5-566b4c20267e"},"method":"post","type":"path","servers":["7bbac250-432e-4962-8cfa-ac5ff30e1bc9"],"security":["247e4d34-f8c6-4676-a29e-4109ef5042ec"],"path":"/payouts","baseUrlOptions":["https://api.business.saapay.cm"],"title":"Create payout","codeSamples":[],"requestExampleLanguages":["bash"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.quote_id":"33333333-3333-3333-3333-333333333333","body.customer_id":"22222222-2222-2222-2222-222222222222","body.recipient.recipient_type":"individual","body.recipient.first_name":"Awa","body.recipient.last_name":"Ngu","body.recipient.phone":"+237670000000","body.recipient.email":"awa@example.com","body.recipient.recipient_nationality_code":"CM","body.payment_reason_code":"OTHER","body.payment_reason_text":"Merchant payout"}],"urlDisplay":"full"},"dependencies":{"parameters":{"b32beb8d-3fc4-403f-8c0d-7b3e86ac8a81":{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique key for this business intent. Reuse only when retrying the same request body.","schema":{"type":"string","isRequired":true,"description":"Unique key for this business intent. Reuse only when retrying the same request body.","uniqueKey":"","typeLabel":"string"},"example":"payin_2026_06_08_0001"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["quote_id","customer_id","recipient"],"properties":{"quote_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"quote_id","typeLabel":"string\u003cuuid>"},"customer_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"customer_id","typeLabel":"string\u003cuuid>"},"recipient":{"type":"object","description":"Recipient details for a payout. Routing (country, rail and operator) is\ntaken from the quote, so it is not repeated here. Send the fields for the\nquote's rail: `phone` for `mobile_money`, or the four bank fields for\n`bank_transfer`. Fields belonging to the other rail are rejected.\n","required":["recipient_type"],"properties":{"recipient_type":{"type":"string","enum":["individual","business"],"isRequired":true,"uniqueKey":"recipient.recipient_type","typeLabel":"enum\u003cstring>"},"first_name":{"type":"string","uniqueKey":"recipient.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"recipient.last_name","typeLabel":"string"},"business_name":{"type":"string","uniqueKey":"recipient.business_name","typeLabel":"string"},"phone":{"type":"string","example":"+237670000000","uniqueKey":"recipient.phone","typeLabel":"string"},"email":{"type":"string","format":"email","uniqueKey":"recipient.email","typeLabel":"string\u003cemail>"},"recipient_nationality_code":{"type":"string","minLength":2,"maxLength":2,"example":"CM","uniqueKey":"recipient.recipient_nationality_code","typeLabel":"string"},"bank_name":{"type":"string","uniqueKey":"recipient.bank_name","typeLabel":"string"},"bank_code":{"type":"string","uniqueKey":"recipient.bank_code","typeLabel":"string"},"account_name":{"type":"string","uniqueKey":"recipient.account_name","typeLabel":"string"},"account_number":{"type":"string","uniqueKey":"recipient.account_number","typeLabel":"string"}},"isRequired":true,"uniqueKey":"recipient","typeLabel":"object"},"payment_reason_code":{"type":"string","example":"OTHER","uniqueKey":"payment_reason_code","typeLabel":"string"},"payment_reason_text":{"type":"string","example":"Merchant payout","uniqueKey":"payment_reason_text","typeLabel":"string"}},"example":{"quote_id":"33333333-3333-3333-3333-333333333333","customer_id":"22222222-2222-2222-2222-222222222222","payment_reason_code":"OTHER","payment_reason_text":"Merchant payout","recipient":{"recipient_type":"individual","first_name":"Awa","last_name":"Ngu","phone":"+237670000000","email":"awa@example.com","recipient_nationality_code":"CM"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"quote_id":"33333333-3333-3333-3333-333333333333","customer_id":"22222222-2222-2222-2222-222222222222","payment_reason_code":"OTHER","payment_reason_text":"Merchant payout","recipient":{"recipient_type":"individual","first_name":"Awa","last_name":"Ngu","phone":"+237670000000","email":"awa@example.com","recipient_nationality_code":"CM"}}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"64f0cf55-7446-46d7-aa0c-efdf86b34fa2":{"description":"Payout created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"merchant_id":{"type":"string","format":"uuid","uniqueKey":"merchant_id","typeLabel":"string\u003cuuid>"},"customer_id":{"type":"string","format":"uuid","uniqueKey":"customer_id","typeLabel":"string\u003cuuid>"},"quote_id":{"type":"string","format":"uuid","uniqueKey":"quote_id","typeLabel":"string\u003cuuid>"},"send_amount":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","example":"10000","uniqueKey":"send_amount","typeLabel":"string"},"send_currency":{"type":"string","enum":["XAF","XOF"],"example":"XAF","description":"Supported currencies for payins, payouts, and transfers.","uniqueKey":"send_currency","typeLabel":"enum\u003cstring>"},"receive_amount":{"type":"string","pattern":"^[0-9]+(\\.[0-9]+)?$","example":"10000","uniqueKey":"receive_amount","typeLabel":"string"},"receive_currency":{"type":"string","enum":["XAF","XOF"],"example":"XAF","description":"Supported currencies for payins, payouts, and transfers.","uniqueKey":"receive_currency","typeLabel":"enum\u003cstring>"},"country_code":{"type":"string","minLength":2,"maxLength":2,"example":"CM","uniqueKey":"country_code","typeLabel":"string"},"rail_type":{"type":"string","enum":["mobile_money","bank_transfer"],"uniqueKey":"rail_type","typeLabel":"enum\u003cstring>"},"operator_code":{"type":"string","uniqueKey":"operator_code","typeLabel":"string"},"provider_reference":{"oneOf":[{"type":"string","uniqueKey":"provider_reference.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"provider_reference.oneOf.1","typeLabel":"null"}],"uniqueKey":"provider_reference","typeLabel":"string | null"},"wallet_impact":{"type":"object","additionalProperties":true,"uniqueKey":"wallet_impact","typeLabel":"object"},"pricing":{"type":"object","additionalProperties":true,"uniqueKey":"pricing","typeLabel":"object"},"history":{"type":"array","items":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"history.items.[INDEX].status","typeLabel":"string"},"reason":{"oneOf":[{"type":"string","uniqueKey":"history.items.[INDEX].reason.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"history.items.[INDEX].reason.oneOf.1","typeLabel":"null"}],"uniqueKey":"history.items.[INDEX].reason","typeLabel":"string | null"},"created_at":{"type":"string","format":"date-time","uniqueKey":"history.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"history.items.[INDEX]","typeLabel":"object"},"uniqueKey":"history","typeLabel":"object[]"},"created_at":{"type":"string","format":"date-time","uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"updated_at","typeLabel":"string\u003cdate-time>"},"status":{"type":"string","enum":["created","pending","completed","failed"],"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"recipient":{"type":"object","required":["recipient_type","country_code","rail_type"],"properties":{"country_code":{"type":"string","minLength":2,"maxLength":2,"example":"CM","isRequired":true,"uniqueKey":"recipient.country_code","typeLabel":"string"},"rail_type":{"type":"string","enum":["mobile_money","bank_transfer"],"isRequired":true,"uniqueKey":"recipient.rail_type","typeLabel":"enum\u003cstring>"},"recipient_type":{"type":"string","enum":["individual","business"],"isRequired":true,"uniqueKey":"recipient.recipient_type","typeLabel":"enum\u003cstring>"},"phone":{"type":"string","example":"+237670000000","uniqueKey":"recipient.phone","typeLabel":"string"},"operator_code":{"type":"string","example":"CM_MTN_MOMO","uniqueKey":"recipient.operator_code","typeLabel":"string"},"bank_name":{"type":"string","uniqueKey":"recipient.bank_name","typeLabel":"string"},"bank_code":{"type":"string","uniqueKey":"recipient.bank_code","typeLabel":"string"},"account_name":{"type":"string","uniqueKey":"recipient.account_name","typeLabel":"string"},"account_number":{"type":"string","uniqueKey":"recipient.account_number","typeLabel":"string"},"first_name":{"type":"string","uniqueKey":"recipient.first_name","typeLabel":"string"},"last_name":{"type":"string","uniqueKey":"recipient.last_name","typeLabel":"string"},"business_name":{"type":"string","uniqueKey":"recipient.business_name","typeLabel":"string"},"email":{"type":"string","format":"email","uniqueKey":"recipient.email","typeLabel":"string\u003cemail>"},"recipient_nationality_code":{"type":"string","minLength":2,"maxLength":2,"example":"CM","uniqueKey":"recipient.recipient_nationality_code","typeLabel":"string"},"address_line1":{"type":"string","uniqueKey":"recipient.address_line1","typeLabel":"string"},"city":{"type":"string","uniqueKey":"recipient.city","typeLabel":"string"}},"uniqueKey":"recipient","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","merchant_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","customer_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","quote_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","send_amount":"10000","send_currency":"XAF","receive_amount":"10000","receive_currency":"XAF","country_code":"CM","rail_type":"mobile_money","operator_code":"\u003cstring>","provider_reference":"\u003cstring>","wallet_impact":{},"pricing":{},"history":[{"status":"\u003cstring>","reason":"\u003cstring>","created_at":"2023-11-07T05:31:56Z"}],"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","status":"created","recipient":{"country_code":"CM","rail_type":"mobile_money","recipient_type":"individual","phone":"+237670000000","operator_code":"CM_MTN_MOMO","bank_name":"\u003cstring>","bank_code":"\u003cstring>","account_name":"\u003cstring>","account_number":"\u003cstring>","first_name":"\u003cstring>","last_name":"\u003cstring>","business_name":"\u003cstring>","email":"jsmith@example.com","recipient_nationality_code":"CM","address_line1":"\u003cstring>","city":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"6bc75e56-839b-4ef4-bfc9-750536b80c69":{"description":"Invalid body, missing field, expired quote, quote mismatch, or insufficient balance.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"quote_id is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"quote_id is required"}}}},"exampleType":"generated"}},"exampleType":"generated"},"94386e63-7892-406f-88c7-bb14f06d9371":{"description":"Missing, invalid, expired, or inactive API credentials.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"quote_id is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"quote_id is required"}}}},"exampleType":"generated"}},"exampleType":"generated"},"f16da207-e3cb-44b4-98e5-566b4c20267e":{"description":"Idempotency conflict or request with same key still processing.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"bad_request","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"quote_id is required","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_request","message":"quote_id is required"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"247e4d34-f8c6-4676-a29e-4109ef5042ec":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Public API key from the merchant dashboard.","scopes":[]},"ApiSecretAuth":{"type":"apiKey","in":"header","name":"X-Api-Secret","description":"Secret shown once when the API key is created.","scopes":[]}}},"servers":{"7bbac250-432e-4962-8cfa-ac5ff30e1bc9":{"url":"https://api.business.saapay.cm","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Key","description":"Public API key from the merchant dashboard.","scopes":[]},"schema":{"title":"X-Api-Key","type":"string","description":"Public API key from the merchant dashboard.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-Api-Key"},{"scheme":{"type":"apiKey","in":"header","name":"X-Api-Secret","description":"Secret shown once when the API key is created.","scopes":[]},"schema":{"title":"X-Api-Secret","type":"string","description":"Secret shown once when the API key is created.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiSecretAuth","name":"X-Api-Secret"}],"title":"ApiKeyAuth \u0026 ApiSecretAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"saapay","siteName":"Saapay Business","title":"Create payout - Saapay Business","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-22T09:07:50.806Z","gitLastModified":"2026-09-22T08:53:12.000Z","originalFileLocation":"api-reference/payouts/create-payout.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a quote-backed payout.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Saapay Business\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/saapay/GkVeou2XL1yxrxn6/_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/saapay/GkVeou2XL1yxrxn6/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/saapay/GkVeou2XL1yxrxn6/_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/saapay/GkVeou2XL1yxrxn6/_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/saapay/GkVeou2XL1yxrxn6/_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/saapay/GkVeou2XL1yxrxn6/_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/saapay/GkVeou2XL1yxrxn6/_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/saapay/GkVeou2XL1yxrxn6/_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/saapay/GkVeou2XL1yxrxn6/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create payout - Saapay Business\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a quote-backed payout.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Saapay Business\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.saapay.cm/api-reference/payouts/create-payout\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://saapay.mintlify.site/_mintlify/api/og/v2?division=Payouts\u0026amp;title=Create+payout\u0026amp;description=Create+a+quote-backed+payout.\u0026amp;theme=10783bcc9c225bad0a5fce0b\u0026amp;signature=af60fbf58c79a99c62397d709610aa8e0b1935dc73d8263d9617446cfba3f96f\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create payout - Saapay Business\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a quote-backed payout.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://saapay.mintlify.site/_mintlify/api/og/v2?division=Payouts\u0026amp;title=Create+payout\u0026amp;description=Create+a+quote-backed+payout.\u0026amp;theme=10783bcc9c225bad0a5fce0b\u0026amp;signature=af60fbf58c79a99c62397d709610aa8e0b1935dc73d8263d9617446cfba3f96f\">\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/saapay/GkVeou2XL1yxrxn6/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Saapay Business\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7135E8\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.saapay.cm/api-reference/payouts/create-payout\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/payouts/create-payout.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.saapay.cm/#organization\",\"name\":\"Saapay Business\",\"url\":\"https://developers.saapay.cm\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/saapay/_YVRfN6Mkf9LqInJ/logo/light.svg?fit=max\u0026auto=format\u0026n=_YVRfN6Mkf9LqInJ\u0026q=85\u0026s=43c39495b8a295ef0d7bfd01e9b0b14f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.saapay.cm#website\",\"name\":\"Saapay Business\",\"url\":\"https://developers.saapay.cm\",\"publisher\":{\"@id\":\"https://developers.saapay.cm/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.saapay.cm/api-reference/payouts/create-payout#webpage\",\"url\":\"https://developers.saapay.cm/api-reference/payouts/create-payout\",\"name\":\"Create payout\",\"description\":\"Create a quote-backed payout.\",\"dateModified\":\"2026-09-22T08:53:12.000Z\",\"isPartOf\":{\"@id\":\"https://developers.saapay.cm#website\"},\"breadcrumb\":{\"@id\":\"https://developers.saapay.cm/api-reference/payouts/create-payout#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.saapay.cm/api-reference/payouts/create-payout#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Saapay Business\",\"item\":\"https://developers.saapay.cm\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create payout\",\"item\":\"https://developers.saapay.cm/api-reference/payouts/create-payout\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.saapay.cm/api-reference/payouts/create-payout#apireference\",\"headline\":\"Create payout\",\"name\":\"Create payout\",\"description\":\"Create a quote-backed payout.\",\"url\":\"https://developers.saapay.cm/api-reference/payouts/create-payout\",\"mainEntityOfPage\":{\"@id\":\"https://developers.saapay.cm/api-reference/payouts/create-payout#webpage\"},\"dateModified\":\"2026-09-22T08:53:12.000Z\",\"publisher\":{\"@id\":\"https://developers.saapay.cm/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.saapay.cm#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Saapay Business\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Saapay Business\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/payouts/create-payout.md","siteName":"Saapay Business","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"Customers","pages":[{"title":"Create customer","openapi":"POST /customers","href":"/api-reference/customers/create-customer"},{"title":"Get customer","openapi":"GET /customers/{customer_id}","href":"/api-reference/customers/get-customer"}]},{"group":"Customer KYC","pages":[{"title":"Submit KYC documents","openapi":"POST /customers/{customer_id}/kyc","href":"/api-reference/customer-kyc/submit-kyc-documents"},{"title":"Get customer KYC status","openapi":"GET /customers/{customer_id}/kyc","href":"/api-reference/customer-kyc/get-customer-kyc-status"}]},{"group":"Quotes","pages":[{"title":"Create payin quote","openapi":"POST /quotes/payin","href":"/api-reference/quotes/create-payin-quote"},{"title":"Create payout quote","openapi":"POST /quotes/payout","href":"/api-reference/quotes/create-payout-quote"},{"title":"Create transfer quote","openapi":"POST /quotes/transfer","href":"/api-reference/quotes/create-transfer-quote"},{"title":"Get quote","openapi":"GET /quotes/{quote_id}","href":"/api-reference/quotes/get-quote"}]},{"group":"Payins","pages":[{"title":"Create payin","openapi":"POST /payins","href":"/api-reference/payins/create-payin"},{"title":"Get payin","description":"Retrieve a payin by ID.","openapi":"GET /payins/{payin_id}","href":"/api-reference/payins/get-payin"}]},{"group":"Payouts","pages":[{"title":"Create payout","openapi":"POST /payouts","href":"/api-reference/payouts/create-payout"},{"title":"Get payout","description":"Retrieve a payout by ID.","openapi":"GET /payouts/{payout_id}","href":"/api-reference/payouts/get-payout"}]},{"group":"Transfers","pages":[{"title":"Create transfer","openapi":"POST /transfers","href":"/api-reference/transfers/create-transfer"},{"title":"Get transfer","openapi":"GET /transfers/{transfer_id}","href":"/api-reference/transfers/get-transfer"},{"title":"Relaunch transfer payout","openapi":"POST /transfers/{transfer_id}/relaunch-payout","href":"/api-reference/transfers/relaunch-transfer-payout"}]}]}]},"basePath":"","title":"Create payout - Saapay Business","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","CodeSnippet-eoRjC4Le.js","getApiPlaygroundDisplay-CZyAPlR2.js","Page-Cr9IwkK7.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}