List the banks and mobile money operators you can pay, and look up the name on an account before you pay it.
A name check asks the bank or operator who owns an account. Run it before the first payout to any new recipient and show the name to your user.
A payout to a real account that belongs to the wrong person is not something Payve can reverse.
The name check is your chance to catch a mistyped account number.
Two endpoints cover everything on this page:
You want to
Call
List banks, mobile money operators, or both
GET /v1/payouts/institutions
Check a bank account or a mobile number
GET /v1/payouts/validate-account
List institutions
GET /v1/payouts/institutions?country=NG&type=bank
string
default:"NG"
Two-letter country code: NG, GH or KE.
string
bank or mobile_money. Leave it out to get both in one list.
const params = new URLSearchParams({ type: 'bank', bankCode: '058', accountNumber: '0123456789', country: 'NG',});const res = await fetch(`${process.env.PAYVE_API_URL}/v1/payouts/validate-account?${params}`, { headers: { 'x-api-key': process.env.PAYVE_API_KEY },});const { data } = await res.json();// Show data.accountName to your user and ask them to confirm.
import os, requestsres = requests.get( f"{os.environ['PAYVE_API_URL']}/v1/payouts/validate-account", headers={"x-api-key": os.environ["PAYVE_API_KEY"]}, params={"type": "bank", "bankCode": "058", "accountNumber": "0123456789", "country": "NG"},)data = res.json()["data"]# Show data["accountName"] to your user and ask them to confirm.
accountName can be null when the bank returns no name. Treat that as “not confirmed”, not as a pass.A Nigerian account number must be exactly 10 digits. Anything else returns 422 validation_invalid_beneficiary without asking the bank.
valid is false when the number is not between 9 and 15 digits. accountName is the subscriber’s name when the operator returns one, and is often null.
valid: true with accountName: null confirms only that the number is well-formed. It does
not confirm who owns the wallet. Have your user double-check the number.
Use the result
1
Show the name
Display accountName exactly as returned.
2
Ask your user to confirm
Let them say “yes, that is who I am paying” before you create the payout.
3
Send the payout
Put the confirmed name in beneficiary.holderName.
Do not auto-reject on a name that differs slightly from what your user typed. Banks abbreviate,
reorder and truncate names. Show the bank’s version and let a person decide.
In the sandbox
Name checks return made-up names. The same account number always returns the same name. Some account numbers trigger scripted results. See Test in the sandbox.
When it fails
Status and code
Cause
Fix
422
A field the chosen type needs is missing.
Send the fields listed above.
422 validation_invalid_beneficiary
An NGN account number that is not 10 digits.
Correct the number.
5xx
The bank did not answer.
Try again. Do not skip the check.
{"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/name-check","slug":"/guides/name-check","pageMetadata":{"title":"Name check and institutions","sidebarTitle":"Name check","description":"List the banks and mobile money operators you can pay, and look up the name on an account before you pay it.","href":"/guides/name-check"},"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: \"List the banks and mobile money operators you can pay, and look up the name on an account before you pay it.\"\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`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Note,ParamField,Step,Steps,Tab,Table,Tabs,Tip,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`A name check asks the bank or operator who owns an account. Run it before the first payout to any new recipient and show the name to your user.`}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`A payout to a real account that belongs to the wrong person is not something Payve can reverse.\nThe name check is your chance to catch a mistyped account number.`})}),`\n`,_jsx(_components.p,{children:`Two endpoints cover everything on this page:`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`You want to`}),_jsx(_components.th,{children:`Call`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List banks, mobile money operators, or both`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/payouts/institutions`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Check a bank account or a mobile number`}),_jsx(_components.td,{children:_jsx(_components.code,{children:`GET /v1/payouts/validate-account`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`list-institutions`,children:`List institutions`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`GET /v1/payouts/institutions?country=NG\u0026type=bank`})}),`\n`,_jsx(ParamField,{query:`country`,type:`string`,default:`NG`,id:`param-country`,children:_jsxs(_components.p,{children:[`Two-letter country code: `,_jsx(_components.code,{children:`NG`}),`, `,_jsx(_components.code,{children:`GH`}),` or `,_jsx(_components.code,{children:`KE`}),`.`]})}),`\n`,_jsx(ParamField,{query:`type`,type:`string`,id:`param-type`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`bank`}),` or `,_jsx(_components.code,{children:`mobile_money`}),`. Leave it out to get both in one list.`]})}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Banks`,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_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/payouts/institutions?country=NG\u0026type=bank\"`}),_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:`\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Mobile money operators`,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_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/payouts/institutions?country=GH\u0026type=mobile_money\"`}),_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:`\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Both`,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_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/payouts/institutions?country=GH\"`}),_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:`\"`})]}),`\n`]})})})]}),`\n`,_jsxs(_components.p,{children:[`Every item carries a `,_jsx(_components.code,{children:`type`}),`, so you can tell the two kinds apart in one list.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`A bank`,id:`a-bank`,children:[_jsx(CodeBlock,{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`,_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`14`}),_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:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NG\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Guaranty Trust Bank\"`}),_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:` \"shortName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GTBank\"`}),_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:` \"bankCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"058\"`}),_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:` \"swiftCode\"`}),_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:` \"bic\"`}),_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:` \"branchCode\"`}),_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:` \"capabilities\"`}),_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:` \"enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"metadata\"`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bank\"`})]}),`\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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[`Use `,_jsx(_components.code,{children:`bankCode`}),` in a name check and in a payout.`]})]}),_jsxs(Tab,{title:`A mobile money operator`,id:`a-mobile-money-operator`,children:[_jsx(CodeBlock,{numberOfLines:`12`,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:`12`,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`,_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:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_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:` \"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"GH\"`}),_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:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"MTN\"`}),_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:` \"prefixes\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"024\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"054\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"055\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"059\"`}),_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:` \"enabled\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"mobile_money\"`})]}),`\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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`prefixes`}),` lists the number prefixes that belong to the operator. Use `,_jsx(_components.code,{children:`name`}),` as the `,_jsx(_components.code,{children:`operator`}),` in a name check.`]})]})]}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Nigeria has no mobile money operators in this list. Payouts to Nigeria go to bank accounts only.`})}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Cache the list for a few hours. Do not hard-code bank codes: fetch them, so new banks appear\nwithout a release.`})}),`\n`,_jsx(Heading,{level:`2`,id:`check-an-account`,children:`Check an account`}),`\n`,_jsx(_components.p,{children:_jsx(_components.code,{children:`GET /v1/payouts/validate-account`})}),`\n`,_jsx(ParamField,{query:`type`,type:`string`,required:true,id:`param-type-1`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`bank`}),` or `,_jsx(_components.code,{children:`mobile_money`}),`.`]})}),`\n`,_jsx(ParamField,{query:`country`,type:`string`,default:`NG`,id:`param-country-1`,children:_jsx(_components.p,{children:`Two-letter country code.`})}),`\n`,_jsx(ParamField,{query:`accountNumber`,type:`string`,id:`param-account-number`,children:_jsxs(_components.p,{children:[`The bank account number. Required when `,_jsx(_components.code,{children:`type`}),` is `,_jsx(_components.code,{children:`bank`}),`.`]})}),`\n`,_jsx(ParamField,{query:`bankCode`,type:`string`,id:`param-bank-code`,children:_jsxs(_components.p,{children:[`The bank’s code from the institutions list. Required when `,_jsx(_components.code,{children:`type`}),` is `,_jsx(_components.code,{children:`bank`}),`.`]})}),`\n`,_jsx(ParamField,{query:`mobileNumber`,type:`string`,id:`param-mobile-number`,children:_jsxs(_components.p,{children:[`The mobile money number. Required when `,_jsx(_components.code,{children:`type`}),` is `,_jsx(_components.code,{children:`mobile_money`}),`.`]})}),`\n`,_jsx(ParamField,{query:`operator`,type:`string`,id:`param-operator`,children:_jsxs(_components.p,{children:[`The operator’s name from the institutions list. Required when `,_jsx(_components.code,{children:`type`}),` is `,_jsx(_components.code,{children:`mobile_money`}),`.`]})}),`\n`,_jsxs(_components.p,{children:[`A request that leaves out a field its `,_jsx(_components.code,{children:`type`}),` needs is refused with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Bank account`,id:`bank-account`,children:[_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_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/payouts/validate-account?type=bank\u0026bankCode=058\u0026accountNumber=0123456789\u0026country=NG\"`}),_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:`\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Node`,numberOfLines:`11`,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:`11`,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:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` URLSearchParams`}),_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:` type:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'bank'`}),_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:` bankCode:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '058'`}),_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:` accountNumber:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '0123456789'`}),_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:` country:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'NG'`}),_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:`#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/payouts/validate-account?`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`params`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},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:` headers:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},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`,_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:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:`data`}),_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(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Show data.accountName to your user and ask them to confirm.`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`9`,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:`9`,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.get(`})]}),`\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/payouts/validate-account\"`}),_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:`{`}),_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:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bank\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"bankCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"058\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"accountNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0123456789\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"country\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"NG\"`}),_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:`data `}),_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`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Show data[\"accountName\"] to your user and ask them to confirm.`})}),`\n`]})})})]}),_jsx(CodeBlock,{filename:`Response · 200`,numberOfLines:`6`,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:`6`,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:` \"accountName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Ngozi Adeyemi\"`}),_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:` \"accountNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"0123456789\"`})]}),`\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.p,{children:[_jsx(_components.code,{children:`accountName`}),` can be `,_jsx(_components.code,{children:`null`}),` when the bank returns no name. Treat that as “not confirmed”, not as a pass.`]}),_jsxs(_components.p,{children:[`A Nigerian account number must be exactly 10 digits. Anything else returns `,_jsx(_components.code,{children:`422 validation_invalid_beneficiary`}),` without asking the bank.`]})]}),_jsxs(Tab,{title:`Mobile money number`,id:`mobile-money-number`,children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_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/payouts/validate-account?type=mobile_money\u0026mobileNumber=233241234567\u0026operator=MTN\u0026country=GH\"`}),_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:`\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Response · 200`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"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:` \"valid\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`true`}),_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:` \"accountName\"`}),_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:` \"mobileNumber\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"233241234567\"`})]}),`\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.p,{children:[_jsx(_components.code,{children:`valid`}),` is `,_jsx(_components.code,{children:`false`}),` when the number is not between 9 and 15 digits. `,_jsx(_components.code,{children:`accountName`}),` is the subscriber’s name when the operator returns one, and is often `,_jsx(_components.code,{children:`null`}),`.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`valid: true`}),` with `,_jsx(_components.code,{children:`accountName: null`}),` confirms only that the number is well-formed. It does\nnot confirm who owns the wallet. Have your user double-check the number.`]})})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`use-the-result`,children:`Use the result`}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Show the name`,children:[`Display `,_jsx(_components.code,{children:`accountName`}),` exactly as returned.`]}),_jsx(Step,{title:`Ask your user to confirm`,children:_jsx(_components.p,{children:`Let them say “yes, that is who I am paying” before you create the payout.`})}),_jsxs(Step,{title:`Send the payout`,children:[`Put the confirmed name in `,_jsx(_components.code,{children:`beneficiary.holderName`}),`.`]})]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`Do not auto-reject on a name that differs slightly from what your user typed. Banks abbreviate,\nreorder and truncate names. Show the bank’s version and let a person decide.`})}),`\n`,_jsx(Heading,{level:`2`,id:`in-the-sandbox`,children:`In the sandbox`}),`\n`,_jsxs(_components.p,{children:[`Name checks return made-up names. The same account number always returns the same name. Some account numbers trigger scripted results. See `,_jsx(_components.a,{href:`/testing/sandbox#name-checks`,children:`Test in the sandbox`}),`.`]}),`\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,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`422`})}),_jsxs(_components.td,{children:[`A field the chosen `,_jsx(_components.code,{children:`type`}),` needs is missing.`]}),_jsx(_components.td,{children:`Send the fields listed above.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`422 validation_invalid_beneficiary`})}),_jsx(_components.td,{children:`An NGN account number that is not 10 digits.`}),_jsx(_components.td,{children:`Correct the number.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`5xx`})}),_jsx(_components.td,{children:`The bank did not answer.`}),_jsx(_components.td,{children:`Try again. Do not skip the check.`})]})]})]})]})}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":"Name check and institutions","sidebarTitle":"Name check","description":"List the banks and mobile money operators you can pay, and look up the name on an account before you pay it.","href":"/guides/name-check"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"List institutions","slug":"list-institutions","depth":2,"children":[]},{"title":"Check an account","slug":"check-an-account","depth":2,"children":[]},{"title":"Use the result","slug":"use-the-result","depth":2,"children":[]},{"title":"In the sandbox","slug":"in-the-sandbox","depth":2,"children":[]},{"title":"When it fails","slug":"when-it-fails","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":"Name check and institutions - Payve","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"guides/name-check.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=\"List the banks and mobile money operators you can pay, and look up the name on an account before you pay it.\">\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=\"Name check and institutions - Payve\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the banks and mobile money operators you can pay, and look up the name on an account before you pay it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Payve\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.payvehq.com/guides/name-check\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"http://docs.payvehq.com/_mintlify/og/guides/name-check.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=\"Name check and institutions - Payve\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the banks and mobile money operators you can pay, and look up the name on an account before you pay it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"http://docs.payvehq.com/_mintlify/og/guides/name-check.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/name-check\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/guides/name-check.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/name-check.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","description":"Send up to 100 payouts in one request, with a result for each.","href":"/guides/bulk-payouts"},{"title":"Name check and institutions","sidebarTitle":"Name check","href":"/guides/name-check"},{"title":"Beneficiaries","description":"Save the recipients you pay often.","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","href":"/guides/refunds"}]},{"group":"Conversion","icon":"arrow-left-right","pages":[{"title":"Conversions","href":"/guides/conversions"}]},{"group":"Wallet","icon":"wallet","pages":[{"title":"Wallets and balances","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":"Name check and institutions - Payve","buildId":"6a8a261234c2","dynamics":[],"chunks":[]}