開発者向け

暗号資産決済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分です。

関連情報