Skip to main content

Your account

Your account holds your balance. Every card funding is drawn from it, and every unload and termination refund comes back to it.

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 as SGVISAV01. 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:
In the sandbox, cards are issued on two test BINs: 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 in GET /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.