Skip to main content
POST
Create a new card

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
type
enum<string>
required

Card type

Available options:
ChipAndPin,
Virtual,
Disposable
password
string
required

3D Secure password

Example:

"12345678AAaa!"

walletDescription
string

Description for wallet

Example:

"My First Wallet"

walletColor
string

Color for wallet label

Example:

"#FF453A"

walletCurrencyId
string
default:EUR

Currency for a newly created card wallet. Defaults to EUR when omitted.

Maximum string length: 3
Example:

"EUR"

walletId

Card wallet integer ID or UUID

Example:

1

feeWalletId

Wallet integer ID or UUID for debiting commission. Required when card issue and delivery fees exceed zero.

Example:

1

firstName
string

Delivery recipient first name. Used for ChipAndPin cards.

Example:

"Aliaksandr"

lastName
string

Delivery recipient last name. Used for ChipAndPin cards.

Example:

"Lastname"

street
string

Delivery street. Used for ChipAndPin cards.

Example:

"Gagarina street"

house
string

Delivery house number. Used for ChipAndPin cards.

Example:

"22"

apartment
string | null

Optional apartment number. When provided, the total length of house and apartment must not exceed 43 characters.

Maximum string length: 8
Example:

"12B"

city
string

Delivery city. Used for ChipAndPin cards.

Example:

"London"

countryId
string

Delivery country Alpha-2 code. Used for ChipAndPin cards.

Example:

"LV"

postalCode
string

Delivery postal code. Used for ChipAndPin cards.

Example:

"10001"

phone
string

Delivery phone. Used for ChipAndPin cards.

Example:

"+48511155588"

phone3ds
string

3D Secure phone number

Example:

"+48511155588"

email3ds
string | null

3D Secure email

Example:

"client@example.com"

deliveryType
enum<string>

Delivery type. Used for ChipAndPin cards.

Available options:
Standard,
Express
signToken
string

MFA sign token

Example:

""

Response

Card created

status
string
data
object