Skip to main content
POST
Issue cards

Authorizations

x-api-key
string
header
required

Body

application/json
bin_id
string
required
Example:

"67c401f9a5b7cde210f44567"

balance_type
enum<string>
required

Whether the card runs on a stored balance or a spending limit. The chosen model must be supported by the BIN (see balance_possibility / limit_possibility on GET /bins).

Available options:
balance,
limit
Example:

"limit"

name
string
required
Example:

"Marketing card"

user_id
string
Example:

"67fc3d09766d7a2c1fafef99"

notes
string
Example:

"Q3 campaigns"

balance_threshold
number
Example:

25

top_up_amount
number
Example:

100

quantity
integer

Number of cards to issue. Either quantity or the legacy alias amount must be present.

Required range: x >= 1
Example:

1

amount
integer

Legacy alias for quantity. Prefer quantity.

Required range: x >= 1
Example:

1

limit_amount
number | null

Spending limit for balance_type "limit". null = unlimited card, 0 = card cannot spend. Ignored for balance cards.

Required range: x <= 1000000
Example:

500

limit_period
enum<string>

Reset period of the spending limit. Only for balance_type "limit"; defaults to "all_time" when a limit amount is given without a period. "per_transaction" caps each single operation instead of a rolling window.

Available options:
one_day,
seven_days,
thirty_days,
all_time,
per_transaction
Example:

"thirty_days"

promo
string
Example:

"WELCOME"

Response

Success

result
object[]
required