Move a balance from one of your wallets into another currency at a rate you see first.
A conversion debits one of your wallets and credits another in a different currency. Nothing leaves Payve. Use it to hold the currency you will pay out in.Before you start: a funded source wallet, and a key with the conversions:write scope.
Quote, then convert
1
Get a quote for a conversion
Create a quote with transactionType set to conversion.
What reaches the destination wallet, in minor units.
string | null
The exchange rate applied.
string
Payve’s fee, in minor units.
202 means accepted. The destination wallet is credited only when the conversion is successful.
Do not start a payout from the destination wallet until then.
Wallets
Payve creates the source and destination wallets if you do not have them. The source wallet must hold the amount.
Convert, or pay out across currencies?
You want to
Use
Hold another currency for later
A conversion.
Pay someone in another currency now
A payout with different source and destination currencies. Payve converts as part of it.
Get and list conversions
Request
Does
GET /v1/conversions/{id}
Returns one conversion, with a timeline in events.
GET /v1/conversions
Lists conversions. Filter with status, from, to, q; page with cursor.
POST /v1/conversions/{id}/resend-webhook
Sends a fresh event for a finished conversion. Needs conversions:write.
When it fails
Status and code
Cause
Fix
400 validation_idempotency_key_required
No Idempotency-Key header.
Send one.
403 forbidden
The key lacks conversions:write.
Use a key with the scope.
403 kyc_tier_insufficient
Your business is not verified.
Finish verification.
422 validation_missing_field
A field is missing, such as merchantReference.
Fix the fields named.
422 wallet_insufficient_funds
The source wallet cannot cover the amount.
Fund it, or convert less.
422 quote_expired
The quote is past its hold time.
Create a new quote.
409 quote_already_consumed
The quote was already used.
Create a new quote.
404 resource_not_found
No rate exists for that pair, or the quote is not yours.
Check the pair and the quote id.
A conversion can also be accepted and fail afterwards. You then receive conversion.failed. Check both wallet balances before you try again.
Cautions
Do not retry a conversion with a new idempotency key after a timeout. Retry with the same key.
A second conversion under a new key converts the money twice.
Use a merchantReference that names the purpose and date, such as treasury-2026-11-18. It
appears on your statement.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Payve","description":"Developer documentation for the Payve API: send, collect and convert money across African corridors.","colors":{"primary":"#2D4EDE","light":"#8FA2F5","dark":"#2340C4"},"logo":{"light":"/logo-light.png","dark":"/logo-dark.png","href":"https://payvehq.com"},"favicon":"/favicon.png","api":{"playground":{"display":"interactive","proxy":false},"examples":{"languages":["curl","javascript","python","php"]}},"navbar":{"links":[{"href":"mailto:support@payvehq.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.payvehq.com"}},"footer":{"links":[{"header":"Payve","items":[{"label":"Website","href":"https://payvehq.com"},{"label":"Dashboard","href":"https://app.payvehq.com"}]},{"header":"Help","items":[{"label":"Get help","href":"/support"},{"label":"Changelog","href":"/changelog"}]}]},"seo":{"metatags":{"canonical":"https://docs.payvehq.com"}},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"hasAudioNarration":false,"customDomains":[],"gitSource":{"type":"github","owner":"local","repo":"local","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"local","isBase":true},"buildId":"local","clientVersion":"0.0.4231"},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false,"isLoggedInCli":false},"customCss":[{"filePath":"style.css","content":":root{--sidebar-width: 14.5rem}#header .prose.text-lg{font-size:1rem;line-height:1.6}:root{--pva-bg: #ffffff;--pva-ink: #14172a;--pva-muted: #5b6078;--pva-line: #e4e6ef;--pva-soft: #f4f5fa;--pva-brand: #2d4ede;--pva-brand-ink: #ffffff}.dark{--pva-bg: #12141f;--pva-ink: #f4f5fa;--pva-muted: #a3a8bd;--pva-line: #2a2e42;--pva-soft: #1b1e2d;--pva-brand: #5b78f0;--pva-brand-ink: #0b0d17}#search-bar-entry [data-search-item=\"trigger-hint\"]{display:none}.pva-inline{display:inline-flex;flex:none;align-items:center;gap:5px;margin-left:8px;padding:3px 9px;border-radius:999px;background:var(--pva-brand);color:var(--pva-brand-ink);font-size:12px;font-weight:600;line-height:1.5;cursor:pointer}.pva-inline:hover{filter:brightness(1.1)}.pva-inline:focus-visible,.pva-send:focus-visible,.pva-close:focus-visible,.pva-chip:focus-visible{outline:2px solid var(--pva-brand);outline-offset:2px}.pva-overlay{position:fixed;inset:0;z-index:70;display:flex;justify-content:center;align-items:flex-start;padding:10vh 16px 16px;background:rgba(10, 12, 22, 0.45);backdrop-filter:blur(2px)}.pva-overlay[hidden]{display:none}.pva-panel{display:flex;flex-direction:column;width:min(640px, 100%);height:min(620px, 78vh);border:1px solid var(--pva-line);border-radius:16px;background:var(--pva-bg);color:var(--pva-ink);font-size:14px;line-height:1.55;box-shadow:0 24px 60px rgba(20, 23, 42, 0.32);overflow:hidden}.pva-head{display:flex;align-items:center;justify-content:space-between;padding:14px 16px;border-bottom:1px solid var(--pva-line)}.pva-head strong{display:block;font-size:15px}.pva-sub{color:var(--pva-muted);font-size:12px}.pva-close{width:30px;height:30px;border:0;border-radius:8px;background:transparent;color:var(--pva-muted);font-size:20px;line-height:1;cursor:pointer}.pva-close:hover{background:var(--pva-soft)}.pva-log{flex:1;display:flex;flex-direction:column;gap:10px;padding:16px;overflow-y:auto}.pva-welcome p{margin:0 0 10px;color:var(--pva-muted)}.pva-chip{display:block;width:100%;margin-bottom:8px;padding:9px 12px;border:1px solid var(--pva-line);border-radius:10px;background:transparent;color:var(--pva-ink);font:inherit;text-align:left;cursor:pointer}.pva-chip:hover{border-color:var(--pva-brand)}.pva-msg{max-width:92%;padding:10px 12px;border-radius:12px;overflow-wrap:anywhere}.pva-user{align-self:flex-end;background:var(--pva-brand);color:var(--pva-brand-ink)}.pva-bot{align-self:flex-start;background:var(--pva-soft)}.pva-wait{color:var(--pva-muted)}.pva-bot p{margin:0 0 8px}.pva-bot p:last-child{margin-bottom:0}.pva-list{margin:0 0 8px;padding-left:20px}.pva-bot code,.pva-code{font-family:ui-monospace, SFMono-Regular, Menlo, monospace;font-size:12.5px}.pva-bot code{padding:1px 5px;border-radius:5px;background:var(--pva-line)}.pva-code{margin:0 0 8px;padding:10px;border-radius:8px;background:var(--pva-bg);border:1px solid var(--pva-line);overflow-x:auto;white-space:pre}.pva-sources{display:flex;flex-wrap:wrap;gap:6px;margin-top:10px;padding-top:10px;border-top:1px solid var(--pva-line)}.pva-sources-label{width:100%;color:var(--pva-muted);font-size:12px}.pva-source{padding:4px 9px;border:1px solid var(--pva-line);border-radius:999px;background:var(--pva-bg);color:var(--pva-brand);font-size:12px;text-decoration:none}.pva-source:hover{border-color:var(--pva-brand)}.pva-form{display:flex;gap:8px;padding:12px 16px 8px;border-top:1px solid var(--pva-line)}.pva-input{flex:1;min-height:40px;max-height:120px;padding:9px 12px;border:1px solid var(--pva-line);border-radius:10px;background:var(--pva-bg);color:var(--pva-ink);font:inherit;resize:none}.pva-input:focus{outline:2px solid var(--pva-brand);outline-offset:0}.pva-send{padding:0 16px;border:0;border-radius:10px;background:var(--pva-brand);color:var(--pva-brand-ink);font:600 14px/1 inherit;cursor:pointer}.pva-send:disabled{opacity:0.5;cursor:default}.pva-foot{margin:0;padding:0 16px 12px;color:var(--pva-muted);font-size:11.5px}.pvs-overlay{position:fixed;inset:0;z-index:70;display:flex;justify-content:center;align-items:flex-start;padding:12vh 16px 16px;background:rgba(10, 12, 22, 0.45);backdrop-filter:blur(2px)}.pvs-overlay[hidden]{display:none}.pvs-box{display:flex;flex-direction:column;width:min(640px, 100%);max-height:70vh;border:1px solid var(--pva-line);border-radius:16px;background:var(--pva-bg);color:var(--pva-ink);box-shadow:0 24px 60px rgba(20, 23, 42, 0.32);overflow:hidden}.pvs-input{width:100%;padding:16px 18px;border:0;border-bottom:1px solid var(--pva-line);background:transparent;color:var(--pva-ink);font:inherit;font-size:16px;outline:none}.pvs-list{flex:1;padding:8px;overflow-y:auto}.pvs-empty{margin:0;padding:18px 10px;color:var(--pva-muted);font-size:14px}.pvs-row{display:block;padding:10px 12px;border-radius:10px;color:var(--pva-ink);text-decoration:none}.pvs-row strong{display:block;font-size:14px}.pvs-row span{display:block;margin-top:2px;color:var(--pva-muted);font-size:13px;line-height:1.45;overflow-wrap:anywhere}.pvs-on{background:var(--pva-soft);box-shadow:inset 2px 0 0 var(--pva-brand)}.pvs-foot{display:flex;align-items:center;justify-content:space-between;gap:12px;padding:10px 14px;border-top:1px solid var(--pva-line);color:var(--pva-muted);font-size:12px}.pvs-ask{padding:6px 12px;border:1px solid var(--pva-line);border-radius:999px;background:transparent;color:var(--pva-brand);font:600 12px/1 inherit;cursor:pointer}.pvs-ask:hover{border-color:var(--pva-brand)}"}]}
{"page":{"pagePath":"guides/conversions","slug":"/guides/conversions","pageMetadata":{"title":"Conversions","description":"Move a balance from one of your wallets into another currency at a rate you see first.","href":"/guides/conversions"},"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: \"Move a balance from one of your wallets into another currency at a rate you see first.\"\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`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,ParamField,ResponseField,Step,Steps,Table,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A conversion debits one of your wallets and credits another in a different currency. Nothing leaves Payve. Use it to hold the currency you will pay out in.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Before you start:`}),` a funded source wallet, and a key with the `,_jsx(_components.code,{children:`conversions:write`}),` scope.`]}),`\n`,_jsx(Heading,{level:`2`,id:`quote-then-convert`,children:`Quote, then convert`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Get a quote for a conversion`,children:[_jsxs(_components.p,{children:[`Create a `,_jsx(_components.a,{href:`/guides/quotes`,children:`quote`}),` with `,_jsx(_components.code,{children:`transactionType`}),` set to `,_jsx(_components.code,{children:`conversion`}),`.`]}),_jsx(CodeBlock,{numberOfLines:`9`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$PAYVE_API_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/quotes\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$PAYVE_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sourceCurrency\": \"NGN\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"destinationCurrency\": \"GHS\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 5000000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"transactionType\": \"conversion\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`Set `,_jsx(_components.code,{children:`transactionType`}),` to `,_jsx(_components.code,{children:`conversion`}),`. A quote created for a payout can be priced differently from the rate a conversion settles at.`]})})]}),_jsx(Step,{title:`Create the conversion`,children:_jsxs(_components.p,{children:[`Send the same currencies and amount with the `,_jsx(_components.code,{children:`quoteId`}),`.`]})}),_jsx(Step,{title:`Wait for the event`,children:_jsxs(_components.p,{children:[`Payve sends `,_jsx(_components.code,{children:`conversion.successful`}),` or `,_jsx(_components.code,{children:`conversion.failed`}),`.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`create-a-conversion`,children:`Create a conversion`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`POST /v1/conversions`})}),`\n`,_jsx(ParamField,{header:`Idempotency-Key`,type:`string`,required:true,id:`param-idempotency-key`,children:_jsx(_components.p,{children:`A unique key for this conversion. Reuse it on every retry.`})}),`\n`,_jsx(ParamField,{body:`sourceCurrency`,type:`string`,required:true,id:`param-source-currency`,children:_jsx(_components.p,{children:`The wallet to debit.`})}),`\n`,_jsx(ParamField,{body:`destinationCurrency`,type:`string`,required:true,id:`param-destination-currency`,children:_jsx(_components.p,{children:`The wallet to credit.`})}),`\n`,_jsx(ParamField,{body:`amount`,type:`integer`,required:true,id:`param-amount`,children:_jsxs(_components.p,{children:[`The amount in `,_jsx(_components.code,{children:`sourceCurrency`}),`, in minor units.`]})}),`\n`,_jsx(ParamField,{body:`merchantReference`,type:`string`,required:true,id:`param-merchant-reference`,children:_jsx(_components.p,{children:`Your own reference, up to 255 characters.`})}),`\n`,_jsx(ParamField,{body:`quoteId`,type:`string`,id:`param-quote-id`,children:_jsx(_components.p,{children:`A quote for the same currencies and amount.`})}),`\n`,_jsx(ParamField,{body:`metadata`,type:`object`,id:`param-metadata`,children:_jsx(_components.p,{children:`Your own key-value data.`})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`11`,language:`shellscript`,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:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$PAYVE_API_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/conversions\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$PAYVE_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Idempotency-Key: treasury-2026-11-18-ngn-ghs\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sourceCurrency\": \"NGN\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"destinationCurrency\": \"GHS\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\": 5000000,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"merchantReference\": \"treasury-2026-11-18\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quoteId\": \"qte_1a9c3e7b5d0f2846\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node`,numberOfLines:`16`,language:`javascript`,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:`javascript`,children:_jsxs(_components.code,{language:`javascript`,numberOfLines:`16`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` res`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` fetch`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`process`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`PAYVE_API_URL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"/v1/conversions`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` method:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'POST'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'x-api-key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` process`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`env`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`PAYVE_API_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Idempotency-Key'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'treasury-2026-11-18-ngn-ghs'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Content-Type'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'application/json'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` body:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` JSON`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`stringify`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sourceCurrency:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'NGN'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` destinationCurrency:`}),_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:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` amount:`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 5000000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` merchantReference:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'treasury-2026-11-18'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` quoteId:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` quote`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`id`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }),`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`});`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`conversion`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` res`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`json`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`17`,language:`python`,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:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`17`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` os, requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`res `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` requests.post(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'PAYVE_API_URL'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/v1/conversions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: os.environ[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"PAYVE_API_KEY\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Idempotency-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"treasury-2026-11-18-ngn-ghs\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` json`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"sourceCurrency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NGN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"destinationCurrency\"`}),_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:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`5000000`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"merchantReference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"treasury-2026-11-18\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"quoteId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: quote[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`],`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`conversion `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` res.json()[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`]})})})]}),`\n`,_jsx(CodeBlock,{filename:`Response · 202`,numberOfLines:`18`,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:`18`,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:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1860`}),_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:` \"publicId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"cnv_6e2b9a0d4c1f7385\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"pending\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"subStatus\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sourceCurrency\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NGN\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"destinationCurrency\"`}),_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:` \"sourceAmount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"5000000\"`}),_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:` \"destinationAmount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"46500\"`}),_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:` \"rate\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0.0093000000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"fee\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"merchantReference\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"treasury-2026-11-18\"`}),_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:` \"quoteId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"qte_1a9c3e7b5d0f2846\"`}),_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:` \"userMessage\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"createdAt\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-11-18T12:00:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(ResponseField,{name:`id`,type:`integer`,id:`param-id`,children:_jsxs(_components.p,{children:[`Use this in URLs: `,_jsx(_components.code,{children:`GET /v1/conversions/{id}`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`publicId`,type:`string`,id:`param-public-id`,children:_jsxs(_components.p,{children:[`The `,_jsx(_components.code,{children:`cnv_`}),` id.`]})}),`\n`,_jsx(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`processing`}),`, `,_jsx(_components.code,{children:`successful`}),` or `,_jsx(_components.code,{children:`failed`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`sourceAmount`,type:`string`,id:`param-source-amount`,children:_jsx(_components.p,{children:`What leaves the source wallet, in minor units.`})}),`\n`,_jsx(ResponseField,{name:`destinationAmount`,type:`string`,id:`param-destination-amount`,children:_jsx(_components.p,{children:`What reaches the destination wallet, in minor units.`})}),`\n`,_jsx(ResponseField,{name:`rate`,type:`string | null`,id:`param-rate`,children:_jsx(_components.p,{children:`The exchange rate applied.`})}),`\n`,_jsx(ResponseField,{name:`fee`,type:`string`,id:`param-fee`,children:_jsx(_components.p,{children:`Payve’s fee, in minor units.`})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`202`}),` means accepted. The destination wallet is credited only when the conversion is `,_jsx(_components.code,{children:`successful`}),`.\nDo not start a payout from the destination wallet until then.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`wallets`,children:`Wallets`}),`\n`,_jsx(_components.p,{children:`Payve creates the source and destination wallets if you do not have them. The source wallet must hold the amount.`}),`\n`,_jsx(Heading,{level:`2`,id:`convert-or-pay-out-across-currencies`,children:`Convert, or pay out across currencies?`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`You want to`}),_jsx(_components.th,{children:`Use`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Hold another currency for later`}),_jsx(_components.td,{children:`A conversion.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Pay someone in another currency now`}),_jsxs(_components.td,{children:[`A `,_jsx(_components.a,{href:`/guides/payouts#cross-currency-payouts`,children:`payout`}),` with different source and destination currencies. Payve converts as part of it.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`get-and-list-conversions`,children:`Get and list conversions`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Request`}),_jsx(_components.th,{children:`Does`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/conversions/{id}`})}),_jsxs(_components.td,{children:[`Returns one conversion, with a timeline in `,_jsx(_components.code,{children:`events`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/conversions`})}),_jsxs(_components.td,{children:[`Lists conversions. Filter with `,_jsx(_components.code,{children:`status`}),`, `,_jsx(_components.code,{children:`from`}),`, `,_jsx(_components.code,{children:`to`}),`, `,_jsx(_components.code,{children:`q`}),`; page with `,_jsx(_components.code,{children:`cursor`}),`.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`POST /v1/conversions/{id}/resend-webhook`})}),_jsxs(_components.td,{children:[`Sends a fresh event for a finished conversion. Needs `,_jsx(_components.code,{children:`conversions:write`}),`.`]})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`when-it-fails`,children:`When it fails`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status and code`}),_jsx(_components.th,{children:`Cause`}),_jsx(_components.th,{children:`Fix`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`400 validation_idempotency_key_required`})}),_jsxs(_components.td,{children:[`No `,_jsx(_components.code,{children:`Idempotency-Key`}),` header.`]}),_jsx(_components.td,{children:`Send one.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`403 forbidden`})}),_jsxs(_components.td,{children:[`The key lacks `,_jsx(_components.code,{children:`conversions:write`}),`.`]}),_jsx(_components.td,{children:`Use a key with the scope.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`403 kyc_tier_insufficient`})}),_jsx(_components.td,{children:`Your business is not verified.`}),_jsx(_components.td,{children:`Finish verification.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`422 validation_missing_field`})}),_jsxs(_components.td,{children:[`A field is missing, such as `,_jsx(_components.code,{children:`merchantReference`}),`.`]}),_jsx(_components.td,{children:`Fix the fields named.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`422 wallet_insufficient_funds`})}),_jsx(_components.td,{children:`The source wallet cannot cover the amount.`}),_jsx(_components.td,{children:`Fund it, or convert less.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`422 quote_expired`})}),_jsx(_components.td,{children:`The quote is past its hold time.`}),_jsx(_components.td,{children:`Create a new quote.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`409 quote_already_consumed`})}),_jsx(_components.td,{children:`The quote was already used.`}),_jsx(_components.td,{children:`Create a new quote.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`404 resource_not_found`})}),_jsx(_components.td,{children:`No rate exists for that pair, or the quote is not yours.`}),_jsx(_components.td,{children:`Check the pair and the quote id.`})]})]})]}),`\n`,_jsxs(_components.p,{children:[`A conversion can also be accepted and fail afterwards. You then receive `,_jsx(_components.code,{children:`conversion.failed`}),`. Check both wallet balances before you try again.`]}),`\n`,_jsx(Heading,{level:`2`,id:`cautions`,children:`Cautions`}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Do not retry a conversion with a new idempotency key after a timeout.`}),` Retry with the same key.\nA second conversion under a new key converts the money twice.`]})}),`\n`,_jsx(Tip,{children:_jsxs(_components.p,{children:[`Use a `,_jsx(_components.code,{children:`merchantReference`}),` that names the purpose and date, such as `,_jsx(_components.code,{children:`treasury-2026-11-18`}),`. It\nappears on your statement.`]})})]})}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":"Conversions","description":"Move a balance from one of your wallets into another currency at a rate you see first.","href":"/guides/conversions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Quote, then convert","slug":"quote-then-convert","depth":2,"children":[]},{"title":"Create a conversion","slug":"create-a-conversion","depth":2,"children":[]},{"title":"Wallets","slug":"wallets","depth":2,"children":[]},{"title":"Convert, or pay out across currencies?","slug":"convert-or-pay-out-across-currencies","depth":2,"children":[]},{"title":"Get and list conversions","slug":"get-and-list-conversions","depth":2,"children":[]},{"title":"When it fails","slug":"when-it-fails","depth":2,"children":[]},{"title":"Cautions","slug":"cautions","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/docs.payvehq.com/d641fece004526ca/assistant.js","/_mintlify/custom/docs.payvehq.com/b79553cf5a1ed2d6/search-index.js","/_mintlify/custom/docs.payvehq.com/3ca8c8799f334a99/search.js"],"subdomain":"docs.payvehq.com","siteName":"Payve","title":"Conversions - Payve","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"guides/conversions.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=\"Move a balance from one of your wallets into another currency at a rate you see first.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Payve\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/favicons/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicons/favicon-32x32.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/favicons/favicon-16x16.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/favicons/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"Conversions - Payve\">\u003cmeta data-mint-head property=\"og:description\" content=\"Move a balance from one of your wallets into another currency at a rate you see first.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Payve\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.payvehq.com/guides/conversions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"http://docs.payvehq.com/_mintlify/og/guides/conversions.png\">\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=\"Conversions - Payve\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Move a balance from one of your wallets into another currency at a rate you see first.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"http://docs.payvehq.com/_mintlify/og/guides/conversions.png\">\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=\"/favicons/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Payve\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2D4EDE\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.payvehq.com/guides/conversions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/conversions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Payve\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Payve\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/guides/conversions.md","siteName":"Payve","nav":{"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"Introduction","href":""},{"title":"Quickstart","href":"/quickstart"},{"title":"Get your API keys","href":"/get-started/api-keys"},{"title":"The dashboard for developers","sidebarTitle":"Dashboard tour","href":"/dashboard/overview"},{"title":"Authentication","href":"/get-started/authentication"},{"title":"Environments","href":"/get-started/environments"},{"title":"Going live","href":"/get-started/going-live"},{"title":"Requests and responses","href":"/essentials/requests-and-responses"},{"title":"Idempotency","href":"/essentials/idempotency"},{"title":"Statuses","href":"/essentials/statuses"},{"title":"Errors","href":"/essentials/errors"},{"title":"Rate limits","href":"/essentials/rate-limits"},{"title":"Coverage","href":"/essentials/coverage"}]},{"group":"Payout","icon":"send","pages":[{"title":"Quotes","href":"/guides/quotes"},{"title":"Payouts","href":"/guides/payouts"},{"title":"Bulk payouts","href":"/guides/bulk-payouts"},{"title":"Name check and institutions","sidebarTitle":"Name check","href":"/guides/name-check"},{"title":"Beneficiaries","href":"/guides/beneficiaries"}]},{"group":"Collection","icon":"download","pages":[{"title":"Pay-ins and virtual accounts","sidebarTitle":"Collections","href":"/guides/payins"},{"title":"Payment links and hosted checkout","sidebarTitle":"Payment links","href":"/guides/payment-links"},{"title":"Refunds","description":"Return a pay-in to the payer.","href":"/guides/refunds"}]},{"group":"Conversion","icon":"arrow-left-right","pages":[{"title":"Conversions","href":"/guides/conversions"}]},{"group":"Wallet","icon":"wallet","pages":[{"title":"Wallets and balances","description":"Read your balances, create a wallet in a new currency, and get a virtual account to fund it.","sidebarTitle":"Wallets","href":"/guides/wallets"},{"title":"Statements","href":"/guides/statements"}]},{"group":"Webhooks","icon":"webhook","pages":[{"title":"Webhooks overview","href":"/webhooks/overview"},{"title":"Add a webhook endpoint","sidebarTitle":"Add an endpoint","href":"/dashboard/webhook-endpoints"},{"title":"Verify signatures","href":"/webhooks/verify-signatures"},{"title":"Handle events safely","href":"/webhooks/handling-events"},{"title":"Webhook event object","href":"/webhooks/event-samples"},{"title":"Delivery and retries","href":"/webhooks/delivery-and-retries"},{"title":"Track events","href":"/dashboard/track-events"},{"title":"Resend a webhook","href":"/dashboard/resend-webhooks"}]},{"group":"Testing","icon":"flask-conical","pages":[{"title":"Test in the sandbox","href":"/testing/sandbox"}]},{"group":"Resources","icon":"life-buoy","pages":[{"title":"Use Payve with AI","sidebarTitle":"Ask AI","href":"/ai"},{"title":"Changelog","href":"/changelog"},{"title":"Get help","href":"/support"}]}]},{"tab":"API reference","icon":"code","pages":[{"title":"API reference","href":"/api-reference/overview"}]},{"tab":"MCP","icon":"bot","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"Conversions - Payve","buildId":"6a8a261234c2","dynamics":[],"chunks":[]}