开发者
加密货币支付API
三个调用即可完成:创建发票、查询状态、查询余额。客户在支付页面付款,您将收到webhook通知和USDT。
接口
| 方法 | 作用 |
|---|---|
POST /api/v1/payments | 创建发票并获取支付页面链接 |
GET /api/v1/payments/{uuid} | 状态、地址和交易ID |
GET /api/v1/wallet | 可用和冻结的USDT余额 |
基础URL:https://api.crybit.net · JSON · 每分钟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 pageWebhook与小组件
发票付款完成后,CryBit会调用您商户的webhook URL,以便您放行订单。若想让客户留在您的网站上,可请求confirmation类型embedded,并使用widget脚本打开支付表单。
参考
FAQ
如何进行身份验证?
将公钥放在X-Public-Key中,私钥放在X-Private-Key中发送。两个请求头都是必需的。系统通过公钥识别商户,因此请求中无需提供店铺ID。
是否有测试模式?
有。处于测试模式的商户创建的是沙盒发票:支付页面上有一个按钮可将其标记为已支付,且不会影响您的余额。将商户切换到正式模式后即可接受真实转账。
有哪些限制?
每个密钥每分钟最多可发起60次API请求。发票金额最低为0.01,有效期为5到1440分钟。
