Issue New Bank Card

POST 
/api/v2/cards/

Issues a new bank card based on the provided details. This endpoint facilitates the creation of bank cards, allowing for customization of card names, setting limits, initial balance, and auto top-up configurations.

Request

application/json

Body

required

binCode Bincoderequired

The Bank Identification Number (BIN) that determines the card network and bank.

cardName Cardnamerequired

The name or alias for the new card.

limits object

single object

The maximum amount for a single transaction.

amount Amount

The limit amount.

daily object

The maximum total amount for all transactions in a day.

amount Amount

The limit amount.

monthly object

The maximum total amount for all transactions in a month.

amount Amount

The limit amount.

cardBalance Cardbalance

The initial balance of the card.

cardsCount Cardscount

The number of cards to issue.

autoTopUp object

thresholdAmount Thresholdamountrequired

The balance threshold to trigger an automatic top-up.

topUpAmount Topupamountrequired

The amount to be automatically topped up when the threshold is reached.

walletId uuid

The unique identifier of the wallet to which the card is associated.

ownerId Ownerid

The unique identifier of the owner of the card.

isShared Issharedrequired

A flag indicating whether the card is shared with other users.

shouldCreateNewWallet Shouldcreatenewwalletrequired

A flag indicating whether a new wallet should be created for the card.

Responses

200

Successful Response

application/json

Schema

Schema

code Code

Default value: 200

detail Detail

Default value: ok

Example (from schema)

{
  "code": 200,
  "detail": "ok"
}

422

Validation Error

application/json

Schema

Schema

detail object[]
Array [
loc object[]required
Array [
anyOf
MOD1
string
MOD2
integer
]
msg Messagerequired
type Error Typerequired
]

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...