OnyxClearing API

프로그래밍 가능한 스테이블코인 자금 공급 카드 발행

API 화면: 카드 발행, 충전 관리, 웹훅 수신, REST API를 통한 원장 이벤트 조정. JavaScript, Python, Go용 SDK, 풀 샌드박스.

OnyxClearing 공개 API와 SDK는 운영 중. 샌드박스와 프로덕션 키는 KYC/KYB 후 발급. 액세스에 등록하면 1영업일 이내에 전문가에게 안내합니다.

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

이벤트 구독

모든 상태 변경에 서명된 웹훅과 리플레이 보호 (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 후 발급. 등록 후 1영업일 이내에 전문가가 응답.

API 액세스 받기 →