OnyxClearing API

可编程的稳定币充值卡片发行

API 接口:通过 REST API 发行卡片、管理充值、监听 webhook 和对账账本事件。提供 JavaScript、Python 和 Go SDK,以及完整沙盒。

公开的 OnyxClearing API 和 SDK 已上线。沙盒和生产密钥在 KYC/KYB 后发放。注册获取访问权限,我们会在一个工作日内为您路由到专家。

获取 OnyxClearing API 访问权限 →
快速开始

30 秒内发行卡片

bash 快速开始
# 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 参考

核心端点

REST API 内置幂等键、作用域 API 密钥和账本对账。

POST /v1/cards

Issue a card

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

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

事件订阅

每次状态变更都有签名 webhook 和重放保护 (timingSafeEqual)。

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.

获取沙盒访问权限

沙盒和生产密钥在 KYC/KYB 后发放。注册后一个工作日内专家回复。

获取 OnyxClearing API 访问权限 →