Update Counterparty Account
PUT/v1/crossborder/counterparties/:id/accounts/:account_id
Update an existing bank account for a crossborder counterparty. Only provided fields will be updated.
Request
Path Parameters
Counterparty ID.
Account ID.
Header Parameters
- If there's no value: The default protection checks that the values in this request are equal: { method, params, path, query, body, userId }. This means that if a request repeats the same values, it will be blocked.
- 'nonce': The nonce and { method, params, path, query, body, userId } value are checked. When the protection schema is this, requests will be OK if this nonce value is different in each request.
- 'x-transaction-uuid': The transactionId and { method, params, path, query, body, userId } value are checked. Requests will be OK if this x-transaction-uuid value is different in each request.
- 'x-transaction-uuid&nonce' or 'nonce&x-transaction-uuid': The nonce, transactionId value and { method, params, path, query, body, userId } are checked, i.e. if requests are repeated the same value in both fields, they will be blocked. But if any field has a different value, the request is OK.
The replay-protection-schema allows the user to choose between 3 options:
The nonce ID is a UUID (v4) used to uniquely identify the request. All requests must have an identifier.
Possible values: [pt-BR, en-US]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
The product ID is a UUID (v4) used to identify the Z.ro product configuration.
The product target user ID is a UUID (v4) used to identify what user account this request must be executed. Require: x-product-uuid.
- application/json
Body
required
Country code.
Currency symbol.
Account ID.
Account type.
Account number.
Branch number.
Bank name.
Bank code.
Bank code type.
Responses
- 200
- 400
- 401
- 422
Counterparty account updated successfully.
- application/json
- Schema
- Example (from schema)
Schema
Account ID.
User ID.
Counterparty ID.
Country code.
Currency symbol.
Account ID.
Account type.
Account number.
Branch number.
Bank name.
Bank code.
Bank code type.
Account created date.
Account updated date.
{
"id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"user_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"counterparty_id": "f6e2e084-29b9-4935-a059-5473b13033aa",
"country": "US",
"currency_symbol": "USD",
"account_id": "1234567890",
"account_type": "CHECKING",
"account_number": "12345678",
"branch": "0001",
"bank_name": "Bank of America",
"bank_code": "BOFAUS3N",
"bank_code_type": "BIC",
"created_at": "2026-01-23T18:06:53.183Z",
"updated_at": "2026-01-23T18:06:53.183Z"
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.