OnyxClearing API

Phát hành thẻ tài trợ stablecoin theo chương trình

Mặt API: phát hành thẻ, quản lý nạp tiền, theo dõi webhook và đối soát sự kiện sổ cái qua REST API. SDK cho JavaScript, Python và Go, kèm sandbox đầy đủ.

API công khai OnyxClearing và SDK đang hoạt động. Khóa sandbox và production được cấp sau KYC/KYB. Đăng ký để truy cập và chúng tôi sẽ kết nối bạn với chuyên gia trong một ngày làm việc.

Lấy quyền truy cập API →
Quickstart

Phát hành thẻ trong 30 giây

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"
Tham khảo API

Endpoints chính

REST API với khóa idempotency, khóa API theo phạm vi và đối soát sổ cái tích hợp.

POST /v1/cards

Issue a card

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

bash Ví dụ
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 Ví dụ
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 Ví dụ
curl https://api.thiskard.com/v1/cards/card_abc \
-H "Authorization: Bearer $API_KEY"
Webhooks

Đăng ký sự kiện

Webhook được ký với bảo vệ replay (timingSafeEqual) cho mỗi thay đổi trạng thái.

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.

Lấy quyền truy cập sandbox

Khóa sandbox và production được cấp sau KYC/KYB. Đăng ký và chuyên gia phản hồi trong một ngày làm việc.

Lấy quyền truy cập API →