This endpoint starts a payment transaction by creating a payment quote. The quote includes fees, exchange rates, and total amount to collect. After reviewing the quote, you must call the confirm endpoint to execute the payment.
Payments require a two-step process: first initiate to get a quote, then complete to execute the payment. Quotes expire after 5 minutes.
{"docsConfig":{"theme":"willow","$schema":"https://mintlify.com/docs.json","name":"Pooler Developer Documentation","colors":{"primary":"#2C1DFF","light":"#2C1DFF","dark":"#2C1DFF"},"logo":{"light":"https://mintcdn.com/pooler-7b8947fa/wPD9odAEA-5af3Zu/logo/Logo.svg?fit=max\u0026auto=format\u0026n=wPD9odAEA-5af3Zu\u0026q=85\u0026s=2422a4a514b0ac48cdb5636ef9b72568","dark":"https://mintcdn.com/pooler-7b8947fa/wPD9odAEA-5af3Zu/logo/Logo_Transparent.svg?fit=max\u0026auto=format\u0026n=wPD9odAEA-5af3Zu\u0026q=85\u0026s=7b1ce54b1c2bdea097feab74687e34e6"},"favicon":"/favicon.svg","api":{"playground":{}},"navbar":{"links":[{"label":"Support","href":"mailto:tech@usepooler.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.usepooler.com"}},"footer":{"socials":{"x":"https://x.com/usepooler","github":"https://github.com/usepooler","linkedin":"https://linkedin.com/company/usepooler"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"]},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pooler-7b8947fa","hasAudioNarration":false,"actualSubdomain":"pooler-7b8947fa","customDomains":["docs.usepooler.com"],"gitSource":{"type":"github","owner":"pooler-inc","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a22015f2e8b61e2a4ba3a73","collectionId":"f147e0a0-dac6-449b-8f84-8e462fe052d0","schemaVersion":"v2"},"entitlements":{},"buildId":"6a22015f2e8b61e2a4ba3a73:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API reference","count":25},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Payments","count":10},{"language":"default","tag":"Accounts","count":5},{"language":"default","tag":"Recipients","count":5},{"language":"default","tag":"Business","count":4},{"language":"default","tag":"Webhooks","count":4},{"language":"default","tag":"Utilities","count":3},{"language":"default","tag":"Getting started","count":3},{"language":"default","tag":"API Changelog","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:'Arcadia Display';src:url(https://res.cloudinary.com/dvc4kia8l/raw/upload/v1764089046/ArcadiaDisplay-Variable_uzx6io.woff2) format('woff2');font-weight:100;font-style:normal;font-display:swap}@font-face{font-family:'Arcadia Text';src:url(https://res.cloudinary.com/dvc4kia8l/raw/upload/v1764089046/ArcadiaText-Variable_ujfr4i.woff2) format('woff2');font-weight:100;font-style:normal;font-display:swap}@font-face{font-family:'Graphik';src:url(https://res.cloudinary.com/dvc4kia8l/raw/upload/v1752578408/Graphik-Regular_2_bzzwzc.ttf) format('truetype');font-weight:400;font-style:normal;font-display:swap}body{font-size:17px;background-color:#242e34;color:#f2f2f2;font-family:'Arcadia Text',system-ui,sans-serif}h1,h2,h3,h4,h5,h6{font-family:'Graphik','Arcadia Display',system-ui,sans-serif}h1{font-size:21px}h2{font-size:20px}p{font-size:15px}li{font-size:14px}"}],"page":{"pagePath":"api-reference/payments/create-payment","slug":"/api-reference/payments/create-payment","pageMetadata":{"title":"Create Payment","openapi":"POST /payments/initiate","description":"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.","href":"/api-reference/payments/create-payment"},"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: \"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.\"\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={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,strong:`strong`,..._provideComponents(),...props.components},{Heading,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the `,_jsx(_components.a,{href:`/api-reference/payments/confirm-payment`,children:`Confirm Payment`}),` endpoint.`]}),`\n`,_jsx(Heading,{level:`2`,id:`overview`,children:`Overview`}),`\n`,_jsx(_components.p,{children:`This endpoint starts a payment transaction by creating a payment quote. The quote includes fees, exchange rates, and total amount to collect. After reviewing the quote, you must call the confirm endpoint to execute the payment.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Payments require a two-step process: first initiate to get a quote, then complete to execute the payment. Quotes expire after 5 minutes.`})}),`\n`,_jsx(Heading,{level:`2`,id:`payment-flow`,children:`Payment Flow`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Initiate Payment`}),` - Call this endpoint with payment details to get a quote`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Review Quote`}),` - Check the fees, exchange rates, and total amount`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Confirm Payment`}),` - Use the `,_jsx(_components.code,{children:`quote_id`}),` and `,_jsx(_components.code,{children:`reference`}),` from the response to complete the payment`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use the `,_jsx(_components.code,{children:`Idempotency-Key`}),` header to prevent duplicate payments if you need to retry the request.`]})})]})}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":"Create Payment","openapi":"POST /payments/initiate","description":"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.","href":"/api-reference/payments/create-payment"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Overview","slug":"overview","depth":2,"children":[]},{"title":"Payment Flow","slug":"payment-flow","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create Payment","description":"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.","operationId":"createPayment","tags":["Payments"],"requestBody":"ef543fe8-6957-4e43-990d-c6093c6d576c","responses":{"200":"28eb7bfc-0913-4284-8947-627b733e3042"},"method":"post","type":"path","servers":["fe6386ee-810b-4042-9795-adcc35e1154b","6cc84a51-dc26-4f41-9869-98958f2aa66a"],"security":["0f5af490-389c-44b4-b67d-3041519c62d1"],"path":"/payments/initiate","baseUrlOptions":["https://api.usepooler.com","https://sandbox.usepooler.com"],"title":"Create Payment","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["amount","currency","recipient_id"],"properties":{"amount":{"type":"number","description":"Payment amount","isRequired":true,"uniqueKey":"amount","typeLabel":"number"},"currency":{"type":"string","description":"Currency code (e.g., NGN, USD)","isRequired":true,"uniqueKey":"currency","typeLabel":"string"},"recipient_id":{"type":"string","format":"uuid","description":"ID of the payment recipient","isRequired":true,"uniqueKey":"recipient_id","typeLabel":"string\u003cuuid>"},"description":{"type":"string","description":"Payment description","uniqueKey":"description","typeLabel":"string"},"reference":{"type":"string","description":"Unique reference for the payment","uniqueKey":"reference","typeLabel":"string"},"transaction_type":{"type":"string","description":"Type of transaction (e.g., inter)","uniqueKey":"transaction_type","typeLabel":"string"},"transaction_category":{"type":"string","description":"Transaction category (e.g., transfer)","uniqueKey":"transaction_category","typeLabel":"string"},"transaction_tags":{"type":"string","description":"Comma-separated tags for the transaction","uniqueKey":"transaction_tags","typeLabel":"string"},"transaction_notes":{"type":"string","description":"Additional notes for the transaction","uniqueKey":"transaction_notes","typeLabel":"string"},"channel":{"type":"string","description":"Payment channel (e.g., bank)","uniqueKey":"channel","typeLabel":"string"},"sub_type":{"type":"string","description":"Transaction sub-type (e.g., transfer)","uniqueKey":"sub_type","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"amount":123,"currency":"\u003cstring>","recipient_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","description":"\u003cstring>","reference":"\u003cstring>","transaction_type":"\u003cstring>","transaction_category":"\u003cstring>","transaction_tags":"\u003cstring>","transaction_notes":"\u003cstring>","channel":"\u003cstring>","sub_type":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"28eb7bfc-0913-4284-8947-627b733e3042":{"description":"Payment initiated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"},"stan":{"type":"string","format":"uuid","uniqueKey":"stan","typeLabel":"string\u003cuuid>"},"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"reference":{"type":"string","uniqueKey":"data.reference","typeLabel":"string"},"status":{"type":"string","enum":["pending","completed","failed"],"uniqueKey":"data.status","typeLabel":"enum\u003cstring>"},"amount":{"type":"string","uniqueKey":"data.amount","typeLabel":"string"},"currency":{"type":"string","uniqueKey":"data.currency","typeLabel":"string"},"description":{"type":"string","uniqueKey":"data.description","typeLabel":"string"},"type":{"type":"string","uniqueKey":"data.type","typeLabel":"string"},"sub_type":{"type":"string","uniqueKey":"data.sub_type","typeLabel":"string"},"category":{"type":"string","uniqueKey":"data.category","typeLabel":"string"},"transaction_date":{"type":"string","format":"date-time","uniqueKey":"data.transaction_date","typeLabel":"string\u003cdate-time>"},"tags":{"type":"string","uniqueKey":"data.tags","typeLabel":"string"},"is_reversed":{"type":"boolean","uniqueKey":"data.is_reversed","typeLabel":"boolean"},"is_completed":{"type":"boolean","uniqueKey":"data.is_completed","typeLabel":"boolean"},"channel":{"type":"string","uniqueKey":"data.channel","typeLabel":"string"},"notes":{"type":"string","uniqueKey":"data.notes","typeLabel":"string"},"created_at":{"type":"string","format":"date-time","uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"data","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"\u003cstring>","stan":"3c90c3cc-0d44-4b50-8888-8dd25736052a","data":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","reference":"\u003cstring>","status":"pending","amount":"\u003cstring>","currency":"\u003cstring>","description":"\u003cstring>","type":"\u003cstring>","sub_type":"\u003cstring>","category":"\u003cstring>","transaction_date":"2023-11-07T05:31:56Z","tags":"\u003cstring>","is_reversed":true,"is_completed":true,"channel":"\u003cstring>","notes":"\u003cstring>","created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"0f5af490-389c-44b4-b67d-3041519c62d1":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication. Include your API key in the Authorization header as: Bearer {your_api_key}","scopes":[]}}},"servers":{"fe6386ee-810b-4042-9795-adcc35e1154b":{"url":"https://api.usepooler.com","description":"Production server"},"6cc84a51-dc26-4f41-9869-98958f2aa66a":{"url":"https://sandbox.usepooler.com","description":"Sandbox server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token authentication. Include your API key in the Authorization header as: Bearer {your_api_key}","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer token authentication. Include your API key in the Authorization header as: Bearer {your_api_key}","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"pooler-7b8947fa","siteName":"Pooler Developer Documentation","title":"Create Payment - Pooler Developer Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-14T10:55:35.175Z","originalFileLocation":"api-reference/payments/create-payment.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=\"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Pooler Developer Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Payment - Pooler Developer Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Pooler Developer Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usepooler.com/api-reference/payments/create-payment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pooler-7b8947fa.mintlify.app/_mintlify/api/og/v2?division=Payments\u0026amp;title=Create+Payment\u0026amp;description=Initiate+a+new+payment+transaction.+This+endpoint+creates+a+payment+quote+that+must+be+confirmed+using+the+complete+endpoint.\u0026amp;theme=b7e1cf094bd27b4758268d94\u0026amp;signature=38aac28fc0dddfd82d77348a6adb5eec1b99b4597d10496a7ab56f0428431986\">\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 Payment - Pooler Developer Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pooler-7b8947fa.mintlify.app/_mintlify/api/og/v2?division=Payments\u0026amp;title=Create+Payment\u0026amp;description=Initiate+a+new+payment+transaction.+This+endpoint+creates+a+payment+quote+that+must+be+confirmed+using+the+complete+endpoint.\u0026amp;theme=b7e1cf094bd27b4758268d94\u0026amp;signature=38aac28fc0dddfd82d77348a6adb5eec1b99b4597d10496a7ab56f0428431986\">\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/pooler-7b8947fa/V_gm_x2JeKOiGcgp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Pooler Developer Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2C1DFF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usepooler.com/api-reference/payments/create-payment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/payments/create-payment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usepooler.com/#organization\",\"name\":\"Pooler Developer Documentation\",\"url\":\"https://docs.usepooler.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/pooler-7b8947fa/wPD9odAEA-5af3Zu/logo/Logo.svg?fit=max\u0026auto=format\u0026n=wPD9odAEA-5af3Zu\u0026q=85\u0026s=2422a4a514b0ac48cdb5636ef9b72568\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usepooler.com#website\",\"name\":\"Pooler Developer Documentation\",\"url\":\"https://docs.usepooler.com\",\"publisher\":{\"@id\":\"https://docs.usepooler.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usepooler.com/api-reference/payments/create-payment#webpage\",\"url\":\"https://docs.usepooler.com/api-reference/payments/create-payment\",\"name\":\"Create Payment\",\"description\":\"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.\",\"dateModified\":\"2026-01-14T10:55:35.175Z\",\"isPartOf\":{\"@id\":\"https://docs.usepooler.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usepooler.com/api-reference/payments/create-payment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usepooler.com/api-reference/payments/create-payment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Pooler Developer Documentation\",\"item\":\"https://docs.usepooler.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Payment\",\"item\":\"https://docs.usepooler.com/api-reference/payments/create-payment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.usepooler.com/api-reference/payments/create-payment#apireference\",\"headline\":\"Create Payment\",\"name\":\"Create Payment\",\"description\":\"Initiate a new payment transaction. This endpoint creates a payment quote that must be confirmed using the complete endpoint.\",\"url\":\"https://docs.usepooler.com/api-reference/payments/create-payment\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usepooler.com/api-reference/payments/create-payment#webpage\"},\"dateModified\":\"2026-01-14T10:55:35.175Z\",\"publisher\":{\"@id\":\"https://docs.usepooler.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usepooler.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Pooler Developer Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Pooler Developer Documentation","nav":{"global":{},"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/getting-started/introduction"}]},{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Business","pages":[{"title":"Get Account Details","openapi":"GET /business-details","href":"/api-reference/business/get-account-details"},{"title":"Get Merchant Coverages","openapi":"GET /business/coverages","description":"Retrieve a list of currency coverages available for your merchant account.","href":"/api-reference/business/get-merchant-coverages"}]},{"group":"Payments","pages":[{"title":"Create Payment","openapi":"POST /payments/initiate","href":"/api-reference/payments/create-payment"},{"title":"Confirm Payment","openapi":"POST /payments/complete","description":"Complete a payment transaction that was previously initiated. Requires the quote_id and reference from the initiate response.","href":"/api-reference/payments/confirm-payment"},{"title":"Reject Payment","openapi":"POST /payments/reject","href":"/api-reference/payments/reject-payment"},{"title":"Query Payment Status","openapi":"GET /payments/tsq/{reference}","href":"/api-reference/payments/query-payment-status"},{"title":"List Payments","openapi":"GET /payments","href":"/api-reference/payments/list-payments"},{"title":"Retrieve Payment","openapi":"GET /payments/{id}","href":"/api-reference/payments/retrieve-payment"}]},{"group":"Accounts","pages":[{"title":"Create Individual Virtual Account","openapi":"POST /accounts/individual-virtual-accounts","href":"/api-reference/accounts/create-individual-virtual-account"},{"title":"Create Corporate Virtual Account","openapi":"POST /accounts/corporate-virtual-accounts","href":"/api-reference/accounts/create-corporate-virtual-account"},{"title":"List Virtual Accounts","openapi":"GET /accounts/virtual-accounts","href":"/api-reference/accounts/list-virtual-accounts"},{"title":"Retrieve Virtual Account","openapi":"GET /accounts/virtual-accounts/{id}","href":"/api-reference/accounts/retrieve-virtual-account"},{"title":"Payout Virtual Account","openapi":"POST /accounts/virtual-accounts/payout","href":"/api-reference/accounts/payout-virtual-account"}]},{"group":"Recipients","pages":[{"title":"Create Recipient","openapi":"POST /payments/recipients","href":"/api-reference/recipients/create-recipient"},{"title":"Edit Recipient","openapi":"PUT /payments/recipients/{id}","href":"/api-reference/recipients/edit-recipient"},{"title":"List Recipients","openapi":"GET /payments/recipients","href":"/api-reference/recipients/list-recipients"},{"title":"Retrieve Recipient","openapi":"GET /payments/recipients/{id}","href":"/api-reference/recipients/retrieve-recipient"}]},{"group":"Webhooks","pages":[{"title":"List Events","openapi":"GET /webhooks/events","href":"/api-reference/webhooks/list-events"},{"title":"Trigger Events","openapi":"POST /webhooks/events/trigger/{id}","href":"/api-reference/webhooks/trigger-events"}]},{"group":"FX","pages":[{"title":"Get Quotes","openapi":"GET /fx/quotes","href":"/api-reference/fx/get-quotes"},{"title":"Get Rates","openapi":"GET /fx/rates","href":"/api-reference/fx/get-rates"}]},{"group":"Utilities","pages":[{"title":"Nigerian Name Enquiry","openapi":"GET /utils/nigerian-name-enquiry","href":"/api-reference/utilities/nigerian-name-enquiry"},{"title":"Get Supported Corridors","openapi":"GET /utils/country-coverage","href":"/api-reference/utilities/get-supported-corridors"},{"title":"Global Institution List","openapi":"GET /utils/global-institution-list","href":"/api-reference/utilities/global-institution-list"}]}]},{"tab":"API Changelog","pages":[{"title":"API Changelog","href":"/api-changelog/introduction"}]}]},"title":"Create Payment - Pooler Developer Documentation","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}