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

FieldTypeRequiredDescription
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

StatusBodyDescription
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.
503 Error

No card could be issued at this moment. Nothing is wrong with the request and no funds were taken: the amount held for the issue has been released. Retry shortly with a new idempotencyKey — the failed key keeps answering with this same result.

Specification

This page is generated from the OpenAPI specification, which remains the authoritative machine-readable source.