Setting the Issuer's Primary Contact
This endpoint promotes an existing issuer contact to primary (is_default: true). The contact previously marked as primary automatically becomes is_default: false.
Swapping the issuer's primary contact
An issuer may have multiple registered contacts, but only one is marked as primary. If the primary contact was registered with incorrect data (typo in the e-mail, wrong digit in the phone number), use the flow below to replace it.
The issuer must be in in_filling status. Once the issuer leaves that status, changes to the primary contact/account are not allowed — the endpoint will return HTTP 400 / ISS0000011.
Swap flow (3 calls)
- POST
.../issuer_contact_information→ creates the new (correct) contact. - POST
.../issuer_contact_information/{key}/set_default→ promotes the new contact to primary. - DELETE
.../issuer_contact_information/{old_key}→ removes the old contact (with the typo).
Order matters: since deleting a contact marked as primary is not allowed, you must promote the new contact before deleting the old one. Reversing the order returns HTTP 400 / ISS0000013.
Request
Path Params
| Field | Type | Description | Characters |
|---|---|---|---|
ISSUER-KEY | string | Unique issuer key (UUID v4). | 36 |
ISSUER-CONTACT-INFORMATION-KEY | string | Unique key of the contact to be promoted to primary (UUID v4). | 36 |
Request Body
No content is sent in the request body.
Response
Contact 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 | ISS000008 | issuer_contact_information_key not found for this issuer. |
| 404 | ISS000009 | issuer_key not found. |