Effortless customer verification now available   View changelog →
Sphere Paysphere
Bank Account

Update Bank Account

Update a bank account by its ID. Only the networks field can be updated.

PATCH
/v2/bank-account/{id}

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

The bank account ID

Length1 <= length

Request Body

networksarray<string>

The payment networks supported by this bank account. Must match the bank account currency: USD accounts support ["ach", "wire"], EUR accounts support ["sepa"].

Response Body

curl -X PATCH "https://api.spherepay.co/v2/bank-account/bankAccount_ce745ef7f3df4b9a8bff1301ce24b045" \
  -H "Content-Type: application/json" \
  -d '{
    "networks": [
      "wire",
      "ach"
    ]
  }'
{
  "id": "bankAccount_ce745ef7f3df4b9a8bff1301ce24b045",
  "status": "active",
  "bankName": "Chase Bank",
  "accountName": "Checking Account",
  "customerId": "customer_66c4168d418a410eae282b83883bdc39",
  "created": "2025-01-01T00:00:00Z",
  "updated": "2025-01-01T00:00:00Z",
  "currency": "usd",
  "accountDetails": {
    "accountNumber": "****7890",
    "routingNumber": "021000021",
    "accountType": "checking"
  },
  "accountOwner": {
    "accountHolderName": "John Doe",
    "relationship": "self"
  },
  "networks": [
    "wire",
    "ach"
  ]
}

{
  "status": 400,
  "detail": "Invalid request parameters",
  "code": "address/invalid",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 404,
  "detail": "Resource not found",
  "code": "resource/not-found",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 422,
  "detail": "Validation failed",
  "code": "validation/failed",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
  "errors": [
    {
      "detail": "Invalid email format",
      "pointer": "/email"
    },
    {
      "detail": "Name is required",
      "pointer": "/name"
    }
  ]
}