OnyxClearing API

Programmable stablecoin-funded card issuing

API surface: issue cards, manage top-ups, listen to webhooks, and reconcile ledger events via REST API. SDKs for JavaScript, Python, and Go, plus a full sandbox.

The public OnyxClearing API and SDKs are live. Sandbox and production keys are issued after KYC/KYB. Sign up for access and we will route you to a specialist within one business day.

Get API access →
Quickstart

Issue a card in 30 seconds

bash Quickstart
# Install the SDK
npm install @thiskard/sdk

# Authenticate
export THISKARD_API_KEY="sk_live_..."

# Issue your first card
thiskard cards:create --product vault-spend --type virtual --label "Meta campaign"
API reference

Core endpoints

REST API with idempotency keys, scoped API keys, and ledger reconciliation built in.

POST /v1/cards

Issue a card

Create a virtual or physical card funded from a stablecoin balance. Idempotent via Idempotency-Key header.

bash Example
curl -X POST https://api.thiskard.com/v1/cards \
-H "Authorization: Bearer $API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"product":"ads","type":"virtual","label":"Meta campaign A"}'
POST /v1/topups

Top up a card

Fund a card from digital currency. Quote locks for 30s; settlement confirms on-chain.

bash Example
curl -X POST https://api.thiskard.com/v1/topups \
-H "Authorization: Bearer $API_KEY" \
-d '{"card_id":"card_abc","amount":500,"currency":"USDT"}'
GET /v1/cards/:id

Retrieve a card

Get card status, balance, limits, and recent transactions. PAN/CVV are never returned — use the reveal widget.

bash Example
curl https://api.thiskard.com/v1/cards/card_abc \
-H "Authorization: Bearer $API_KEY"
Webhooks

Event subscriptions

Signed webhooks with replay protection (timingSafeEqual) for every state change.

card.issued Fired when a card is created and ready for funding.
topup.settled Fired when on-chain settlement confirms and the balance credits.
authorization.result Fired on every card authorization attempt (approved/declined) with BIN + decline-reason.
kyc.completed Fired when Sumsub returns a KYC/KYB decision.

Get sandbox access

Sandbox and production keys issued after KYC/KYB. Sign up and a specialist responds within one business day.

Get API access →