Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.
Use this endpoint to update a registered bank account. Currently, the only mutable field is networks, which controls which payment rails are enabled for the account. The new networks value must be compatible with the account’s currency — you cannot add an incompatible network after creation.
The payment networks supported by this bank account. Must match the bank account currency: USD accounts support ["ach", "wire"], EUR accounts support ["sepa"], BRL accounts support ["pix"].
The payment networks supported by this bank account. For USD ACH/Wire accounts, includes at least one of "ach" or "wire". For USD SWIFT accounts, is exactly ["swift"].
The ISO 8601 timestamp when the bank account was last updated.
Example:
"2025-01-01T00:00:00Z"
Last modified on June 18, 2026
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"SpherePay","colors":{"primary":"#2563EB","light":"#60A5FA","dark":"#1D4ED8"},"logo":{"light":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48","dark":"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-dark.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=841362b62b2d8a0da3d2b69d22c62d88"},"favicon":"https://mintcdn.com/spherepayco/a4WF4v5_QYD1dXam/favicon.png?fit=max\u0026auto=format\u0026n=a4WF4v5_QYD1dXam\u0026q=85\u0026s=b3c29639701db7176e6ac8f2b03f68a7","api":{"playground":{"display":"none"}},"navbar":{"primary":{"type":"button","label":"Sphere Dashboard ↗","href":"https://spherepay.co/dashboard"}},"icons":{"library":"lucide"},"styling":{"codeblocks":"dark","latex":true},"metadata":{"timestamp":true},"navigation":{"languages":[{"language":"en","default":true,"href":"introduction"},{"language":"es","href":"es/introduction"},{"language":"pt-BR","href":"pt-BR/introduction"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"spherepayco","hasAudioNarration":false,"actualSubdomain":"spherepayco","customDomains":["docs.spherepay.co"],"gitSource":{"type":"github","owner":"sphere-laboratories","repo":"mintlify-docs","deployBranch":"main","isPrivate":true,"contentDirectory":"","mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae4e40af8344a2328cd117d","collectionId":"1a93b227-1f28-4c2a-bb42-9163f0a8c012","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae4e40af8344a2328cd117d"},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae4e40af8344a2328cd117d","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"en","tag":"API Reference","count":52},{"language":"es","tag":"Referencia de la API","count":52},{"language":"pt-BR","tag":"Referência da API","count":52},{"language":"en","tag":"Concepts","count":29},{"language":"es","tag":"Conceptos","count":29},{"language":"pt-BR","tag":"Conceitos","count":29},{"language":"en","tag":"Onboarding","count":27},{"language":"es","tag":"Incorporación","count":27},{"language":"pt-BR","tag":"Onboarding","count":27},{"language":"en","tag":"Money movement","count":24},{"language":"es","tag":"Movimiento de dinero","count":24},{"language":"pt-BR","tag":"Movimentação de dinheiro","count":24},{"language":"en","tag":"Webhooks","count":13},{"language":"es","tag":"Webhooks","count":13},{"language":"pt-BR","tag":"Webhooks","count":13},{"language":"en","tag":"Accounts","count":9},{"language":"en","tag":"Transfers","count":9},{"language":"en","tag":"Get Started","count":9},{"language":"es","tag":"Cuentas","count":9},{"language":"es","tag":"Transferencias","count":9},{"language":"es","tag":"Comenzar","count":9},{"language":"pt-BR","tag":"Contas","count":9},{"language":"pt-BR","tag":"Transferências","count":9},{"language":"pt-BR","tag":"Começar","count":9},{"language":"en","tag":"Virtual Accounts","count":7},{"language":"es","tag":"Cuentas Virtuales","count":7},{"language":"pt-BR","tag":"Contas Virtuais","count":7},{"language":"en","tag":"Documents \u0026 Verification","count":6},{"language":"es","tag":"Documentos y Verificación","count":6},{"language":"pt-BR","tag":"Documentos e Verificação","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@spherepay.co","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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}],"starterQuestions":[{"_id":"6a02974593b34b4b8541d063","deploymentId":"69f39b63abf2e25489b5290d","questionText":"What currencies are supported?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:13.452Z","updatedAt":"2026-05-12T02:58:13.452Z","__v":0},{"_id":"6a02973893b34b4b8541d023","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I create a transfer?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:58:00.452Z","updatedAt":"2026-05-12T02:58:00.452Z","__v":0},{"_id":"6a02972c93b34b4b8541cfef","deploymentId":"69f39b63abf2e25489b5290d","questionText":"How do I onboard a business?","status":"active","generatedBy":"manual","createdAt":"2026-05-12T02:57:48.946Z","updatedAt":"2026-05-12T02:57:48.946Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-component-part=update-tag]{padding:2px 8px;border:1px solid var(--gray-200, #e5e7eb);background:0 0;color:var(--gray-600, #4b5563);font-size:.6875rem;font-weight:600;letter-spacing:.04em;text-transform:uppercase;border-radius:4px;line-height:1.4}.dark [data-component-part=update-tag]{border-color:var(--gray-700, #374151);color:var(--gray-300, #d1d5db)}[data-component-part=update-tag-list]{margin-top:.5rem;gap:.375rem}nav[class*=navbar] ul li a.link{border-radius:0!important;background:0 0!important;border-bottom:2px solid transparent;transition:border-color 120ms ease,color 120ms ease}nav[class*=navbar] ul li a.link:hover{background:0 0!important;color:#18181b!important;border-bottom-color:rgba(37,99,235,.4)}.dark nav[class*=navbar] ul li a.link:hover{color:#60a5fa!important;border-bottom-color:rgba(96,165,250,.4)}nav[class*=navbar] ul li a.link[aria-current=page]{background:0 0!important;border-bottom-color:var(--mintlify-primary, #2563EB);color:#18181b!important}.dark nav[class*=navbar] ul li a.link[aria-current=page]{color:#fafafa!important;border-bottom-color:#60a5fa}nav[class*=navbar][class*=justify-center]{justify-content:flex-start!important}button:has(>div>svg.lucide-search){width:auto!important;min-width:220px;padding-left:14px!important;padding-right:12px!important;justify-content:space-between!important}button:has(>div>svg.lucide-search) .truncate.min-w-0{display:block!important}a[href=\"https://spherepay.co/dashboard\"] span[class*=bg-primary-dark]{border-radius:6px!important;background-color:#2970ff!important;transition:background-color 120ms ease}a[href=\"https://spherepay.co/dashboard\"]:hover span[class*=bg-primary-dark]{background-color:#155eef!important;opacity:1!important}a[href=\"https://spherepay.co/dashboard\"] svg{display:none!important}[data-component-part=card-icon]{width:44px!important;height:44px!important;display:flex!important;align-items:center;justify-content:center;background:rgba(209,224,255,.5);border-radius:10px;margin-bottom:1rem}.dark [data-component-part=card-icon]{background:rgba(96,165,250,.15)}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){margin-left:24px;padding-left:4px;border-left:1.5px solid #e5e7eb}ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)) a[href*=\"/api-reference/\"]{padding-left:16px!important}.dark ul.space-y-px:has(>li>a[href*=\"/api-reference/\"]):not(:has(ul)){border-left-color:rgba(255,255,255,.12)}#sidebar button[aria-expanded]>div:has(>svg[viewBox=\"0 -9 3 24\"]){margin-left:auto}#sidebar:has(a[href*=\"/api-reference/\"]){border-right:1px solid #e5e7eb}.dark #sidebar:has(a[href*=\"/api-reference/\"]){border-right-color:rgba(255,255,255,.1)}.sidebar-group-icon{display:none!important}#navbar-transition{border-bottom-color:#e5e7eb!important}@media (min-width:1024px){#navbar-transition::after{content:\"\";position:absolute;left:0;right:0;top:64px;height:1px;background:#e5e7eb;pointer-events:none}}#navbar .flex-1{border-bottom-color:transparent!important}.dark #navbar-transition{border-bottom-color:rgba(255,255,255,.1)!important}.dark #navbar-transition::after{background:rgba(255,255,255,.1)}"}],"page":{"pagePath":"api-reference/bank-account/patch-id","slug":"/api-reference/bank-account/patch-id","pageMetadata":{"title":"Update Bank Account Payment Rail Settings","sidebarTitle":"Update Bank Account","openapi":"openapi/spherepay.yaml PATCH /v2/bank-account/{id}","description":"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.","href":"/api-reference/bank-account/patch-id"},"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: \"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.\"\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{jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,..._provideComponents(),...props.components};return _jsxs(_components.p,{children:[`Use this endpoint to update a registered bank account. Currently, the only mutable field is `,_jsx(_components.code,{children:`networks`}),`, which controls which payment rails are enabled for the account. The new `,_jsx(_components.code,{children:`networks`}),` value must be compatible with the account’s currency — you cannot add an incompatible network after creation.`]})}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":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Update Bank Account Payment Rail Settings","sidebarTitle":"Update Bank Account","openapi":"openapi/spherepay.yaml PATCH /v2/bank-account/{id}","description":"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.","href":"/api-reference/bank-account/patch-id"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/spherepayco/27b80abc67bf6551/snippets/demoAppUrl.js"],"openApiReferenceData":{"operation":{"description":"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.","operationId":"patchV2BankAccountById","parameters":["5213472d-860b-4021-991e-a286c48b499d"],"requestBody":"11cbd2d6-fada-4da0-b49e-3fe6f1ed9c1e","responses":{"200":"ad5d53d0-c0ff-4b4b-a32a-bee0f63f76b7","400":"d2a6916c-ac4c-4e09-8805-6986451b55c2","404":"d0db70bf-ca1d-4c6e-ae7d-03e4d18a075b","422":"700e29ce-e30b-4f77-a21e-b5ca6d983124"},"summary":"Update Bank Account","method":"patch","type":"path","servers":["b5036787-7020-43a8-8dee-cb8b0d270e6a"],"security":["d8f4bc21-1820-4e73-bc5e-ea3b587aeee8"],"path":"/v2/bank-account/{id}","baseUrlOptions":["https://api.spherepay.co"],"title":"Update Bank Account","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"5213472d-860b-4021-991e-a286c48b499d":{"description":"The bank account ID","in":"path","name":"id","required":true,"schema":{"example":"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045","minLength":1,"type":"string","isRequired":true,"description":"The bank account ID","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"Networks","required":["networks"],"properties":{"networks":{"description":"The payment networks supported by this bank account. Must match the bank account currency: USD accounts support [\"ach\", \"wire\"], EUR accounts support [\"sepa\"], BRL accounts support [\"pix\"].","example":["wire","ach"],"items":{"enum":["ach","wire","sepa","pix"],"type":"string","uniqueKey":"oneOf.0.networks.items.[INDEX]","typeLabel":"enum\u003cstring>"},"minItems":1,"type":"array","isRequired":true,"uniqueKey":"oneOf.0.networks","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"oneOf.0","typeLabel":"Networks · object"},{"type":"object","title":"IntermediaryBics","required":["intermediaryBics"],"properties":{"intermediaryBics":{"description":"Ordered list of BIC/SWIFT codes for intermediary correspondent banks used to route the wire to the beneficiary bank. Each BIC must be exactly 8 or 11 characters. At most 3 BICs; no duplicates. Pass an empty array to clear existing intermediary BICs. Only allowed on USD SWIFT bank accounts.","example":["CHASUS33"],"items":{"type":"string","uniqueKey":"oneOf.1.intermediaryBics.items.[INDEX]","typeLabel":"string"},"maxItems":3,"type":"array","isRequired":true,"uniqueKey":"oneOf.1.intermediaryBics","typeLabel":"string[]"}},"uniqueKey":"oneOf.1","typeLabel":"IntermediaryBics · object"}],"uniqueKey":"","typeLabel":"Networks · object | IntermediaryBics · object"},"examples":{"Example":{"title":"Example","value":{"networks":["wire","ach"]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"ad5d53d0-c0ff-4b4b-a32a-bee0f63f76b7":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object","title":"USD","required":["id","status","customerId","created","updated","bankName","accountName","currency","accountDetails","accountOwner","networks"],"properties":{"accountDetails":{"oneOf":[{"type":"object","description":"USD account details. For ACH/Wire: accountNumber, routingNumber, accountType. For SWIFT: accountNumber (masked), bic.","required":["accountNumber","routingNumber","accountType"],"properties":{"accountNumber":{"description":"The bank account number for the US bank account (masked, last 4 characters visible). Present when currency is usd.","example":"****7890","type":"string","isRequired":true,"uniqueKey":"oneOf.0.accountDetails.oneOf.0.accountNumber","typeLabel":"string"},"accountType":{"description":"The type of US bank account. Present when currency is usd.","enum":["checking","savings","instapay","pesonet"],"example":"checking","type":"string","x-enumNames":["Checking","Savings","Instapay","Pesonet"],"isRequired":true,"uniqueKey":"oneOf.0.accountDetails.oneOf.0.accountType","typeLabel":"enum\u003cstring>"},"routingNumber":{"description":"The 9-digit ABA routing number (also known as routing transit number) that identifies the US financial institution. Present when currency is usd.","example":"021000021","type":"string","isRequired":true,"uniqueKey":"oneOf.0.accountDetails.oneOf.0.routingNumber","typeLabel":"string"}},"isRequired":true,"uniqueKey":"oneOf.0.accountDetails.oneOf.0","typeLabel":"object"},{"type":"object","description":"USD account details. For ACH/Wire: accountNumber, routingNumber, accountType. For SWIFT: accountNumber (masked), bic.","required":["accountNumber","bic"],"properties":{"accountNumber":{"description":"The account number for SWIFT transfers (masked, last 4 characters visible). Present when currency is usd and networks is [\"swift\"].","example":"******7890","type":"string","isRequired":true,"uniqueKey":"oneOf.0.accountDetails.oneOf.1.accountNumber","typeLabel":"string"},"bic":{"description":"The BIC/SWIFT code of the beneficiary bank. Present when currency is usd and networks is [\"swift\"].","example":"DEUTDEFF","type":"string","isRequired":true,"uniqueKey":"oneOf.0.accountDetails.oneOf.1.bic","typeLabel":"string"},"intermediaryBics":{"description":"Ordered list of BIC/SWIFT codes for intermediary correspondent banks, if any were set on this account. Omitted from the response when no intermediary BICs are set.","example":["CHASUS33"],"items":{"type":"string","uniqueKey":"oneOf.0.accountDetails.oneOf.1.intermediaryBics.items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"oneOf.0.accountDetails.oneOf.1.intermediaryBics","typeLabel":"string[]"}},"isRequired":true,"uniqueKey":"oneOf.0.accountDetails.oneOf.1","typeLabel":"object"}],"isRequired":true,"uniqueKey":"oneOf.0.accountDetails","typeLabel":"object"},"accountName":{"description":"A descriptive name for this bank account.","example":"Checking Account","type":"string","isRequired":true,"uniqueKey":"oneOf.0.accountName","typeLabel":"string"},"accountOwner":{"description":"Information about the account owner, including their name and relationship to the customer.","properties":{"accountHolderName":{"description":"The name of the account holder as it appears on the bank account.","example":"John Doe","type":"string","isRequired":true,"uniqueKey":"oneOf.0.accountOwner.accountHolderName","typeLabel":"string"},"relationship":{"description":"The relationship of the account owner to the customer.","enum":["self","holding_company","subsidiary_company","branch_office","business_partner","supplier","customer","creditor","debtor","franchisee","unknown"],"example":"self","type":"string","isRequired":true,"uniqueKey":"oneOf.0.accountOwner.relationship","typeLabel":"enum\u003cstring>"}},"required":["accountHolderName","relationship"],"type":"object","isRequired":true,"uniqueKey":"oneOf.0.accountOwner","typeLabel":"object"},"bankName":{"description":"The name of the financial institution where the account is held.","example":"Bank of America","type":"string","isRequired":true,"uniqueKey":"oneOf.0.bankName","typeLabel":"string"},"created":{"description":"The ISO 8601 timestamp when the bank account was created.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.0.created","typeLabel":"string"},"currency":{"description":"The currency of the bank account.","enum":["usd"],"example":"usd","type":"string","isRequired":true,"uniqueKey":"oneOf.0.currency","typeLabel":"enum\u003cstring>"},"customerId":{"description":"The unique identifier of the customer who owns this bank account.","example":"customer_66c4168d418a410eae282b83883bdc39","type":"string","isRequired":true,"uniqueKey":"oneOf.0.customerId","typeLabel":"string"},"id":{"description":"The unique identifier of the bank account.","example":"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045","type":"string","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"networks":{"oneOf":[{"type":"array","items":{"enum":["ach","wire"],"type":"string","uniqueKey":"oneOf.0.networks.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"The payment networks supported by this bank account. For USD ACH/Wire accounts, includes at least one of \"ach\" or \"wire\". For USD SWIFT accounts, is exactly [\"swift\"].","example":["wire","ach"],"isRequired":true,"uniqueKey":"oneOf.0.networks.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"array","items":{"type":"string","enum":["swift"],"uniqueKey":"oneOf.0.networks.oneOf.1.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"The payment networks supported by this bank account. For USD ACH/Wire accounts, includes at least one of \"ach\" or \"wire\". For USD SWIFT accounts, is exactly [\"swift\"].","example":["wire","ach"],"isRequired":true,"uniqueKey":"oneOf.0.networks.oneOf.1","typeLabel":"enum\u003cstring>[]"}],"isRequired":true,"uniqueKey":"oneOf.0.networks","typeLabel":"enum\u003cstring>[]"},"status":{"description":"The current status of the bank account.","enum":["pending","active","inactive","invalid"],"example":"active","type":"string","x-enumNames":["Pending","Active","Inactive","Invalid"],"isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"enum\u003cstring>"},"updated":{"description":"The ISO 8601 timestamp when the bank account was last updated.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.0.updated","typeLabel":"string"}},"uniqueKey":"oneOf.0","typeLabel":"USD · object"},{"type":"object","title":"EUR","required":["id","status","customerId","created","updated","bankName","accountName","currency","accountDetails","accountOwner","networks"],"properties":{"accountDetails":{"description":"EUR/SEPA account details including iban and bic.","properties":{"bic":{"description":"The Bank Identifier Code (BIC), also known as SWIFT code. Present when currency is eur.","example":"COBADEFFXXX","type":"string","isRequired":true,"uniqueKey":"oneOf.1.accountDetails.bic","typeLabel":"string"},"iban":{"description":"The International Bank Account Number (IBAN) for SEPA transfers (masked). Country code, check digits, and last 4 characters are unmasked. Present when currency is eur.","example":"GB29****************6819","type":"string","isRequired":true,"uniqueKey":"oneOf.1.accountDetails.iban","typeLabel":"string"}},"required":["iban","bic"],"type":"object","isRequired":true,"uniqueKey":"oneOf.1.accountDetails","typeLabel":"object"},"accountName":{"description":"A descriptive name for this bank account.","example":"Hauptkonto","type":"string","isRequired":true,"uniqueKey":"oneOf.1.accountName","typeLabel":"string"},"accountOwner":{"description":"Information about the account owner, including their name and relationship to the customer.","properties":{"accountHolderName":{"description":"The name of the account holder as it appears on the bank account.","example":"John Doe","type":"string","isRequired":true,"uniqueKey":"oneOf.1.accountOwner.accountHolderName","typeLabel":"string"},"relationship":{"description":"The relationship of the account owner to the customer.","enum":["self","holding_company","subsidiary_company","branch_office","business_partner","supplier","customer","creditor","debtor","franchisee","unknown"],"example":"self","type":"string","isRequired":true,"uniqueKey":"oneOf.1.accountOwner.relationship","typeLabel":"enum\u003cstring>"}},"required":["accountHolderName","relationship"],"type":"object","isRequired":true,"uniqueKey":"oneOf.1.accountOwner","typeLabel":"object"},"bankName":{"description":"The name of the financial institution where the account is held.","example":"Deutsche Bank","type":"string","isRequired":true,"uniqueKey":"oneOf.1.bankName","typeLabel":"string"},"created":{"description":"The ISO 8601 timestamp when the bank account was created.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.1.created","typeLabel":"string"},"currency":{"description":"The currency of the bank account.","enum":["eur"],"example":"eur","type":"string","isRequired":true,"uniqueKey":"oneOf.1.currency","typeLabel":"enum\u003cstring>"},"customerId":{"description":"The unique identifier of the customer who owns this bank account.","example":"customer_66c4168d418a410eae282b83883bdc39","type":"string","isRequired":true,"uniqueKey":"oneOf.1.customerId","typeLabel":"string"},"id":{"description":"The unique identifier of the bank account.","example":"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045","type":"string","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"networks":{"description":"The payment networks supported by this bank account. For EUR accounts, is exactly [\"sepa\"].","example":["sepa"],"items":{"enum":["sepa"],"type":"string","uniqueKey":"oneOf.1.networks.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"oneOf.1.networks","typeLabel":"enum\u003cstring>[]"},"status":{"description":"The current status of the bank account.","enum":["pending","active","inactive","invalid"],"example":"active","type":"string","x-enumNames":["Pending","Active","Inactive","Invalid"],"isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"enum\u003cstring>"},"updated":{"description":"The ISO 8601 timestamp when the bank account was last updated.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.1.updated","typeLabel":"string"}},"uniqueKey":"oneOf.1","typeLabel":"EUR · object"},{"type":"object","title":"BRL","required":["id","status","customerId","created","updated","bankName","accountName","currency","accountDetails","accountOwner","networks"],"properties":{"accountDetails":{"description":"BRL/PIX account details including pixKey and pixKeyType.","properties":{"pixKey":{"description":"The masked PIX key for Brazilian PIX transfers. Present when currency is brl.","example":"a*c@g***l.com","type":"string","isRequired":true,"uniqueKey":"oneOf.2.accountDetails.pixKey","typeLabel":"string"},"pixKeyType":{"description":"The type of PIX key. Present when currency is brl.","enum":["cpf","cnpj","email","phone","random"],"example":"email","type":"string","isRequired":true,"uniqueKey":"oneOf.2.accountDetails.pixKeyType","typeLabel":"enum\u003cstring>"}},"required":["pixKey","pixKeyType"],"type":"object","isRequired":true,"uniqueKey":"oneOf.2.accountDetails","typeLabel":"object"},"accountName":{"description":"A descriptive name for this bank account.","example":"Conta PIX Alice Santos","type":"string","isRequired":true,"uniqueKey":"oneOf.2.accountName","typeLabel":"string"},"accountOwner":{"description":"Information about the account owner, including their name and relationship to the customer.","properties":{"accountHolderName":{"description":"The name of the account holder as it appears on the bank account.","example":"John Doe","type":"string","isRequired":true,"uniqueKey":"oneOf.2.accountOwner.accountHolderName","typeLabel":"string"},"relationship":{"description":"The relationship of the account owner to the customer.","enum":["self","holding_company","subsidiary_company","branch_office","business_partner","supplier","customer","creditor","debtor","franchisee","unknown"],"example":"self","type":"string","isRequired":true,"uniqueKey":"oneOf.2.accountOwner.relationship","typeLabel":"enum\u003cstring>"}},"required":["accountHolderName","relationship"],"type":"object","isRequired":true,"uniqueKey":"oneOf.2.accountOwner","typeLabel":"object"},"bankName":{"description":"The name of the financial institution where the account is held.","example":"Itau","type":"string","isRequired":true,"uniqueKey":"oneOf.2.bankName","typeLabel":"string"},"created":{"description":"The ISO 8601 timestamp when the bank account was created.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.2.created","typeLabel":"string"},"currency":{"description":"The currency of the bank account.","enum":["brl"],"example":"brl","type":"string","isRequired":true,"uniqueKey":"oneOf.2.currency","typeLabel":"enum\u003cstring>"},"customerId":{"description":"The unique identifier of the customer who owns this bank account.","example":"customer_66c4168d418a410eae282b83883bdc39","type":"string","isRequired":true,"uniqueKey":"oneOf.2.customerId","typeLabel":"string"},"id":{"description":"The unique identifier of the bank account.","example":"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045","type":"string","isRequired":true,"uniqueKey":"oneOf.2.id","typeLabel":"string"},"networks":{"description":"The payment networks supported by this bank account. For BRL accounts, is exactly [\"pix\"].","example":["pix"],"items":{"enum":["pix"],"type":"string","uniqueKey":"oneOf.2.networks.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"oneOf.2.networks","typeLabel":"enum\u003cstring>[]"},"status":{"description":"The current status of the bank account.","enum":["pending","active","inactive","invalid"],"example":"active","type":"string","x-enumNames":["Pending","Active","Inactive","Invalid"],"isRequired":true,"uniqueKey":"oneOf.2.status","typeLabel":"enum\u003cstring>"},"updated":{"description":"The ISO 8601 timestamp when the bank account was last updated.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.2.updated","typeLabel":"string"}},"uniqueKey":"oneOf.2","typeLabel":"BRL · object"},{"type":"object","title":"MXN","required":["id","status","customerId","created","updated","bankName","accountName","currency","accountDetails","accountOwner","networks"],"properties":{"accountDetails":{"description":"MXN/SPEI account details including the masked clabe.","properties":{"clabe":{"description":"The 18-digit CLABE for MXN/SPEI transfers (masked, last 4 digits visible). Present when currency is mxn.","example":"**************7899","type":"string","isRequired":true,"uniqueKey":"oneOf.3.accountDetails.clabe","typeLabel":"string"}},"required":["clabe"],"type":"object","isRequired":true,"uniqueKey":"oneOf.3.accountDetails","typeLabel":"object"},"accountName":{"description":"A descriptive name for this bank account.","example":"Cuenta SPEI María García","type":"string","isRequired":true,"uniqueKey":"oneOf.3.accountName","typeLabel":"string"},"accountOwner":{"description":"Information about the account owner, including their name and relationship to the customer.","properties":{"accountHolderName":{"description":"The name of the account holder as it appears on the bank account.","example":"John Doe","type":"string","isRequired":true,"uniqueKey":"oneOf.3.accountOwner.accountHolderName","typeLabel":"string"},"relationship":{"description":"The relationship of the account owner to the customer.","enum":["self","holding_company","subsidiary_company","branch_office","business_partner","supplier","customer","creditor","debtor","franchisee","unknown"],"example":"self","type":"string","isRequired":true,"uniqueKey":"oneOf.3.accountOwner.relationship","typeLabel":"enum\u003cstring>"}},"required":["accountHolderName","relationship"],"type":"object","isRequired":true,"uniqueKey":"oneOf.3.accountOwner","typeLabel":"object"},"bankName":{"description":"The name of the financial institution where the account is held.","example":"BBVA México","type":"string","isRequired":true,"uniqueKey":"oneOf.3.bankName","typeLabel":"string"},"created":{"description":"The ISO 8601 timestamp when the bank account was created.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.3.created","typeLabel":"string"},"currency":{"description":"The currency of the bank account.","enum":["mxn"],"example":"mxn","type":"string","isRequired":true,"uniqueKey":"oneOf.3.currency","typeLabel":"enum\u003cstring>"},"customerId":{"description":"The unique identifier of the customer who owns this bank account.","example":"customer_66c4168d418a410eae282b83883bdc39","type":"string","isRequired":true,"uniqueKey":"oneOf.3.customerId","typeLabel":"string"},"id":{"description":"The unique identifier of the bank account.","example":"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045","type":"string","isRequired":true,"uniqueKey":"oneOf.3.id","typeLabel":"string"},"networks":{"description":"The payment networks supported by this bank account. For MXN accounts, is exactly [\"spei\"].","example":["spei"],"items":{"enum":["spei"],"type":"string","uniqueKey":"oneOf.3.networks.items.[INDEX]","typeLabel":"enum\u003cstring>"},"type":"array","isRequired":true,"uniqueKey":"oneOf.3.networks","typeLabel":"enum\u003cstring>[]"},"status":{"description":"The current status of the bank account.","enum":["pending","active","inactive","invalid"],"example":"active","type":"string","x-enumNames":["Pending","Active","Inactive","Invalid"],"isRequired":true,"uniqueKey":"oneOf.3.status","typeLabel":"enum\u003cstring>"},"updated":{"description":"The ISO 8601 timestamp when the bank account was last updated.","example":"2025-01-01T00:00:00Z","type":"string","isRequired":true,"uniqueKey":"oneOf.3.updated","typeLabel":"string"}},"uniqueKey":"oneOf.3","typeLabel":"MXN · object"}],"uniqueKey":"","typeLabel":"USD · object | EUR · object | BRL · object | MXN · object"},"examples":{"Example":{"title":"Example","value":{"accountDetails":{"accountNumber":"****7890","accountType":"checking","routingNumber":"021000021"},"accountName":"Checking Account","accountOwner":{"accountHolderName":"John Doe","relationship":"self"},"bankName":"Bank of America","created":"2025-01-01T00:00:00Z","currency":"usd","customerId":"customer_66c4168d418a410eae282b83883bdc39","id":"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045","networks":["wire","ach"],"status":"active","updated":"2025-01-01T00:00:00Z"}}},"exampleType":"generated"}},"description":"","exampleType":"generated"},"d2a6916c-ac4c-4e09-8805-6986451b55c2":{"content":{"application/json":{"examples":{"Bad Request":{"title":"Bad Request","value":{"code":"address/invalid","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Invalid request parameters","status":400}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Bad Request","exampleType":"examples"},"d0db70bf-ca1d-4c6e-ae7d-03e4d18a075b":{"content":{"application/json":{"examples":{"Not Found":{"title":"Not Found","value":{"code":"resource/not-found","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Resource not found","status":404}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Not Found","exampleType":"examples"},"700e29ce-e30b-4f77-a21e-b5ca6d983124":{"content":{"application/json":{"examples":{"Validation Error":{"title":"Validation Error","value":{"code":"validation/failed","correlationId":"28c61e885c6e5eaa78c1a2183a9b883c","detail":"Validation failed","errors":[{"detail":"Invalid email format","pointer":"/email"},{"detail":"Name is required","pointer":"/name"}],"status":422}}},"schema":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"detail","typeLabel":"string"},"status":{"type":"integer","isRequired":true,"uniqueKey":"status","typeLabel":"integer"},"code":{"type":"string","uniqueKey":"code","typeLabel":"string"},"correlationId":{"type":"string","uniqueKey":"correlationId","typeLabel":"string"},"errors":{"items":{"properties":{"detail":{"type":"string","isRequired":true,"uniqueKey":"errors.items.[INDEX].detail","typeLabel":"string"},"header":{"type":"string","uniqueKey":"errors.items.[INDEX].header","typeLabel":"string"},"parameter":{"type":"string","uniqueKey":"errors.items.[INDEX].parameter","typeLabel":"string"},"pointer":{"type":"string","uniqueKey":"errors.items.[INDEX].pointer","typeLabel":"string"}},"required":["detail"],"type":"object","uniqueKey":"errors.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors","typeLabel":"object[]"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"}},"required":["status","detail"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Unprocessable Entity - Validation Error","exampleType":"examples"}},"security":{"d8f4bc21-1820-4e73-bc5e-ea3b587aeee8":{"bearer":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"}}},"servers":{"b5036787-7020-43a8-8dee-cb8b0d270e6a":{"description":"Production","url":"https://api.spherepay.co"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearer"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi/spherepay.yaml"},"subdomain":"spherepayco","siteName":"SpherePay","title":"Update Bank Account Payment Rail Settings - SpherePay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/bank-account/patch-id","matchLevel":0},"es":{"href":"/es/api-reference/bank-account/patch-id","matchLevel":1},"pt-BR":{"href":"/pt-BR/api-reference/bank-account/patch-id","matchLevel":1}}},"lastModified":"2026-07-02T17:17:05.077Z","gitLastModified":"2026-06-18T02:06:27.000Z","originalFileLocation":"api-reference/bank-account/patch-id.mdx","locale":"en"},"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=\"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.\">\u003cmeta data-mint-head name=\"application-name\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Update Bank Account Payment Rail Settings - SpherePay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SpherePay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.spherepay.co/api-reference/bank-account/patch-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://spherepayco.mintlify.app/_mintlify/api/og/v2?division=Bank+Accounts\u0026amp;title=Update+Bank+Account+Payment+Rail+Settings\u0026amp;description=Update+a+bank+account+by+its+ID.+Update+either+the+networks+on+a+non-SWIFT+account%2C+or+the+intermediary+BIC+on+a+USD+SWIFT+account+that+does+not+already+have+on\u0026amp;theme=b4fcde6ac9937acf506a9b2d\u0026amp;signature=53560205d355c8de3c910d99b3a330fd62ed4f4c30a244cfc5f691e296e2d908\">\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=\"Update Bank Account Payment Rail Settings - SpherePay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://spherepayco.mintlify.app/_mintlify/api/og/v2?division=Bank+Accounts\u0026amp;title=Update+Bank+Account+Payment+Rail+Settings\u0026amp;description=Update+a+bank+account+by+its+ID.+Update+either+the+networks+on+a+non-SWIFT+account%2C+or+the+intermediary+BIC+on+a+USD+SWIFT+account+that+does+not+already+have+on\u0026amp;theme=b4fcde6ac9937acf506a9b2d\u0026amp;signature=53560205d355c8de3c910d99b3a330fd62ed4f4c30a244cfc5f691e296e2d908\">\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/spherepayco/MOEcmEf1ysLzlDTM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SpherePay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.spherepay.co/api-reference/bank-account/patch-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/bank-account/patch-id.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.spherepay.co/api-reference/bank-account/patch-id\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.spherepay.co/es/api-reference/bank-account/patch-id\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.spherepay.co/pt-BR/api-reference/bank-account/patch-id\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.spherepay.co/api-reference/bank-account/patch-id\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.spherepay.co/#organization\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/spherepayco/uywNRH6jm1-R-nPL/logo/sphere-light.svg?fit=max\u0026auto=format\u0026n=uywNRH6jm1-R-nPL\u0026q=85\u0026s=783c82452519d50b023b9866c8a1ba48\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.spherepay.co#website\",\"name\":\"SpherePay\",\"url\":\"https://docs.spherepay.co\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id#webpage\",\"url\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id\",\"name\":\"Update Bank Account Payment Rail Settings\",\"description\":\"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.\",\"dateModified\":\"2026-06-18T02:06:27.000Z\",\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"},\"breadcrumb\":{\"@id\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accounts\",\"item\":\"https://docs.spherepay.co/api-reference/bank-account/post\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Bank Accounts\",\"item\":\"https://docs.spherepay.co/api-reference/bank-account/post\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Update Bank Account Payment Rail Settings\",\"item\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id#apireference\",\"headline\":\"Update Bank Account Payment Rail Settings\",\"name\":\"Update Bank Account Payment Rail Settings\",\"description\":\"Update a bank account by its ID. Update either the networks on a non-SWIFT account, or the intermediary BIC on a USD SWIFT account that does not already have one.\",\"url\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id\",\"mainEntityOfPage\":{\"@id\":\"https://docs.spherepay.co/api-reference/bank-account/patch-id#webpage\"},\"dateModified\":\"2026-06-18T02:06:27.000Z\",\"publisher\":{\"@id\":\"https://docs.spherepay.co/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.spherepay.co#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SpherePay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SpherePay","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/introduction"}]},{"tab":"Concepts","pages":[{"title":"Concepts","href":"/concepts/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/implementation-guides/overview"}]},{"tab":"Solutions","pages":[{"title":"Solutions","href":"/solutions/overview"}]},{"tab":"API Reference","groups":[{"group":"Onboarding","pages":[{"group":"Customers","icon":"user","pages":[{"title":"Create an Individual or Business Customer","sidebarTitle":"Create Customer","openapi":"openapi/spherepay.yaml POST /v2/customer","href":"/api-reference/customer/post"},{"title":"List Customers with Filters and Pagination","sidebarTitle":"List Customers","openapi":"openapi/spherepay.yaml GET /v2/customer","href":"/api-reference/customer/get"},{"title":"Retrieve a Customer with Verification Status","sidebarTitle":"Get Customer","openapi":"openapi/spherepay.yaml GET /v2/customer/{id}","href":"/api-reference/customer/get-id"},{"title":"Update Customer Address, Phone, or Email","sidebarTitle":"Update Customer","openapi":"openapi/spherepay.yaml PATCH /v2/customer/{id}","href":"/api-reference/customer/patch-id"}]},{"group":"Onboarding Links","icon":"link","pages":[{"title":"Create Customer via Link","sidebarTitle":"Create Customer via Link","openapi":"openapi/spherepay.yaml POST /v2/customer/kyc-link","href":"/api-reference/customer/kyc-link"},{"title":"Regenerate a Customer's KYC Link","sidebarTitle":"Regenerate KYC Link","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/kyc-link","href":"/api-reference/customer/kyc"}]},{"group":"Documents \u0026 Verification","icon":"file-check","pages":[{"title":"Upload KYC and KYB Identity Documents","sidebarTitle":"Upload Document","openapi":"openapi/spherepay.yaml POST /v2/document","href":"/api-reference/document/post"},{"title":"Generate a Customer Face Verification Link","sidebarTitle":"Face Verification Link","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/face-verification-link","href":"/api-reference/enhanced-due-diligence/face-verification-link"},{"title":"Generate a UBO Face Verification Link for KYB","sidebarTitle":"UBO Face Verification Link","openapi":"openapi/spherepay.yaml POST /v2/business-representative/{id}/face-verification-link","href":"/api-reference/enhanced-due-diligence/ubo-face-verification-link"},{"title":"Send an OTP Code for Customer Verification","sidebarTitle":"Send Verification Code","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-send","href":"/api-reference/enhanced-due-diligence/send-verification-code"},{"title":"Verify a Customer OTP Code for Email or Phone","sidebarTitle":"Verify OTP Code","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/otp-verify","href":"/api-reference/enhanced-due-diligence/verify-verification-code"},{"title":"Record Customer Terms of Service Acceptance","sidebarTitle":"Accept Terms of Service","openapi":"openapi/spherepay.yaml POST /v2/customer/{id}/tos-link","href":"/api-reference/enhanced-due-diligence/tos"}]},{"group":"Business Representatives","icon":"users","pages":[{"title":"Register a Business UBO for KYB Verification","sidebarTitle":"Register Representative","openapi":"openapi/spherepay.yaml POST /v2/business-representative","href":"/api-reference/business-representative/post"},{"title":"List All Business Representatives and UBOs","sidebarTitle":"List Representatives","openapi":"openapi/spherepay.yaml GET /v2/business-representative","href":"/api-reference/business-representative/get"},{"title":"Retrieve a Business Representative by ID","sidebarTitle":"Get Representative","openapi":"openapi/spherepay.yaml GET /v2/business-representative/{id}","href":"/api-reference/business-representative/get-id"},{"title":"Update a Business Representative Before KYB","sidebarTitle":"Update Representative","openapi":"openapi/spherepay.yaml PATCH /v2/business-representative/{id}","href":"/api-reference/business-representative/patch-id"},{"title":"Remove a Business Representative or UBO","sidebarTitle":"Delete Representative","openapi":"openapi/spherepay.yaml DELETE /v2/business-representative/{id}","href":"/api-reference/business-representative/delete-id"}]}]},{"group":"Accounts","pages":[{"group":"Bank Accounts","icon":"landmark","pages":[{"title":"Register a Customer Bank Account for Transfers","sidebarTitle":"Register Bank Account","openapi":"openapi/spherepay.yaml POST /v2/bank-account","href":"/api-reference/bank-account/post"},{"title":"List All Registered Customer Bank Accounts","sidebarTitle":"List Bank Accounts","openapi":"openapi/spherepay.yaml GET /v2/bank-account","href":"/api-reference/bank-account/get"},{"title":"Retrieve a Bank Account by ID","sidebarTitle":"Get Bank Account","openapi":"openapi/spherepay.yaml GET /v2/bank-account/{id}","description":"Get information about a bank account by its ID","href":"/api-reference/bank-account/get-id"},{"title":"Update Bank Account Payment Rail Settings","sidebarTitle":"Update Bank Account","openapi":"openapi/spherepay.yaml PATCH /v2/bank-account/{id}","href":"/api-reference/bank-account/patch-id"},{"title":"Delete a Registered Customer Bank Account","sidebarTitle":"Delete Bank Account","openapi":"openapi/spherepay.yaml DELETE /v2/bank-account/{id}","description":"Delete a bank account by its ID.","href":"/api-reference/bank-account/delete-id"}]},{"group":"Wallets","icon":"wallet","pages":[{"title":"Register a Customer Crypto Wallet for Transfers","sidebarTitle":"Register Wallet","openapi":"openapi/spherepay.yaml POST /v2/wallet","href":"/api-reference/wallet/post"},{"title":"List All Registered Customer Crypto Wallets","sidebarTitle":"List Wallets","openapi":"openapi/spherepay.yaml GET /v2/wallet","href":"/api-reference/wallet/get"},{"title":"Retrieve a Customer Crypto Wallet by ID","sidebarTitle":"Get Wallet","openapi":"openapi/spherepay.yaml GET /v2/wallet/{id}","href":"/api-reference/wallet/get-id"},{"title":"Remove a Registered Customer Crypto Wallet","sidebarTitle":"Delete Wallet","openapi":"openapi/spherepay.yaml DELETE /v2/wallet/{id}","href":"/api-reference/wallet/delete-id"}]}]},{"group":"Money movement","pages":[{"group":"Transfers","icon":"arrow-right-left","pages":[{"title":"Create an On-Ramp or Off-Ramp Transfer","sidebarTitle":"Create Transfer","openapi":"openapi/spherepay.yaml POST /v2/transfer","href":"/api-reference/transfer/post"},{"title":"List On-Ramp and Off-Ramp Transfers","sidebarTitle":"List Transfers","openapi":"openapi/spherepay.yaml GET /v2/transfer","href":"/api-reference/transfer/get"},{"title":"Retrieve a Transfer with Deposit Instructions","sidebarTitle":"Get Transfer","openapi":"openapi/spherepay.yaml GET /v2/transfer/{id}","href":"/api-reference/transfer/get-id"},{"title":"Cancel an Unfunded Pending Transfer","sidebarTitle":"Cancel Transfer","openapi":"openapi/spherepay.yaml DELETE /v2/transfer/{id}","href":"/api-reference/transfer/delete-id"}]},{"group":"Quotes","icon":"calculator","pages":[{"title":"Create a Rate-Locked Quote","sidebarTitle":"Create Quote","openapi":"openapi/spherepay.yaml POST /v2/quote","href":"/api-reference/quote/post"},{"title":"List All Rate-Locked Quotes for Your Account","sidebarTitle":"List Quotes","openapi":"openapi/spherepay.yaml GET /v2/quote","href":"/api-reference/quote/get"},{"title":"Retrieve a Quote by ID","sidebarTitle":"Get Quote","openapi":"openapi/spherepay.yaml GET /v2/quote/{id}","href":"/api-reference/quote/get-id"},{"title":"Update Quote Status","sidebarTitle":"Update Quote","openapi":"openapi/spherepay.yaml PUT /v2/quote/{id}","href":"/api-reference/quote/put-id"}]},{"group":"Virtual Accounts","icon":"credit-card","pages":[{"title":"Create a Virtual Bank Account for Fiat On-Ramp","sidebarTitle":"Create Virtual Account","openapi":"openapi/spherepay.yaml POST /v2/virtual-account","href":"/api-reference/virtual-account/post"},{"title":"List All Onramper Virtual Bank Accounts","sidebarTitle":"List Virtual Accounts","openapi":"openapi/spherepay.yaml GET /v2/virtual-account","href":"/api-reference/virtual-account/get"},{"title":"Retrieve an Onramper Account by ID","sidebarTitle":"Get Virtual Account","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}","href":"/api-reference/virtual-account/get-id"},{"title":"Update an Onramper Account Destination Wallet","sidebarTitle":"Update Virtual Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}","href":"/api-reference/virtual-account/patch"},{"title":"List Transfers for an Onramper Account","sidebarTitle":"List Account Transfers","openapi":"openapi/spherepay.yaml GET /v2/virtual-account/{virtualAccountId}/transfer","href":"/api-reference/virtual-account/list-transfers"},{"title":"Deactivate an Onramper Virtual Bank Account","sidebarTitle":"Deactivate Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/deactivate","href":"/api-reference/virtual-account/deactivate"},{"title":"Reactivate a Deactivated Onramper Account","sidebarTitle":"Reactivate Account","openapi":"openapi/spherepay.yaml PATCH /v2/virtual-account/{virtualAccountId}/reactivate","href":"/api-reference/virtual-account/reactivate"}]},{"group":"Offloader Wallets","icon":"arrow-up-from-line","pages":[{"title":"Create an Offloader Wallet for Crypto Payouts","sidebarTitle":"Create Offloader Wallet","openapi":"openapi/spherepay.yaml POST /v2/offloader-wallet","href":"/api-reference/offloader-wallet/post"},{"title":"List All Offloader Wallets for Your Account","sidebarTitle":"List Offloader Wallets","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet","href":"/api-reference/offloader-wallet/get"},{"title":"Retrieve an Offloader Wallet by ID","sidebarTitle":"Get Offloader Wallet","openapi":"openapi/spherepay.yaml GET /v2/offloader-wallet/{id}","href":"/api-reference/offloader-wallet/get-id"},{"title":"Update an Offloader Wallet Bank Destination","sidebarTitle":"Update Offloader Wallet","openapi":"openapi/spherepay.yaml PATCH /v2/offloader-wallet/{id}","href":"/api-reference/offloader-wallet/patch-id"}]}]},{"group":"Webhooks","pages":[{"group":"Webhook Endpoints","icon":"plug","pages":[{"title":"Register a Webhook Endpoint for Event Delivery","sidebarTitle":"Create Webhook Endpoint","openapi":"openapi/spherepay.yaml POST /v2/webhook-endpoints","href":"/api-reference/webhook-endpoints/post"},{"title":"List All Registered Webhook Endpoints","sidebarTitle":"List Webhook Endpoints","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints","href":"/api-reference/webhook-endpoints/get"},{"title":"Retrieve a Webhook Endpoint by ID","sidebarTitle":"Get Webhook Endpoint","openapi":"openapi/spherepay.yaml GET /v2/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/get-id"},{"title":"Delete a Webhook Endpoint","sidebarTitle":"Delete Webhook Endpoint","openapi":"openapi/spherepay.yaml DELETE /v2/webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/delete-id"}]},{"group":"Events","icon":"bell","pages":[{"title":"List Events and Their Delivery Status","sidebarTitle":"List Events","openapi":"openapi/spherepay.yaml GET /v2/events","href":"/api-reference/events/get"},{"title":"Retrieve an Event with Full Delivery History","sidebarTitle":"Get Event","openapi":"openapi/spherepay.yaml GET /v2/events/{id}","href":"/api-reference/events/get-id"},{"title":"Replay a Failed Event Delivery","sidebarTitle":"Replay Delivery","openapi":"openapi/spherepay.yaml POST /v2/events/replay/{eventDeliveryId}","href":"/api-reference/events/replay"}]}]}]},{"tab":"Releases","pages":[{"title":"Releases","href":"/changelog"}]},{"tab":"FAQ","href":"https://spherepay-knowledge-base.help.usepylon.com/"}]},{"language":"es","pages":[{"title":"es","href":"/es/api-reference/bank-account/patch-id"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-BR/api-reference/bank-account/patch-id"}]}]},"basePath":"","title":"Update Bank Account Payment Rail Settings - SpherePay","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}