> ## Documentation Index > Fetch the complete documentation index at: https://docs.spherepay.co/llms.txt > Use this file to discover all available pages before exploring further. # Actualizar Configuración de Rieles de la Cuenta Bancaria > 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. Usa este endpoint para actualizar una cuenta bancaria registrada. Actualmente, el único campo mutable es `networks`, que controla qué rieles de pago están habilitados para la cuenta. El nuevo valor de `networks` debe ser compatible con la divisa de la cuenta — no puedes agregar una red incompatible después de la creación. ## OpenAPI ````yaml openapi/spherepay.yaml PATCH /v2/bank-account/{id} openapi: 3.0.0 info: title: '' description: '' version: 1.0.0 contact: {} servers: - url: https://api.spherepay.co description: Production security: - bearer: [] tags: [] paths: /v2/bank-account/{id}: patch: summary: Update Bank Account 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. parameters: - name: id required: true in: path description: The bank account ID schema: minLength: 1 example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string requestBody: required: true content: application/json: schema: oneOf: - title: Networks type: object 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 type: array minItems: 1 items: type: string enum: - ach - wire - sepa - pix required: - networks - title: IntermediaryBics type: object 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 type: array maxItems: 3 items: type: string required: - intermediaryBics responses: '200': description: '' content: application/json: schema: oneOf: - title: USD type: object properties: id: description: The unique identifier of the bank account. example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string status: description: The current status of the bank account. example: active type: string enum: - pending - active - inactive - invalid x-enumNames: - Pending - Active - Inactive - Invalid customerId: description: >- The unique identifier of the customer who owns this bank account. example: customer_66c4168d418a410eae282b83883bdc39 type: string created: description: >- The ISO 8601 timestamp when the bank account was created. example: '2025-01-01T00:00:00Z' type: string updated: description: >- The ISO 8601 timestamp when the bank account was last updated. example: '2025-01-01T00:00:00Z' type: string bankName: description: >- The name of the financial institution where the account is held. example: Bank of America type: string accountName: description: A descriptive name for this bank account. example: Checking Account type: string currency: description: The currency of the bank account. example: usd type: string enum: - usd accountDetails: description: >- USD account details. For ACH/Wire: accountNumber, routingNumber, accountType. For SWIFT: accountNumber (masked), bic. oneOf: - type: object 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 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 accountType: description: >- The type of US bank account. Present when currency is usd. example: checking type: string enum: - checking - savings - instapay - pesonet x-enumNames: - Checking - Savings - Instapay - Pesonet required: - accountNumber - routingNumber - accountType - type: object 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 bic: description: >- The BIC/SWIFT code of the beneficiary bank. Present when currency is usd and networks is ["swift"]. example: DEUTDEFF type: 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 type: array items: type: string required: - accountNumber - bic accountOwner: description: >- Information about the account owner, including their name and relationship to the customer. type: object properties: accountHolderName: description: >- The name of the account holder as it appears on the bank account. example: John Doe type: string relationship: description: >- The relationship of the account owner to the customer. example: self type: string enum: - self - holding_company - subsidiary_company - branch_office - business_partner - supplier - customer - creditor - debtor - franchisee - unknown required: - accountHolderName - relationship networks: 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 oneOf: - type: array items: type: string enum: - ach - wire - type: array items: oneOf: - type: string enum: - swift required: - id - status - customerId - created - updated - bankName - accountName - currency - accountDetails - accountOwner - networks - title: EUR type: object properties: id: description: The unique identifier of the bank account. example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string status: description: The current status of the bank account. example: active type: string enum: - pending - active - inactive - invalid x-enumNames: - Pending - Active - Inactive - Invalid customerId: description: >- The unique identifier of the customer who owns this bank account. example: customer_66c4168d418a410eae282b83883bdc39 type: string created: description: >- The ISO 8601 timestamp when the bank account was created. example: '2025-01-01T00:00:00Z' type: string updated: description: >- The ISO 8601 timestamp when the bank account was last updated. example: '2025-01-01T00:00:00Z' type: string bankName: description: >- The name of the financial institution where the account is held. example: Deutsche Bank type: string accountName: description: A descriptive name for this bank account. example: Hauptkonto type: string currency: description: The currency of the bank account. example: eur type: string enum: - eur accountDetails: description: EUR/SEPA account details including iban and bic. type: object properties: 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 bic: description: >- The Bank Identifier Code (BIC), also known as SWIFT code. Present when currency is eur. example: COBADEFFXXX type: string required: - iban - bic accountOwner: description: >- Information about the account owner, including their name and relationship to the customer. type: object properties: accountHolderName: description: >- The name of the account holder as it appears on the bank account. example: John Doe type: string relationship: description: >- The relationship of the account owner to the customer. example: self type: string enum: - self - holding_company - subsidiary_company - branch_office - business_partner - supplier - customer - creditor - debtor - franchisee - unknown required: - accountHolderName - relationship networks: description: >- The payment networks supported by this bank account. For EUR accounts, is exactly ["sepa"]. example: - sepa type: array items: type: string enum: - sepa required: - id - status - customerId - created - updated - bankName - accountName - currency - accountDetails - accountOwner - networks - title: BRL type: object properties: id: description: The unique identifier of the bank account. example: bankAccount_ce745ef7f3df4b9a8bff1301ce24b045 type: string status: description: The current status of the bank account. example: active type: string enum: - pending - active - inactive - invalid x-enumNames: - Pending - Active - Inactive - Invalid customerId: description: >- The unique identifier of the customer who owns this bank account. example: customer_66c4168d418a410eae282b83883bdc39 type: string created: description: >- The ISO 8601 timestamp when the bank account was created. example: '2025-01-01T00:00:00Z' type: string updated: description: >- The ISO 8601 timestamp when the bank account was last updated. example: '2025-01-01T00:00:00Z' type: string bankName: description: >- The name of the financial institution where the account is held. example: Itaú type: string accountName: description: A descriptive name for this bank account. example: Conta PIX Alice Santos type: string currency: description: The currency of the bank account. example: brl type: string enum: - brl accountDetails: description: >- BRL/PIX account details including pixKey and pixKeyType. type: object properties: pixKey: description: >- The masked PIX key for Brazilian PIX transfers. Present when currency is brl. example: a*c@g***l.com type: string pixKeyType: description: The type of PIX key. Present when currency is brl. example: email type: string enum: - cpf - cnpj - email - phone - random required: - pixKey - pixKeyType accountOwner: description: >- Information about the account owner, including their name and relationship to the customer. type: object properties: accountHolderName: description: >- The name of the account holder as it appears on the bank account. example: John Doe type: string relationship: description: >- The relationship of the account owner to the customer. example: self type: string enum: - self - holding_company - subsidiary_company - branch_office - business_partner - supplier - customer - creditor - debtor - franchisee - unknown required: - accountHolderName - relationship networks: description: >- The payment networks supported by this bank account. For BRL accounts, is exactly ["pix"]. example: - pix type: array items: type: string enum: - pix required: - id - status - customerId - created - updated - bankName - accountName - currency - accountDetails - accountOwner - networks '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ProblemDetailsDto' examples: Bad Request: summary: Bad Request value: status: 400 detail: Invalid request parameters code: address/invalid correlationId: 28c61e885c6e5eaa78c1a2183a9b883c '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ProblemDetailsDto' examples: Not Found: summary: Not Found value: status: 404 detail: Resource not found code: resource/not-found correlationId: 28c61e885c6e5eaa78c1a2183a9b883c '422': description: Unprocessable Entity - Validation Error content: application/json: schema: $ref: '#/components/schemas/ProblemDetailsDto' examples: Validation Error: summary: Validation Error value: status: 422 detail: Validation failed code: validation/failed correlationId: 28c61e885c6e5eaa78c1a2183a9b883c errors: - detail: Invalid email format pointer: /email - detail: Name is required pointer: /name components: schemas: ProblemDetailsDto: type: object properties: title: type: string status: type: integer detail: type: string code: type: string errors: type: array items: type: object properties: detail: type: string pointer: type: string parameter: type: string header: type: string required: - detail correlationId: type: string required: - status - detail securitySchemes: bearer: scheme: bearer bearerFormat: JWT type: http ````