{
"message": "The given data was invalid.",
"errors": {
"name": [
"The name field is required."
]
}
}
Bank Accounts
Create Bank Account
Registers a bank account for a customer (or the authenticated account).
Use GET /bankaccounts/validation first to obtain the required fields for the given currency and country.
POST
/
bankaccounts
Create bank account
curl --request POST \ --url https://{subdomain}.truust.io/2.0/bankaccounts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "customer_id": 7485, "name": "My bank account", "type": "IBAN", "number": "ES1300812944953951475955", "bic": "CAIXESBBXXX"}'
Bank account type. IBAN for SEPA accounts, BSB_ACCOUNT for Australian accounts,
INTERNATIONAL for SWIFT/BIC accounts, CLEARJUNCTION / CURRENCYCLOUD for gateway-linked accounts,
PA_CTE / PA_AHORRO for Spanish payment accounts, and OTHER / CL_CTE / CL_VISTA /
CL_AHORRO / ZEPTO for other formats.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Truust","colors":{"primary":"#073963","light":"#058ed8","dark":"#073963"},"logo":{"light":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","dark":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","href":"https://truust.io"},"favicon":"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953","navbar":{"links":[{"href":"https://truust.io","label":"Truust Website"},{"href":"https://truust.io/contact/","label":"Contact Us"}]},"footer":{"socials":{"website":"https://truust.io"}},"contextual":{"options":["copy","chatgpt","claude","perplexity","grok","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"socialpay","hasAudioNarration":false,"actualSubdomain":"socialpay","customDomains":["docs.truust.io"],"gitSource":{"type":"github","owner":"truust-io","repo":"docs.truust.io","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae89a23f8e61e223f91fd82","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":146},{"language":"default","tag":"Customers","count":13},{"language":"default","tag":"Orders","count":11},{"language":"default","tag":"Verifications","count":10},{"language":"default","tag":"Documentation","count":8},{"language":"default","tag":"Payins","count":7},{"language":"default","tag":"Bundles","count":6},{"language":"default","tag":"Account","count":5},{"language":"default","tag":"Wallets","count":5},{"language":"default","tag":"Platform","count":5}]},"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":"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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"table td:first-child code{white-space:nowrap}"}],"page":{"pagePath":"api-reference/create-bank-account","slug":"/api-reference/create-bank-account","pageMetadata":{"title":"Create Bank Account","openapi":"POST /bankaccounts","description":"Registers a bank account for a customer (or the authenticated account).\nUse `GET /bankaccounts/validation` first to obtain the required fields for the given currency and country.\n","href":"/api-reference/create-bank-account"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Registers a bank account for a customer (or the authenticated account).\\nUse \", _jsx(_components.code, {\n children: \"GET /bankaccounts/validation\"\n }), \" first to obtain the required fields for the given currency and country.\"]\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create Bank Account","openapi":"POST /bankaccounts","description":"Registers a bank account for a customer (or the authenticated account).\nUse `GET /bankaccounts/validation` first to obtain the required fields for the given currency and country.\n","href":"/api-reference/create-bank-account"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Create bank account","description":"Registers a bank account for a customer (or the authenticated account).\nUse `GET /bankaccounts/validation` first to obtain the required fields for the given currency and country.\n","operationId":"createBankAccount","tags":["Bank Accounts"],"requestBody":"f201a676-1dff-4268-b32d-69c530cf262e","responses":{"200":"459c3d7c-ca4f-4e01-9908-60823d271758","422":"c51b9766-c01a-44ca-8461-51f5f6df22dc"},"method":"post","type":"path","servers":["0f42c800-8246-4ac3-9108-23b6b071ae36","82d02f21-f641-4af8-8110-3ba7289f1338"],"security":["ba798aec-ece0-4b40-af38-d7b7451a8091"],"path":"/bankaccounts","baseUrlOptions":["https://{subdomain}.truust.io/2.0","https://{subdomain}-sandbox.truust.io/2.0"],"title":"Create bank account","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["name","type","number"],"example":{"customer_id":7485,"name":"My bank account","type":"IBAN","number":"ES1300812944953951475955","bic":"CAIXESBBXXX"},"properties":{"name":{"type":"string","maxLength":255,"description":"Account holder name.","example":"My bank account","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"type":{"type":"string","description":"Bank account type. `IBAN` for SEPA accounts, `BSB_ACCOUNT` for Australian accounts,\n`INTERNATIONAL` for SWIFT/BIC accounts, `CLEARJUNCTION` / `CURRENCYCLOUD` for gateway-linked accounts,\n`PA_CTE` / `PA_AHORRO` for Spanish payment accounts, and `OTHER` / `CL_CTE` / `CL_VISTA` /\n`CL_AHORRO` / `ZEPTO` for other formats.\n","enum":["IBAN","OTHER","BSB_ACCOUNT","PA_AHORRO","PA_CTE","CL_CTE","CL_VISTA","CL_AHORRO","INTERNATIONAL","ZEPTO","CLEARJUNCTION","CURRENCYCLOUD"],"example":"IBAN","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"number":{"type":"string","description":"Bank account number or IBAN. Must be a valid IBAN when `type` is `IBAN`, `CLEARJUNCTION`, or `CURRENCYCLOUD`.","example":"ES1300812944953951475955","isRequired":true,"uniqueKey":"number","typeLabel":"string"},"customer_id":{"type":"integer","description":"Customer ID to assign the bank account to. Required unless `customer_type` is `source`.","example":7485,"uniqueKey":"customer_id","typeLabel":"integer"},"customer_type":{"type":"string","enum":["source"],"description":"Pass `source` to register a bank account for the authenticated account instead of a customer.","uniqueKey":"customer_type","typeLabel":"enum\u003cstring>"},"bic":{"type":"string","maxLength":11,"description":"BIC/SWIFT code. Required for `INTERNATIONAL` type. Auto-populated from `bsb` for `BSB_ACCOUNT`.","example":"CAIXESBBXXX","uniqueKey":"bic","typeLabel":"string"},"bsb":{"type":"string","description":"6-digit BSB code (Australian bank routing number). Required for `BSB_ACCOUNT` type.","example":"062000","uniqueKey":"bsb","typeLabel":"string"},"cod_entidad":{"type":"string","description":"Entity code for Spanish payment accounts (`PA_CTE` / `PA_AHORRO`). Auto-populated from `bic`.","uniqueKey":"cod_entidad","typeLabel":"string"},"iban":{"type":"string","description":"IBAN (alternative field to `number` for SEPA accounts).","example":"ES9121000418450200051332","uniqueKey":"iban","typeLabel":"string"},"tag":{"type":"string","maxLength":100,"uniqueKey":"tag","typeLabel":"string"},"metadata":{"type":"object","additionalProperties":true,"description":"Additional metadata. For `CLEARJUNCTION` and `CURRENCYCLOUD` types the following beneficiary fields are required.","properties":{"currency":{"type":"string","description":"3-letter ISO 4217 currency code. Required for CLEARJUNCTION / CURRENCYCLOUD.","example":"EUR","uniqueKey":"metadata.currency","typeLabel":"string"},"country":{"type":"string","description":"2-letter ISO 3166-1 country code. Required for CLEARJUNCTION / CURRENCYCLOUD.","example":"ES","uniqueKey":"metadata.country","typeLabel":"string"},"beneficiary_entity_type":{"type":"string","enum":["individual","company"],"description":"Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.beneficiary_entity_type","typeLabel":"enum\u003cstring>"},"beneficiary_company_name":{"type":"string","description":"Required when `beneficiary_entity_type` is `company`.","uniqueKey":"metadata.beneficiary_company_name","typeLabel":"string"},"beneficiary_first_name":{"type":"string","description":"Required when `beneficiary_entity_type` is `individual`.","uniqueKey":"metadata.beneficiary_first_name","typeLabel":"string"},"beneficiary_last_name":{"type":"string","description":"Required when `beneficiary_entity_type` is `individual`.","uniqueKey":"metadata.beneficiary_last_name","typeLabel":"string"},"beneficiary_address":{"type":"string","description":"Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.beneficiary_address","typeLabel":"string"},"beneficiary_city":{"type":"string","description":"Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.beneficiary_city","typeLabel":"string"},"beneficiary_postcode":{"type":"string","uniqueKey":"metadata.beneficiary_postcode","typeLabel":"string"},"beneficiary_state":{"type":"string","uniqueKey":"metadata.beneficiary_state","typeLabel":"string"},"beneficiary_country":{"type":"string","description":"2-letter country code. Required for CLEARJUNCTION / CURRENCYCLOUD.","uniqueKey":"metadata.beneficiary_country","typeLabel":"string"},"bank_account_type":{"type":"string","enum":["checking","savings"],"uniqueKey":"metadata.bank_account_type","typeLabel":"enum\u003cstring>"},"routing_code_type":{"type":"string","uniqueKey":"metadata.routing_code_type","typeLabel":"string"},"routing_code_value":{"type":"string","uniqueKey":"metadata.routing_code_value","typeLabel":"string"},"payment_types":{"type":"array","items":{"type":"string","uniqueKey":"metadata.payment_types.items.[INDEX]","typeLabel":"string"},"uniqueKey":"metadata.payment_types","typeLabel":"string[]"}},"uniqueKey":"metadata","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"customer_id":7485,"name":"My bank account","type":"IBAN","number":"ES1300812944953951475955","bic":"CAIXESBBXXX"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"459c3d7c-ca4f-4e01-9908-60823d271758":{"description":"Bank account created","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer","uniqueKey":"id","typeLabel":"integer"},"self":{"type":"string","uniqueKey":"self","typeLabel":"string"},"uuid":{"type":"string","uniqueKey":"uuid","typeLabel":"string"},"type":{"type":"string","description":"Account type (e.g. `IBAN`, `ACCOUNT`).","uniqueKey":"type","typeLabel":"string"},"name":{"oneOf":[{"type":"string","description":"Account holder name.","uniqueKey":"name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account holder name.","uniqueKey":"name.oneOf.1","typeLabel":"null"}],"uniqueKey":"name","typeLabel":"string | null"},"number":{"type":"string","description":"Masked account number or IBAN.","uniqueKey":"number","typeLabel":"string"},"bic":{"oneOf":[{"type":"string","uniqueKey":"bic.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"bic.oneOf.1","typeLabel":"null"}],"uniqueKey":"bic","typeLabel":"string | null"},"tag":{"oneOf":[{"type":"string","uniqueKey":"tag.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"tag.oneOf.1","typeLabel":"null"}],"uniqueKey":"tag","typeLabel":"string | null"},"metadata":{"oneOf":[{"type":"object","additionalProperties":true,"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":true,"uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"created_at":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"created_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"created_at","typeLabel":"string\u003cdate-time> | null"},"connections":{"type":"object","description":"Hypermedia links to related resources.","additionalProperties":{"type":"string","uniqueKey":"connections.additionalProperties","typeLabel":"string"},"uniqueKey":"connections","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":123,"self":"\u003cstring>","uuid":"\u003cstring>","type":"\u003cstring>","name":"\u003cstring>","number":"\u003cstring>","bic":"\u003cstring>","tag":"\u003cstring>","metadata":{},"created_at":"2023-11-07T05:31:56Z","connections":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"c51b9766-c01a-44ca-8461-51f5f6df22dc":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"The given data was invalid.","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"errors.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"errors.additionalProperties","typeLabel":"string[]"},"example":{"name":["The name field is required."]},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"The given data was invalid.","errors":{"name":["The name field is required."]}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"ba798aec-ece0-4b40-af38-d7b7451a8091":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0f42c800-8246-4ac3-9108-23b6b071ae36":{"url":"https://{subdomain}.truust.io/2.0","description":"Production","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}},"82d02f21-f641-4af8-8110-3ba7289f1338":{"url":"https://{subdomain}-sandbox.truust.io/2.0","description":"Sandbox","variables":{"subdomain":{"default":"your-subdomain","description":"Your account subdomain"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Use your account's **Secret Key** as the Bearer token.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Use your account's **Secret Key** as the Bearer token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api-reference/openapi.yaml"},"subdomain":"socialpay","siteName":"Truust","title":"Create Bank Account - Truust","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-12T07:06:50.130Z","originalFileLocation":"api-reference/create-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=\"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=\"Registers a bank account for a customer (or the authenticated account). Use GET /bankaccounts/validation first to obtain the required fields for the given currency and country.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Truust\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create Bank Account - Truust\">\u003cmeta data-mint-head property=\"og:description\" content=\"Registers a bank account for a customer (or the authenticated account). Use GET /bankaccounts/validation first to obtain the required fields for the given currency and country.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Truust\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.truust.io/api-reference/create-bank-account\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Bank+Accounts\u0026amp;title=Create+Bank+Account\u0026amp;description=Registers+a+bank+account+for+a+customer+%28or+the+authenticated+account%29.%0AUse+%60GET+%2Fbankaccounts%2Fvalidation%60+first+to+obtain+the+required+fields+for+the+given+cur\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=397eb4f1cbd3d48b96e1b86d394a619b924348e03762900fa3b00424927737fa\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create Bank Account - Truust\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Registers a bank account for a customer (or the authenticated account). Use GET /bankaccounts/validation first to obtain the required fields for the given currency and country.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://socialpay.mintlify.site/_mintlify/api/og/v2?division=Bank+Accounts\u0026amp;title=Create+Bank+Account\u0026amp;description=Registers+a+bank+account+for+a+customer+%28or+the+authenticated+account%29.%0AUse+%60GET+%2Fbankaccounts%2Fvalidation%60+first+to+obtain+the+required+fields+for+the+given+cur\u0026amp;theme=07ebb1876c42192d9d839b55\u0026amp;signature=397eb4f1cbd3d48b96e1b86d394a619b924348e03762900fa3b00424927737fa\">\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/socialpay/iG2BZRyj_cp1_SCh/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Truust\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#073963\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.truust.io/api-reference/create-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/create-bank-account.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.truust.io/#organization\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/socialpay/eRLQ9ToOrOIOj92q/assets/logo-truust.png?fit=max\u0026auto=format\u0026n=eRLQ9ToOrOIOj92q\u0026q=85\u0026s=1952722bf3c061af44d2195d279d6953\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.truust.io#website\",\"name\":\"Truust\",\"url\":\"https://docs.truust.io\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.truust.io/api-reference/create-bank-account#webpage\",\"url\":\"https://docs.truust.io/api-reference/create-bank-account\",\"name\":\"Create Bank Account\",\"description\":\"Registers a bank account for a customer (or the authenticated account). Use GET /bankaccounts/validation first to obtain the required fields for the given currency and country.\",\"dateModified\":\"2026-03-12T07:06:50.130Z\",\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.truust.io/api-reference/create-bank-account#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.truust.io/api-reference/create-bank-account#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.truust.io/api-reference\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create Bank Account\",\"item\":\"https://docs.truust.io/api-reference/create-bank-account\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.truust.io/api-reference/create-bank-account#apireference\",\"headline\":\"Create Bank Account\",\"name\":\"Create Bank Account\",\"description\":\"Registers a bank account for a customer (or the authenticated account). Use GET /bankaccounts/validation first to obtain the required fields for the given currency and country.\",\"url\":\"https://docs.truust.io/api-reference/create-bank-account\",\"mainEntityOfPage\":{\"@id\":\"https://docs.truust.io/api-reference/create-bank-account#webpage\"},\"dateModified\":\"2026-03-12T07:06:50.130Z\",\"publisher\":{\"@id\":\"https://docs.truust.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.truust.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Truust\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Truust","nav":{"global":{"anchors":[{"anchor":"Dashboard","icon":"chart-line","href":"http://dashboard-sandbox.truust.io"}]},"anchors":[{"anchor":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"anchor":"API Reference","icon":"code","groups":[{"group":"API Reference","pages":[{"title":"API Reference","href":"/api-reference"},{"group":"Account","pages":[{"title":"Get Current Account","openapi":"GET /accounts/me","href":"/api-reference/get-account"},{"title":"Update Account","openapi":"PUT /accounts/me","href":"/api-reference/update-account"},{"title":"Create Account","openapi":"POST /accounts","href":"/api-reference/create-account"},{"title":"Get Account Fees","openapi":"GET /accounts/fees/{currency}","href":"/api-reference/get-account-fees"},{"title":"Verify Account","openapi":"POST /accounts/verify","href":"/api-reference/verify-account"}]},{"group":"Customers","pages":[{"title":"List Customers","openapi":"GET /customers","href":"/api-reference/list-customers"},{"title":"Create Customer","openapi":"POST /customers","href":"/api-reference/create-customer"},{"title":"Get Customer","openapi":"GET /customers/{uuid}","href":"/api-reference/get-customer"},{"title":"Update Customer","openapi":"PUT /customers/{uuid}","href":"/api-reference/update-customer"},{"title":"List Customer Wallets","openapi":"GET /customers/{uuid}/wallets","href":"/api-reference/list-customer-wallets"},{"title":"List Customer Cards","openapi":"GET /customers/{uuid}/cards","href":"/api-reference/list-customer-cards"},{"title":"Add Card to Customer","openapi":"POST /customers/{uuid}/cards","href":"/api-reference/create-card"},{"title":"List Customer Bank Accounts","openapi":"GET /customers/{uuid}/bankaccounts","href":"/api-reference/list-customer-bank-accounts"},{"title":"List Customer Addresses","openapi":"GET /customers/{uuid}/addresses","href":"/api-reference/list-customer-addresses"},{"title":"Add Address to Customer","openapi":"POST /customers/{uuid}/addresses","href":"/api-reference/create-customer-address"},{"title":"Get Customer Address","openapi":"GET /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/get-customer-address"},{"title":"Update Customer Address","openapi":"PUT /customers/{uuid}/addresses/{address_uuid}","href":"/api-reference/update-customer-address"},{"title":"List Customer Subscriptions","openapi":"GET /customers/{uuid}/subscriptions","href":"/api-reference/list-customer-subscriptions"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /orders","href":"/api-reference/list-orders"},{"title":"Create Order","openapi":"POST /orders","href":"/api-reference/create-order"},{"title":"Get Order","openapi":"GET /orders/{id}","href":"/api-reference/get-order"},{"title":"Update Order","openapi":"PUT /orders/{id}","href":"/api-reference/update-order"},{"title":"Get Order Payin","openapi":"GET /orders/{id}/payin","href":"/api-reference/get-order-payin"},{"title":"Get Order Payout","openapi":"GET /orders/{id}/payout","href":"/api-reference/get-order-payout"},{"title":"Accept Order","openapi":"POST /orders/{id}/accept","href":"/api-reference/accept-order"},{"title":"Cancel Order","openapi":"POST /orders/{id}/cancel","href":"/api-reference/cancel-order"},{"title":"Validate Order","openapi":"POST /orders/{id}/validate","href":"/api-reference/validate-order"},{"title":"Send Order Receipt","openapi":"POST /orders/{id}/receipt","href":"/api-reference/send-order-receipt"},{"title":"Reimburse Order","openapi":"POST /orders/{id}/reimburse","href":"/api-reference/reimburse-order"}]},{"group":"Payins","pages":[{"title":"List Payins","openapi":"GET /payins","href":"/api-reference/list-payins"},{"title":"Create Payin","openapi":"POST /payins","href":"/api-reference/create-payin"},{"title":"Get Payin","openapi":"GET /payins/{id}","href":"/api-reference/get-payin"},{"title":"Sync Payin Status","openapi":"PUT /payins/{id}","href":"/api-reference/sync-payin"},{"title":"Refund Payin","openapi":"POST /payins/{id}/refund","href":"/api-reference/refund-payin"},{"title":"Cancel Pre-Authorization","openapi":"POST /payins/{id}/cancelpreauth","href":"/api-reference/cancel-pre-auth"},{"title":"Request to Pay","openapi":"POST /payins/{id}/request","href":"/api-reference/request-to-pay"}]},{"group":"Payouts","pages":[{"title":"List Payouts","openapi":"GET /payouts","href":"/api-reference/list-payouts"},{"title":"Create Payout","openapi":"POST /payouts","href":"/api-reference/create-payout"},{"title":"Get Payout","openapi":"GET /payouts/{id}","href":"/api-reference/get-payout"},{"title":"Sync Payout Status","openapi":"POST /payouts/{id}/update","href":"/api-reference/sync-payout"}]},{"group":"Wallets","pages":[{"title":"List Wallets","openapi":"GET /wallets","href":"/api-reference/list-wallets"},{"title":"Create Wallet","openapi":"POST /wallets","href":"/api-reference/create-wallet"},{"title":"Get Wallet","openapi":"GET /wallets/{uuid}","href":"/api-reference/get-wallet"},{"title":"Update Wallet","openapi":"PUT /wallets/{uuid}","href":"/api-reference/update-wallet"},{"title":"List Wallet Transactions","openapi":"GET /wallets/{uuid}/transactions","description":null,"href":"/api-reference/list-wallet-transactions"}]},{"group":"Bank Accounts","pages":[{"title":"Create Bank Account","openapi":"POST /bankaccounts","href":"/api-reference/create-bank-account"},{"title":"Get Bank Account","openapi":"GET /bankaccounts/{uuid}","description":null,"href":"/api-reference/get-bank-account"},{"title":"Get Bank Account Validation","openapi":"GET /bankaccounts/validation","href":"/api-reference/get-bank-account-validation"}]},{"group":"Cards","pages":[{"title":"Get Card","openapi":"GET /cards/{uuid}","href":"/api-reference/get-card"},{"title":"Delete Card","openapi":"DELETE /cards/{uuid}","href":"/api-reference/delete-card"}]},{"group":"Subscriptions","pages":[{"title":"List Subscriptions","openapi":"GET /subscriptions","href":"/api-reference/list-subscriptions"},{"title":"Create Subscription","openapi":"POST /subscriptions","href":"/api-reference/create-subscription"},{"title":"Get Subscription","openapi":"GET /subscriptions/{id}","href":"/api-reference/get-subscription"},{"title":"Cancel Subscription","openapi":"PUT /subscriptions/{id}/cancel","href":"/api-reference/cancel-subscription"}]},{"group":"Verifications","pages":[{"title":"List Verifications","openapi":"GET /verifications","href":"/api-reference/list-verifications"},{"title":"Get Verification","openapi":"GET /verifications/{uuid}","href":"/api-reference/get-verification"},{"title":"Submit Verification (KYC)","openapi":"PUT /verifications/{uuid}","href":"/api-reference/submit-verification"},{"title":"Request Verification Review","openapi":"POST /verifications/{uuid}/request","href":"/api-reference/request-verification"},{"title":"Create KYC for a Customer","openapi":"POST /customers/{uuid}/verify","href":"/api-reference/create-customer-verification"},{"title":"Get KYC Verification for a Customer","openapi":"GET /customers/{uuid}/verification","href":"/api-reference/get-customer-verification"},{"title":"List Verification Documents","openapi":"GET /verifications/{uuid}/documents","href":"/api-reference/list-verification-documents"},{"title":"Upload Verification Document","openapi":"POST /verifications/{uuid}/documents","href":"/api-reference/upload-verification-document"},{"title":"Get Verification Document","openapi":"GET /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/get-verification-document"},{"title":"Update Verification Document","openapi":"PUT /verifications/{uuid}/documents/{document_uuid}","href":"/api-reference/update-verification-document"}]},{"group":"Bundles","pages":[{"title":"List Bundles","openapi":"GET /bundles","href":"/api-reference/list-bundles"},{"title":"Create Bundle","openapi":"POST /bundles","href":"/api-reference/create-bundle"},{"title":"List Expired Bundles","openapi":"GET /bundles/expired","href":"/api-reference/list-expired-bundles"},{"title":"Get Bundle","openapi":"GET /bundles/{bundle_id}","href":"/api-reference/get-bundle"},{"title":"Update Bundle","openapi":"PUT /bundles/{bundle_id}","href":"/api-reference/update-bundle"},{"title":"List Orders for a Bundle","openapi":"GET /bundles/{bundle_id}/orders","href":"/api-reference/list-bundle-orders"}]},{"group":"Refunds","pages":[{"title":"List Refunds","openapi":"GET /refunds","href":"/api-reference/list-refunds"},{"title":"Get Refund","openapi":"GET /refunds/{id}","href":"/api-reference/get-refund"}]}]}]}]},"basePath":"","title":"Create Bank Account - Truust","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}