Actualizar la Configuración de Rieles de Pago de la Cuenta Bancaria

curl --request PATCH \ --url https://api.spherepay.co/v2/bank-account/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "networks": [ "ach", "wire" ] } '

{ "id": "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045", "status": "active", "bankName": "Chase", "accountName": "Jane Doe Checking", "customerId": "customer_66c4168d418a410eae282b83883bdc39", "created": "2025-01-01T00:00:00Z", "updated": "2025-01-02T09:15:00Z", "currency": "usd", "accountDetails": { "accountNumber": "****7890", "routingNumber": "021000021", "accountType": "checking" }, "accountOwner": { "accountHolderName": "Jane Doe", "relationship": "self" }, "networks": [ "ach", "wire" ] }

Autorizaciones

Authorization

string

header

requerido

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Parámetros de ruta

string

requerido

The bank account ID

Minimum string length: 1

Ejemplo:

"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045"

Cuerpo

application/json

networks

enum<string>[]

requerido

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"].

Minimum array length: 1

Opciones disponibles:

ach,

wire,

sepa,

pix

Ejemplo:

["wire", "ach"]

Respuesta

string

requerido

The unique identifier of the bank account.

Ejemplo:

"bankAccount_ce745ef7f3df4b9a8bff1301ce24b045"

status

enum<string>

requerido

The current status of the bank account.

Opciones disponibles:

pending,

active,

inactive,

invalid

Ejemplo:

"active"

bankName

string

requerido

The name of the financial institution where the account is held.

Ejemplo:

"Bank of America"

accountName

string

requerido

A descriptive name for this bank account.

Ejemplo:

"Checking Account"

customerId

string

requerido

The unique identifier of the customer who owns this bank account.

Ejemplo:

"customer_66c4168d418a410eae282b83883bdc39"

created

string

requerido

The ISO 8601 timestamp when the bank account was created.

Ejemplo:

"2025-01-01T00:00:00Z"

updated

string

requerido

The ISO 8601 timestamp when the bank account was last updated.

Ejemplo:

"2025-01-01T00:00:00Z"

currency

enum<string>

requerido

The currency of the bank account.

Opciones disponibles:

usd

Ejemplo:

"usd"

accountDetails

object

requerido

USD account details including accountNumber, routingNumber, and accountType.

Show child attributes

accountOwner

object

requerido

Information about the account owner, including their name and relationship to the customer.

Show child attributes

networks

enum<string>[]

requerido

The payment networks supported by this bank account. For USD accounts, includes at least one of "ach" or "wire".

Opciones disponibles:

ach,

wire

Ejemplo:

["wire", "ach"]