Create and issue a new card. Funds are debited from the `accountId` you provide (client or user). For user-funded issuances, fees are charged to the user first and then to the parent client account.
Request body
application/json
· CardIssueRequest
· required
| Field | Type | Required | Description |
|---|---|---|---|
accountId |
string |
yes | Account ID that will be debited for issuing the card. |
balance |
string |
yes | Initial balance for the issued card. |
bin |
string |
yes | Target BIN code for the new card. |
cardholderId |
string |
no | Cardholder UUID for B2B cards. Create a cardholder first (see Cardholders endpoints), wait for pass_audit status, then pass the ID here. |
externalUserId |
string |
no | Reference identifier for the issued card. |
idempotencyKey |
string |
no | Idempotency key, must be unique for each request. |
Responses
| Status | Body | Description |
|---|---|---|
200 |
Card |
Existing successful card issue result returned for an idempotent replay of the same request. |
201 |
Card |
Successfully issued a new card. |
409 |
Error |
The provided `idempotencyKey` conflicts with an in-flight request or was reused with a different payload. |
Specification
This page is generated from the OpenAPI specification, which remains the authoritative machine-readable source.