開発者向け
暗号資産決済API
APIの呼び出しは3種類のみです。請求書の作成、ステータスの取得、残高の取得です。顧客は決済ページで支払い、加盟店はウェブフックとUSDTを受け取ります。
エンドポイント
| メソッド | 概要 |
|---|---|
POST /api/v1/payments | 請求書を作成し、決済ページのリンクを取得する |
GET /api/v1/payments/{uuid} | ステータス、アドレス、トランザクションID |
GET /api/v1/wallet | 利用可能なUSDT残高と凍結中のUSDT残高 |
ベースURL: https://api.crybit.net · JSON · 1分間に60リクエストまで · 認証: X-Public-KeyおよびX-Private-Keyヘッダー。
請求書を作成する
必須項目はamountとcurrencyのみです。決済と注文を照合するにはorder_idを、有効期限を設定するにはttl_minutesを指定してください。
curl -X POST https://api.crybit.net/api/v1/payments \
-H "X-Public-Key: pk_…" \
-H "X-Private-Key: sk_…" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"amount":1490,"currency":"RUB","order_id":"ORD-1048","purpose":"Order 1048"}'JavaScript
const invoice = await fetch('https://api.crybit.net/api/v1/payments', {
method: 'POST',
headers: {
'X-Public-Key': 'pk_…',
'X-Private-Key': 'sk_…',
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ amount: 1490, currency: 'RUB', order_id: 'ORD-1048' }),
}).then((r) => r.json())
location.href = invoice.callback_url // the payment pageウェブフックとウィジェット
請求書が支払い済みになると、CryBitは加盟店のウェブフックURLを呼び出すため、注文を確定できます。顧客を自社サイト内にとどめたい場合は、confirmationのtypeにembeddedを指定し、ウィジェットスクリプトで決済フォームを表示してください。
リファレンス
FAQ
認証はどのように行いますか?
公開鍵はX-Public-Keyヘッダーに、秘密鍵はX-Private-Keyヘッダーに設定して送信します。どちらのヘッダーも必須です。加盟店は公開鍵によって識別されるため、リクエストにショップIDを含める必要はありません。
テストモードはありますか?
はい。テストモードの加盟店ではサンドボックス請求書が作成され、決済ページには支払い済みにするためのボタンが表示されますが、残高には影響しません。実際の送金を受け付けるには、加盟店を本番モードに切り替えてください。
制限事項はありますか?
APIは1キーあたり1分間に60リクエストまで受け付けます。請求書の金額は0.01から指定可能で、有効期限は5分〜1440分です。
