工作原理
第 1 步
用所选币种创建账单
客户在您的页面上选择币种。您的服务器带上该币种发送一个签名请求,并获得准确金额、地址和过期时间。
- 2
第 2 步
在您的页面上显示
您的页面以您的设计显示金额、地址、二维码和倒计时。客户可从任意钱包或交易所付款。
第 3 步
付款后收到通知
ArionPay 看到付款并统计确认数。您的服务器收到签名的 invoice.paid Webhook,并放行订单。
一个请求
页面所需的一切,都在响应中
将 "asset" 设为客户选择的币种,账单即刻获得收款地址。请原样显示 amount_crypto:ArionPay 通过其末尾数字判断付款属于哪张账单。
该地址是您自己钱包的主地址,资金从不经过 ArionPay。请求使用您店铺的 API 密钥签名,与 API 的其他部分完全相同。
{
"amount": "49.00",
"currency": "USD",
"orderId": "ORD-1042",
"asset": "USDT_TRC20"
}{
"status": "success",
"data": {
"id": "6732b1e4f0a9c35d2e18a7c4",
"status": "new",
"asset": "USDT_TRC20",
"address": "TQ4x…your wallet…k9Rm",
"amount_crypto": "49.004173",
"amount_fiat": "49.00",
"currency": "USD",
"expires_at": "2026-11-12T21:30:00.000Z",
"invoice_url": "https://merchant.arionpay.com/pay/…"
}
}您的页面,我们的引擎
您的页面显示什么
- 您的设计、您的语言和您的域名
- 在创建账单之前由您自己提供币种选择
- 准确金额、地址、二维码和倒计时
- 客户等待期间的付款状态
ArionPay 做什么
- 监控每个网络上的区块链
- 按准确金额将每笔付款与其账单匹配
- 统计确认数,并用 Payment Radar 处理金额错误的付款
- 签名 Webhook,以及控制台中的每一笔付款
正确地构建
您的页面必须做到的六件事
- 1只从您的服务器调用 API:绝不要泄露 API 密钥。
- 2显示金额的每一位数字、复制按钮和网络。
- 3倒计时至 expires_at,并提供指向 invoice_url 的帮助链接。
- 4只在收到签名的 invoice.paid Webhook 后才放行订单。
- 5查询未付账单的频率最多每 10 秒一次。
- 6先在测试模式下试用:测试账单永远不会收到真实资金。
关于白标 API 的问题
付款如何保留在您自己的网站上、费用是多少,以及即将推出的功能。
不会。您自己的页面会显示准确金额、地址和二维码,客户从他们的钱包付款。如果愿意,您可以为需要帮助的客户添加一个指向 ArionPay 支付页面的链接。
不会。地址是您自己钱包的地址,因此付款直接到您手中。ArionPay 监控区块链,将付款与其账单匹配,并在付款完成时通知您的服务器。
您的店铺接受的所有币种。币种代码列在 GET /api/v1/currencies 中,例如 USDT_TRC20、USDC_POLYGON 或 BTC。一张账单只对应一种币,因此请先让客户选择,然后用该币种创建账单。
网络确认付款后,您的服务器会收到签名的 invoice.paid Webhook。在客户等待期间,您的服务器也可以通过 GET /api/v1/invoices/:id 查询状态和确认数。
规则与 ArionPay 支付页面相同:金额准确的付款,以及在只有一张账单匹配时容差范围内的小额偏差,都会自动确认。其他金额由 Payment Radar 找出并显示在您的控制台中,由您决定。
不会。与 ArionPay 支付页面一样,每笔付款 0.5%,无月费。
暂时还不行:这已列入我们的路线图。目前 ArionPay 支付页面可以显示您店铺的徽标和品牌颜色,而白标 API 让您可以自己构建整个支付页面。