使用 CrptoX API 创建第一张测试账单

从配置 TEST 钱包和密钥开始,通过 CrptoX API 查询支付方式、创建账单并验证付款状态。

1. 创建商户账户

验证邮箱,在测试模式下添加并启用 TRON Shasta 钱包,然后创建 TEST API 密钥。环境由密钥决定,无需单独的测试 API 域名。

2. 查询可用支付方式

Bash / cURL BASH
read -r -s -p 'TEST API key: ' CRPTOX_TEST_KEY
printf '\n'

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  'https://crptox.com/api/v1/payment-methods'

支付方式为空或返回 merchant_wallet_unavailable:请在账单所属的环境和网络中添加有效钱包。LIVE 钱包不能供 TEST 密钥使用。

3. 创建账单

POST /api/v1/invoices BASH
curl --fail-with-body --silent --show-error \
  -X POST 'https://crptox.com/api/v1/invoices' \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  --data '{"amount":"1","network":"tron","asset":"USDT","expires_in":1800}'
创建账单

4. 支付账单并检查状态

使用响应中的 data.invoice.uuid 打开支付页面并查询账单。在 Shasta 上用测试代币发送准确的 data.payment.amount,然后等待链上确认。测试代币没有实际货币价值。

GET /api/v1/invoices/{uuid} BASH
read -r -p 'data.invoice.uuid: ' CRPTOX_INVOICE_UUID
printf '%s\n' "https://crptox.com/pay/$CRPTOX_INVOICE_UUID"

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $CRPTOX_TEST_KEY" \
  -H 'Accept: application/json' \
  "https://crptox.com/api/v1/invoices/$CRPTOX_INVOICE_UUID"

仅当 data.invoice.status 为 paid 时才交付订单。已检测到付款或正在确认的状态,都不代表最终确认。

请将 API 密钥保存在服务器端。交付前验证 Webhook 签名,并使用同一环境的密钥查询账单。浏览器跳转或付款截图不能证明支付成功。

如果首次请求失败

  • 401:检查 Bearer 密钥是否已启用且未过期。不要在公开支持消息中粘贴密钥。
  • 支付方式为空或返回 merchant_wallet_unavailable:请在账单所属的环境和网络中添加有效钱包。LIVE 钱包不能供 TEST 密钥使用。
  • 422:查看 error.details 及支持的网络与代币组合。额度错误请检查 TEST 与 LIVE 共用的订阅限额。遇到 429 时降低请求频率,并按提示等待后重试。
错误