Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.
Registration does three things in one call: it confirms the account number with
the bank, stores the account against your business, and issues the on-chain
addresses that pay it: address on Solana, and evmAddress on the EVM chains
(Ethereum, Base, BNB Smart Chain, Monad and Arc, all at the same address).The call is idempotent per bank account. If the same bank code and account
number have already been registered — by you or by anyone else on Paj — the
existing record is returned unchanged, with the same addresses. There is no
error and no duplicate.evmAddress can be missing for a short time after registration if issuing it
was delayed; address is always present. Look the account up again with
GET /pub/v2/bank-account a little later
to get it.
Confirmation is a live call to the banking rail, so this endpoint is slower
than the other two. Register accounts ahead of time rather than in a hot path
like a checkout screen.
Use the returned accountName — it comes from the bank, not from your input —
to let the user confirm they typed the right account number before you show them
an address to pay.See Bank account addresses for what happens
once funds reach the address. To follow a transfer to the address through to
the payout, subscribe to its signature on the
deposit socket.
Authorizations
x-api-key
string
header
required
Body
application/json
bankCode
string
required
Bank's code
Example:
"000016"
accountNumber
string
required
User's bank account number
Example:
"0025635480"
Response
The registered bank account
id
string
required
id
Example:
"someRANDOMid"
accountName
string
required
User's bank acount name
Example:
"John Doe"
accountNumber
string
required
User's bank account number
Example:
"0025635480"
bank
string
required
Bank name
Example:
"First Bank"
address
string
required
Solana address that pays this bank account. Any token sent to it on Solana is paid out as naira.
Example:
"FsXpXq8wVTM13NDXxrf2X6PpgJWg9jCxRVuHhtfnojUa"
evmAddress
string
EVM address that pays this bank account: the same address on every supported EVM chain. Absent for a short time after registration if it has not been issued yet.
Example:
"0x4B0897b0513fdC7C541B6d9D7E929C4e5364D2dB"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Paj API","colors":{"primary":"#0061ED","light":"#0061ED","dark":"#0061ED"},"favicon":"https://mintcdn.com/paj/sM84F14r9SEpFsV7/favicon.svg?fit=max\u0026auto=format\u0026n=sM84F14r9SEpFsV7\u0026q=85\u0026s=1ac0aa4dd2971336449606bf145b0b22","appearance":{"default":"light"},"navbar":{"primary":{"type":"button","label":"Get an API key","href":"https://developer.paj.cash/"}},"footer":{"socials":{"website":"https://paj.cash"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"paj","hasAudioNarration":false,"actualSubdomain":"paj","customDomains":["docs.paj.cash"],"gitSource":{"type":"github","owner":"paj-cash","repo":"main_backend","deployBranch":"main","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afc1f7e8fbc458f58e290a6","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API reference","count":22},{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Concepts","count":8},{"language":"default","tag":"KYC","count":6},{"language":"default","tag":"Reference data","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Payments","count":2},{"language":"default","tag":"Bank accounts","count":2},{"language":"default","tag":"Webhooks","count":2},{"language":"default","tag":"Offramp","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/register-bank-account","slug":"/api-reference/register-bank-account","pageMetadata":{"title":"Register a bank account","openapi":"POST /pub/v2/bank-account","description":"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.","href":"/api-reference/register-bank-account"},"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: \"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.\"\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`,..._provideComponents(),...props.components},{Warning}=_components;if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Registration does three things in one call: it confirms the account number with\nthe bank, stores the account against your business, and issues the on-chain\naddresses that pay it: `,_jsx(_components.code,{children:`address`}),` on Solana, and `,_jsx(_components.code,{children:`evmAddress`}),` on the EVM chains\n(Ethereum, Base, BNB Smart Chain, Monad and Arc, all at the same address).`]}),`\n`,_jsx(_components.p,{children:`The call is idempotent per bank account. If the same bank code and account\nnumber have already been registered — by you or by anyone else on Paj — the\nexisting record is returned unchanged, with the same addresses. There is no\nerror and no duplicate.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`evmAddress`}),` can be missing for a short time after registration if issuing it\nwas delayed; `,_jsx(_components.code,{children:`address`}),` is always present. Look the account up again with\n`,_jsx(_components.a,{href:`/api-reference/search-bank-account`,children:_jsx(_components.code,{children:`GET /pub/v2/bank-account`})}),` a little later\nto get it.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Confirmation is a live call to the banking rail, so this endpoint is slower\nthan the other two. Register accounts ahead of time rather than in a hot path\nlike a checkout screen.`})}),`\n`,_jsxs(_components.p,{children:[`Use the returned `,_jsx(_components.code,{children:`accountName`}),` — it comes from the bank, not from your input —\nto let the user confirm they typed the right account number before you show them\nan address to pay.`]}),`\n`,_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/concepts/bank-account-addresses`,children:`Bank account addresses`}),` for what happens\nonce funds reach the address. To follow a transfer to the address through to\nthe payout, subscribe to its signature on the\n`,_jsx(_components.a,{href:`/api-reference/track-deposits`,children:`deposit socket`}),`.`]})]})}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":"Register a bank account","openapi":"POST /pub/v2/bank-account","description":"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.","href":"/api-reference/register-bank-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.","operationId":"PubV2Controller_registerBankAccount","parameters":[],"requestBody":"7bd07f27-5575-4537-9114-48740a6694d6","responses":{"201":"63b435e2-46f5-45fb-8fae-84ae906b3460","400":"0bcf5f7a-a75f-4bc8-b070-ffdf699504d1","401":"5859d358-e417-4348-9ac2-a01e3f5abd40"},"security":["ca5d6ef0-e724-470c-b350-9a6cb3f3ebc5"],"summary":"Register a bank account","tags":["Pub V2"],"method":"post","type":"path","servers":["48304386-2186-49fe-ad69-f0ee560490f3"],"path":"/pub/v2/bank-account","baseUrlOptions":["https://api.paj.cash"],"title":"Register a bank account","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bankCode":{"type":"string","description":"Bank's code","example":"000016","isRequired":true,"uniqueKey":"bankCode","typeLabel":"string"},"accountNumber":{"type":"string","description":"User's bank account number","example":"0025635480","isRequired":true,"uniqueKey":"accountNumber","typeLabel":"string"}},"required":["bankCode","accountNumber"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"bankCode":"000016","accountNumber":"0025635480"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"63b435e2-46f5-45fb-8fae-84ae906b3460":{"description":"The registered bank account","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"id","example":"someRANDOMid","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"accountName":{"type":"string","description":"User's bank acount name","example":"John Doe","isRequired":true,"uniqueKey":"accountName","typeLabel":"string"},"accountNumber":{"type":"string","description":"User's bank account number","example":"0025635480","isRequired":true,"uniqueKey":"accountNumber","typeLabel":"string"},"bank":{"type":"string","description":"Bank name","example":"First Bank","isRequired":true,"uniqueKey":"bank","typeLabel":"string"},"address":{"type":"string","description":"Solana address that pays this bank account. Any token sent to it on Solana is paid out as naira.","example":"FsXpXq8wVTM13NDXxrf2X6PpgJWg9jCxRVuHhtfnojUa","isRequired":true,"uniqueKey":"address","typeLabel":"string"},"evmAddress":{"type":"string","description":"EVM address that pays this bank account: the same address on every supported EVM chain. Absent for a short time after registration if it has not been issued yet.","example":"0x4B0897b0513fdC7C541B6d9D7E929C4e5364D2dB","uniqueKey":"evmAddress","typeLabel":"string"}},"required":["id","accountName","accountNumber","bank","address"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"someRANDOMid","accountName":"John Doe","accountNumber":"0025635480","bank":"First Bank","address":"FsXpXq8wVTM13NDXxrf2X6PpgJWg9jCxRVuHhtfnojUa","evmAddress":"0x4B0897b0513fdC7C541B6d9D7E929C4e5364D2dB"}}},"exampleType":"generated"}},"exampleType":"generated"},"0bcf5f7a-a75f-4bc8-b070-ffdf699504d1":{"description":"Unknown bank code, or the account number could not be confirmed","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"5859d358-e417-4348-9ac2-a01e3f5abd40":{"description":"Missing or invalid API key (x-api-key header)","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"ca5d6ef0-e724-470c-b350-9a6cb3f3ebc5":{"x-api-key":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"}}},"servers":{"48304386-2186-49fe-ad69-f0ee560490f3":{"url":"https://api.paj.cash","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"x-api-key"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"x-api-key","name":"x-api-key"}],"title":"x-api-key"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"paj","siteName":"Paj API","title":"Register a bank account - Paj API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T13:44:11.861Z","originalFileLocation":"api-reference/register-bank-account.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=\"light\"}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=\"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Paj API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Register a bank account - Paj API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Paj API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.paj.cash/api-reference/register-bank-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://paj.mintlify.site/_mintlify/api/og/v2?division=Bank+accounts\u0026amp;title=Register+a+bank+account\u0026amp;description=Registers+a+bank+account+for+the+API+key%E2%80%99s+business+using+a+bank+code+and+account+number.+The+account+is+confirmed+with+the+provider+and+an+on-chain+address+is+\u0026amp;theme=07e22cd0d20fc7185c62ff58\u0026amp;signature=a879d7ad48258d06849326bd433f8930017c8a8f9afa3c3f880d72866d6ff5e9\">\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=\"Register a bank account - Paj API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://paj.mintlify.site/_mintlify/api/og/v2?division=Bank+accounts\u0026amp;title=Register+a+bank+account\u0026amp;description=Registers+a+bank+account+for+the+API+key%E2%80%99s+business+using+a+bank+code+and+account+number.+The+account+is+confirmed+with+the+provider+and+an+on-chain+address+is+\u0026amp;theme=07e22cd0d20fc7185c62ff58\u0026amp;signature=a879d7ad48258d06849326bd433f8930017c8a8f9afa3c3f880d72866d6ff5e9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/paj/DFLkHVdVXYAdgkSY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Paj API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0061ED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.paj.cash/api-reference/register-bank-account\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/register-bank-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.paj.cash/#organization\",\"name\":\"Paj API\",\"url\":\"https://docs.paj.cash\"},{\"@type\":\"WebSite\",\"@id\":\"https://docs.paj.cash#website\",\"name\":\"Paj API\",\"url\":\"https://docs.paj.cash\",\"publisher\":{\"@id\":\"https://docs.paj.cash/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.paj.cash/api-reference/register-bank-account#webpage\",\"url\":\"https://docs.paj.cash/api-reference/register-bank-account\",\"name\":\"Register a bank account\",\"description\":\"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.\",\"dateModified\":\"2026-11-10T13:44:11.861Z\",\"isPartOf\":{\"@id\":\"https://docs.paj.cash#website\"},\"breadcrumb\":{\"@id\":\"https://docs.paj.cash/api-reference/register-bank-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.paj.cash/api-reference/register-bank-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Paj API\",\"item\":\"https://docs.paj.cash\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Register a bank account\",\"item\":\"https://docs.paj.cash/api-reference/register-bank-account\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.paj.cash/api-reference/register-bank-account#apireference\",\"headline\":\"Register a bank account\",\"name\":\"Register a bank account\",\"description\":\"Registers a bank account for the API key’s business using a bank code and account number. The account is confirmed with the provider and an on-chain address is assigned. If the account already exists it is returned as-is.\",\"url\":\"https://docs.paj.cash/api-reference/register-bank-account\",\"mainEntityOfPage\":{\"@id\":\"https://docs.paj.cash/api-reference/register-bank-account#webpage\"},\"dateModified\":\"2026-11-10T13:44:11.861Z\",\"publisher\":{\"@id\":\"https://docs.paj.cash/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.paj.cash#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Paj API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Paj API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/register-bank-account.md","siteName":"Paj API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"KYC","pages":[{"title":"Get the KYC consent text","openapi":"GET /pub/v2/kyc/consent","href":"/api-reference/get-kyc-consent"},{"title":"Start verifying a person","openapi":"POST /pub/v2/kyc/sessions","href":"/api-reference/create-kyc-session"},{"title":"Confirm the code","openapi":"POST /pub/v2/kyc/sessions/{id}/verify-otp","href":"/api-reference/verify-kyc-otp"},{"title":"Send a new code","openapi":"POST /pub/v2/kyc/sessions/{id}/resend-otp","href":"/api-reference/resend-kyc-otp"},{"title":"Get a KYC session","openapi":"GET /pub/v2/kyc/sessions/{id}","href":"/api-reference/get-kyc-session"},{"title":"Get a customer","openapi":"GET /pub/v2/customers/{customerId}","description":"A customer's current status. Use it if you missed a webhook. It is read live, so it reflects any decision made since.","href":"/api-reference/get-customer"}]},{"group":"Bank accounts","pages":[{"title":"Register a bank account","openapi":"POST /pub/v2/bank-account","href":"/api-reference/register-bank-account"},{"title":"Search for a bank account","openapi":"GET /pub/v2/bank-account","description":"Looks up a single bank account by its on-chain address or its account number. Provide at least one of the two query parameters.","href":"/api-reference/search-bank-account"}]},{"group":"Deposit tracking","pages":[{"title":"Track a deposit","href":"/api-reference/track-deposits"}]},{"group":"Banks","pages":[{"title":"Get banks","openapi":"GET /pub/v2/bank","href":"/api-reference/get-banks"}]},{"group":"Onramp","pages":[{"title":"Create an onramp order","openapi":"POST /pub/v2/onramp","href":"/api-reference/create-onramp-order"}]},{"group":"Offramp","pages":[{"title":"Create an offramp order","openapi":"POST /pub/v2/offramp","href":"/api-reference/create-offramp-order"}]},{"group":"Transactions","pages":[{"title":"Get a transaction","openapi":"GET /pub/v2/transaction/{id}","href":"/api-reference/get-transaction"}]},{"group":"Payments","pages":[{"title":"Create a payment","openapi":"POST /pub/v2/payment","href":"/api-reference/create-payment"},{"title":"Track a payment","href":"/api-reference/track-payments"}]},{"group":"Rates","pages":[{"title":"Get rates","openapi":"GET /pub/v2/rate","href":"/api-reference/get-rates"}]},{"group":"Reference data","pages":[{"title":"Get chains","openapi":"GET /pub/v2/chains","href":"/api-reference/get-chains"},{"title":"Get currencies","openapi":"GET /pub/v2/currencies","href":"/api-reference/get-currencies"},{"title":"List tokens on a chain","openapi":"GET /pub/v2/tokens","href":"/api-reference/get-tokens"},{"title":"Get a token","openapi":"GET /pub/v2/tokens/{address}","href":"/api-reference/get-token"}]},{"group":"Webhooks","pages":[{"title":"Update your webhook URLs","openapi":"PATCH /pub/v2/webhook","href":"/api-reference/update-webhooks"},{"title":"Test your webhook","openapi":"POST /pub/v2/webhook/test","href":"/api-reference/test-webhook"}]}]}]},"basePath":"","title":"Register a bank account - Paj API","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}