支持 5 条网络 · USDT / USDC

一次接入,多链稳定币收款

CNIXPay 是面向商户的稳定币支付网关。用一个 API 创建订单,用户在任一网络付款,系统自动确认到账、结算入账并回调你的服务。

  • USD 报价,USDT / USDC 1:1 收款
  • 每笔订单独立收款地址
  • 签名回调,失败自动重试

一笔订单,可同时挂出多条网络与币种

  • TRONUSDT
  • BNB Smart ChainUSDT · USDC
  • EthereumUSDT · USDC
  • PolygonUSDT · USDC
  • SolanaUSDT · USDC

实际可用组合以接口返回为准

产品能力

为稳定币收款这件事,把细节做对

从地址分配到到账确认,从结算记账到回调通知,每个环节都按“钱不能错”的标准设计。

  • 多链多币,一单并行

    一笔订单可同时挂最多 10 个「网络 × 币种」收款方式,用户在任一网络付款都计入订单,自建收银台和平台收银台都适用。

  • 独立收款地址

    每笔订单从 HD 钱包派生独立地址,地址池按商户隔离、冷却后仅在同一商户内复用,到账归属清晰可审计。

  • 实时确认,双路兜底

    链上 Webhook 实时推送到账,定时扫链作为兜底。即使某条通道抖动,订单也不会漏单。

  • USD 报价,1:1 收款

    订单以 USD 报价,用户用 USDT 或 USDC 按 1:1 支付,同一地址两种币都认;也可以用 TRX、BNB 等原生币报价收款。

  • 分次付款自动累计

    用户少付或分多笔转账时,订单持续累计,每笔到账都推送 order.partially_paid;付足即完成,宽限期结束仍未付足则按实收入账并推送 order.underpaid。

  • 签名回调与自动重试

    回调带 HMAC-SHA256 签名与时间戳。四种订单事件推送失败都会自动重试约 22 小时,投递记录在商户后台可查,也可以重新推送。

支付流程

从下单到入账,四步完成

你只需要创建订单和处理回调,链上的事交给我们。

  1. 01

    创建订单

    服务端调用 POST /orders,传入金额与可选的网络 / 币种收款方式,拿到收款地址或收银台链接。

  2. 02

    用户付款

    用户在你的页面或平台收银台,向候选地址转入 USDT / USDC,任选一条网络即可。

  3. 03

    链上确认

    系统实时发现入账并核对金额。付足即为已支付,未付足则继续累计等待。

  4. 04

    结算与回调

    款项记入商户余额并生成流水,同时向你的 callbackUrl 推送签名事件。

开发者

半天就能上线的 API

五个 REST 接口覆盖全部收款场景:创建、查询、列表、追加收款方式、关闭。统一的 JSON 响应与错误码,金额全部使用字符串,另附 OpenAPI 文件。

  • Bearer 认证

    请求头 Authorization: Bearer <API Key>,支持 IP 白名单。

  • 幂等友好

    商户订单号在应用内唯一,重复下单返回已有订单;追加收款方式、关闭订单重复提交直接返回现状。

  • 明确的限流

    各接口限流阈值公开,超限返回 429 并带 Retry-After,方便你做退避。

查看完整接入指南
curl -X POST https://api.cnixpay.com/api/v2/orders \
  -H "Authorization: Bearer $CNIXPAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "merchantOrderNo": "ORDER_10086",
  "amount": "100.00",
  "paymentOptions": [
    { "chain": "tron", "token": "USDT" },
    { "chain": "bsc",  "token": "USDC" }
  ],
  "callbackUrl": "https://shop.example.com/notify"
}'
两种接入方式

自建收银台,或直接用我们的

控制力强

商户自建收银台

创建订单时传入 paymentOptions,拿到全部收款地址与应付数量,在自己的页面里渲染「网络 + 币种 + 地址 + 二维码」。

createOrder({ options: [...] }) → paymentOptions[]
  • 支付体验完全自定义
  • 中途可追加收款方式
  • 适合已有成熟结算页的产品
接入最快

平台托管收银台

创建订单时不传 paymentOptions,把用户跳转到返回的 cashierUrl。选链、地址、二维码、倒计时与支付结果都由平台页面处理。

createOrder({ }) → cashierUrl
  • 无需开发支付页面
  • 适配桌面与移动端
  • 支付完成可跳回你的 returnUrl
商户后台

钱在哪、到没到、能不能提,一眼看清

