Setting the Issuer's Primary Bank Account
This endpoint promotes an existing issuer bank account to primary (is_default: true). The account previously marked as primary automatically becomes is_default: false.
Swapping the issuer's primary bank account
An issuer may have several registered bank accounts, but only one is marked as primary. To correct a primary account with incorrect data (digit, branch, ISPB), use the flow below.
The issuer must be in in_filling status. After that status, the primary account cannot be changed — this is intentional, since the primary account is referenced by financial operations.
Swap flow (3 calls)
- POST
.../bank_account→ creates the new (correct) account. - POST
.../bank_account/{key}/set_default→ promotes the new account to primary. - DELETE
.../bank_account/{old_key}→ removes the old account.
The same ordering restriction applies: since deleting the primary account is not allowed, promotion must come before removal. Reversing the order returns HTTP 400 / ISS0000012.
Request
Path Params
| Field | Type | Description | Characters |
|---|---|---|---|
ISSUER-KEY | string | Unique issuer key (UUID v4). | 36 |
BANK-ACCOUNT-KEY | string | Unique key of the bank account to be promoted to primary (UUID v4). | 36 |
Request Body
No content is sent in the request body.
Response
Account promoted to primary. No content is returned in the response body.
Errors
| HTTP | Code | Scenario |
|---|---|---|
| 400 | ISS0000011 | Issuer is not in in_filling. |
| 403 | ISS000011 | Tenant does not have access to this issuer. |
| 404 | ISS000005 | bank_account_key not found for this issuer. |
| 404 | ISS000009 | issuer_key not found. |