Your account
Your account holds your balance. Every card funding is drawn from it, and every unload and termination refund comes back to it.- Read it with
GET /balance. - Top it up from the CaaS portal;
GET /deposit-addressreturns your deposit addresses. - When it falls below your low-balance threshold, you receive
ACCOUNT_LOW_BALANCE.
BINs
A BIN is the range a card number starts with, and it decides what the card is: Visa or Mastercard, the country it is issued in, and what it supports (Apple Pay, Google Pay, 3D Secure). Those capabilities belong to the BIN and cannot be switched on per card. Each BIN has a BIN ID such asSGVISAV01. GET /bins lists
the BINs on your account with their IDs, capabilities and settings, and issuable tells you whether
cards can be issued on each one right now. A BIN ID is letters and digits only, with no
separators. It is what you send to issue a card:
TESTVISAV and TESTMCV.
What a BIN decides for its cards
Each BIN on your account carries the settings every card issued on it follows. You see them inGET /bins and on the BIN’s page in your dashboard; your account
manager sets them up with you.
Every card is issued with an opening
amount, its first load (400 CARD_AMOUNT_REQUIRED without
one).
Integrations written before BINs issue cards with a
productId. That still works: the card is
issued on that product’s BIN. New integrations should send binId.Amounts
Amounts you send, and the amounts on cards, transactions and your balance, are dollars as a number:50.00 is fifty dollars.