商户后台围绕“状态判断”和“下一步操作”设计,财务和开发都能各取所需。

  • 余额与提现

    订单结算实时入账,提现到你保存的地址,状态全程可追踪。

  • 交易与链上明细

    按订单号、地址、状态、时间筛选,逐笔查看链上交易哈希与回调记录。

  • 日报与对账

    日报、资金明细、收支流水一键导出 CSV,支持中英文表头。

  • 应用与密钥

    多应用管理,独立 API Key / Secret、回调地址与 IP 白名单。

安全

资金安全不是一个功能,而是每一层的默认值

  • 提现多重验证

    提现需要 TOTP 两步验证;新增提现地址需邮箱验证码 + TOTP。修改密码或邮箱后,提现自动暂停 24 小时。

  • 接口访问控制

    API Key 认证、IP 白名单、按接口限流。回调带 HMAC-SHA256 签名与时间戳,可防伪造和重放。

  • 商户间地址隔离

    收款地址按商户隔离分配,不与其他商户混用,链上资金归属始终清晰。

  • 整数记账

    金额以整数微单位计算与比较,余额变动逐笔留痕,可对账、可审计。

常见问题

接入前你可能想知道

支持哪些网络和币种?

目前支持 TRON、BNB Smart Chain、Ethereum、Polygon、Solana 上的 USDT 与 USDC(TRON 为 USDT)。具体可用组合由平台配置,以接口返回为准。

我需要自己管理钱包或私钥吗?

不需要。收款地址由平台 HD 钱包派生并监听,订单完成后款项记入你的商户余额,你可以在后台随时提现到自己的链上地址。

用户少付了,或者分几次转账怎么办?

订单保持 pending 并继续累计,每笔到账都推送 order.partially_paid;累计达到应付即变为 paid 并推送 order.paid。过期后宽限期结束仍未付足,按实收入账,订单变为 underpaid 并推送 order.underpaid,由你人工处理。

如何可靠地判断一笔订单已支付?

以回调事件里订单的 status == "paid" 为准,务必校验签名、按 X-Webhook-Id 去重、按 version 取最新。发货前可调用查询订单接口再确认一次。

支持哪些报价币种?

订单以 USD 报价,用户用 USDT 或 USDC 按 1:1 支付;也可以用 TRX、BNB、ETH、POL、SOL 原生币报价,此时只收该币。暂不支持人民币等法币报价。

有测试环境吗?

平台不提供模拟沙箱,建议用小额订单在真实网络上完成联调。

费率和提现手续费是多少?

费用与最小提现金额以商户后台展示为准,提现前会明确显示本次手续费与到账金额。

如何获取 API Key?

注册商户账号后,在后台创建应用并提交上线,应用详情里会显示 API Key 与 API Secret。API Key 放在请求头 Authorization: Bearer 里;API Secret 只用于验证回调签名,不要放进请求或前端代码。

订单多久过期?过期后用户才付款怎么办?

默认 30 分钟,创建订单时可用 expireMinutes 指定(5–1440 分钟),并以 expireTime 返回。过期后还有一段宽限期,期间到账或补足仍会计入订单;宽限期之后才到的钱由平台人工处理。

用户多付了怎么办?

累计到账达到应付金额,订单即为 paid;实际到账以 paidAmount 返回,多付部分同样计入你的商户余额。

可以主动关闭订单吗?

可以。还没收到付款的 pending 订单可以调用关闭订单接口,关闭后不再自动入账。已收到付款或有链上确认中到账的订单不能关闭。

回调地址可以按订单指定吗?

可以。创建订单时传 callbackUrl 即按订单指定,不传则使用应用的默认回调地址,都必须是 https。你的接口返回任意 HTTP 2xx 即算送达。

订单有哪些状态?

只有 4 个:pending 还没有结果,等待即可;paid 已付足,可以发货;underpaid 宽限期结束只收到部分款,需要人工处理;closed 没收到钱,订单已关闭。

一个账号可以接多个店铺或产品吗?

可以。一个商户账号下可以创建多个应用,每个应用有独立的 API Key / Secret、回调地址与 IP 白名单,订单和统计也按应用区分。

支持退款吗?

商户支付 API 目前不包含退款接口。如需退款,请由你的系统从自有钱包向用户地址转账处理。

准备好接收第一笔稳定币付款了吗?

注册商户、创建应用、拿到 API Key,今天就能跑通第一笔订单。