开发者

加密货币支付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 page

Webhook与小组件

发票付款完成后,CryBit会调用您商户的webhook URL,以便您放行订单。若想让客户留在您的网站上,可请求confirmation类型embedded,并使用widget脚本打开支付表单。

参考

FAQ

如何进行身份验证?

将公钥放在X-Public-Key中,私钥放在X-Private-Key中发送。两个请求头都是必需的。系统通过公钥识别商户,因此请求中无需提供店铺ID。

是否有测试模式?

有。处于测试模式的商户创建的是沙盒发票:支付页面上有一个按钮可将其标记为已支付,且不会影响您的余额。将商户切换到正式模式后即可接受真实转账。

有哪些限制?

每个密钥每分钟最多可发起60次API请求。发票金额最低为0.01,有效期为5到1440分钟。

相关内容