Skip to main content
POST
Create card

Authorizations

Authorization
string
header
required

Your API key from Console → Settings → Key & Access, sent as Authorization: Bearer ncl_....

Body

application/json
bin
string
required

Card BIN or BIN ID. The id or bin field returned by List available BINs

amount
string
required

Initial top-up amount (up to 2 decimal places)

ipAddress
string
required

Required for B2C BINs: the cardholder's real IP address

clientTransactionId
string

Your transaction reference

holder
object

Cardholder details

physical
string

Issue a physical card. 1: physical card, 0: virtual card

accountId
integer

Sub-account ID

cardholderId
string

Cardholder ID. Required in B2C mode

Response

200 - application/json

Success

code
integer
required
msg
string
required
data
string
required

Transaction ID. Returned as trade_id in the webhook so you can match it to your records