Issue Cards From Your Own Code
Everything the dashboard does, your platform can do programmatically — create cards, set limits, fund balances, freeze in emergencies and stream transactions via webhooks.
- RESTful endpoints
- Transaction webhooks
- Sandbox for testing
If your product needs to hand a payment card to a user, a vendor or a workflow, the Cards API turns that into a request-response cycle: create a card with its limit and controls in one call, fund it from your wallet balance in another, and receive every authorization as a webhook the moment it happens.
The API follows the same conventions as the rest of the KeyBS Pay platform API — key-based authentication, JSON everywhere, and idempotent operations for anything that moves money. Access is granted after business verification and partner-route review, with a sandbox available for building before you go live.
Full Card Lifecycle
Create, read, update limits, freeze, unfreeze and terminate cards — every dashboard action has an endpoint.
Real-Time Webhooks
Authorizations, declines, funding events and limit alerts delivered to your endpoint as they happen.
Scoped API Keys
Keys scoped per environment and capability, so a reporting integration never holds card-creation power.
Sandbox First
Build and test the full card lifecycle against the sandbox before any real funds are involved.
Controls as Parameters
Limits, merchant categories, country rules and single-use mode are request parameters — encode your policy in code.
Secure by Design
Card credentials are returned via tokenized retrieval, never logged, with PCI DSS-aligned handling throughout.
Endpoints (preview)
/v1/cards
Create a virtual card with limits, controls and metadata
/v1/cards/{id}
Retrieve card details and current status
/v1/cards/{id}/fund
Fund the card from a wallet balance
/v1/cards/{id}/freeze
Freeze the card immediately
/v1/cards/{id}/limits
Update spending limits and merchant/country rules
/v1/cards/{id}/transactions
List authorizations and settlements for the card
curl -X POST https://api.keybs.io/v1/cards \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{
"type": "virtual",
"network": "visa",
"nickname": "Meta Ads — July",
"currency": "USD",
"limits": { "monthly": 5000 },
"controls": { "merchant_categories": ["advertising"] }
}'API preview — access subject to business verification and partner-route review.
Common questions
Cards API access follows business verification and partner-route review. Request access from the developers page describing your integration — sandbox credentials are provided for building while review completes.
Explore more
Ready to create your first card?
Verify your business online, fund your wallet, and issue virtual Visa & Mastercard cards in seconds.