開発者向け
請求書を作成する
1回のPOSTリクエストで請求書が作成され、決済ページへのリンクが返されます。顧客はそのページでコインとネットワークを選択します。
リクエスト
curl
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"}'| フィールド | 説明 |
|---|---|
amount | 必須。0.01以上の数値を指定します。加盟店が手数料を負担する場合、ネットワーク手数料が請求書の金額を上回ることはできないため、USDT建ての最低金額が存在します。現在の最低金額はGET /api/payments/quoteで確認できます。 |
currency | 必須。法定通貨(RUB、USD、EUR、CNY、GBP、CHF、JPY、KZTなどの主要通貨)またはUSDT/USDCを指定します。金額はリアルタイムのレートで換算されます。 |
order_id | 任意の注文ID(最大80文字)。空の場合、CryBitがCB-…を自動生成します。 |
purpose | 説明文(最大240文字)。 |
ttl_minutes | 有効期限は5分〜1440分(デフォルトは30分)。 |
return_url | 決済後に顧客が戻る遷移先(httpまたはhttps、最大500文字)。指定がない場合は加盟店のreturn URLが使用されます。 |
crypto, network | 任意。両方を指定すると、アドレス、金額、QRコードを一度のレスポンスで取得できます(例: USDTとTRC-20)。 |
confirmation | 任意。埋め込みウィジェットを利用する場合は{"type":"embedded"}を指定します。トークンは常にレスポンスに含まれます。 |
レスポンス
レスポンスはステータス201で、請求書オブジェクトが返されます。顧客はcallback_url(決済ページ)へ誘導してください。cryptoとnetworkを指定していない場合はneeds_methodがtrueとなり、顧客はそのページで選択します。
JSON
{
"uuid": "28d0ff38-949c-435e-ad41-c81c219b3597",
"order_id": "ORD-1048",
"amount": 1490,
"currency": "RUB",
"status": "waiting",
"sandbox": true,
"needs_method": true,
"callback_url": "https://pay.crybit.net/28d0ff38-949c-435e-ad41-c81c219b3597",
"confirmation": { "type": "embedded", "confirmation_token": "28d0ff38-…", "widget_url": "https://pay.crybit.net/widget.js" },
"expires_at": "2026-09-21T13:41:42+00:00"
}ステータス
GET /api/v1/payments/{uuid}でも同じオブジェクトが返されます。ステータスはwaiting、paid、expired、cancelledのいずれかです。顧客がネットワークを選択すると、オブジェクトにはcrypto、network、address、feeが含まれます。支払い後はstatusがpaidになり、txidとpaid_atが含まれます。有効期限を過ぎたwaitingの請求書は、問い合わせた時点でexpiredになります。fee_payerは、加盟店が手数料を負担する場合はshop、支払い金額にすでに手数料が含まれている場合はbuyerになります。
FAQ
どのヘッダーを送信すればよいですか?
X-Public-KeyとX-Private-Keyの両方が必須です。秘密鍵が未指定、誤り、または古い場合は401が返されます。
レート制限はありますか?
1キーあたり1分間に60リクエストです。