Cards

/docs/global/api-reference/cardsGlobal

for the full conceptual guide. This page is the flat endpoint index.

Authenticated by session — and a different product surface

Cards are authorized by a signed-in user session, the same as every resource on this reference except the developer probe — see Authentication. Note this is the personal/consumer card-issuing surface, not a merchant sub-resource; paths below are relative to https://binkpay.net/api/v1.

POST/api/v1/cards

Issue a card immediately (requires KYC).

POST/api/v1/cards/request

Create a pending card application routed through approvals.

GET/api/v1/cards

List cards.

PATCH/api/v1/cards/:id/status

Freeze, unfreeze, or close.

PATCH/api/v1/cards/:id/limit

Adjust spend limit.

POST/api/v1/cards/:id/replace

Issue a replacement (lost/stolen/expired).

POST/api/v1/cards/:id/reveal/request-otp

Request the OTP needed to reveal PAN/CVV.

POST/api/v1/cards/:id/reveal

Reveal full PAN/CVV using the OTP.

GET/api/v1/cards/:id/wallet

Isolated card wallet's balance.

POST/api/v1/cards/:id/fund

Move funds into the card wallet.

POST/api/v1/cards/:id/withdraw

Move funds back out.

GET/api/v1/cards/:id/funding-history

Funding ledger for the card.

GET/api/v1/cards/:id/payments

The card's transaction history.

PATCH/api/v1/cards/:id/controls

Merchant-category and geo controls.

Issue parameters

Parameter	Type	Required	Description
currency	string	Required	Card settlement currency.
category	string	Required	Card purpose — drives default limits and wallet isolation.

Related resources

Cards — the conceptual guide this page is the flat endpoint index for.

Was this page helpful?