跳到正文

白标 API

在您自己的网站上实现白标加密货币支付

在您自己的结账页面上,以您自己的设计显示金额、地址和二维码。客户无需离开您的网站,资金直接进入您自己的钱包。一个 API 请求即可提供页面所需的一切。

示例

工作原理

  1. 第 1 步

    用所选币种创建账单

    客户在您的页面上选择币种。您的服务器带上该币种发送一个签名请求,并获得准确金额、地址和过期时间。

  2. 2

    第 2 步

    在您的页面上显示

    您的页面以您的设计显示金额、地址、二维码和倒计时。客户可从任意钱包或交易所付款。

  3. 第 3 步

    付款后收到通知

    ArionPay 看到付款并统计确认数。您的服务器收到签名的 invoice.paid Webhook,并放行订单。

一个请求

页面所需的一切,都在响应中

将 "asset" 设为客户选择的币种,账单即刻获得收款地址。请原样显示 amount_crypto:ArionPay 通过其末尾数字判断付款属于哪张账单。

该地址是您自己钱包的主地址,资金从不经过 ArionPay。请求使用您店铺的 API 密钥签名,与 API 的其他部分完全相同。

POST /api/v1/invoices
{
  "amount": "49.00",
  "currency": "USD",
  "orderId": "ORD-1042",
  "asset": "USDT_TRC20"
}
201 Created
{
  "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. 1只从您的服务器调用 API:绝不要泄露 API 密钥。
  2. 2显示金额的每一位数字、复制按钮和网络。
  3. 3倒计时至 expires_at,并提供指向 invoice_url 的帮助链接。
  4. 4只在收到签名的 invoice.paid Webhook 后才放行订单。
  5. 5查询未付账单的频率最多每 10 秒一次。
  6. 6先在测试模式下试用:测试账单永远不会收到真实资金。
附代码的完整指南

更喜欢现成的支付页面?

也可以把客户引导到 ArionPay 支付页面。它显示您店铺的徽标和品牌颜色、准确金额、钱包应用按钮,并支持 9 种语言。

试用测试结账

即将推出

在您自己域名上的 ArionPay 支付页面

在您自己的域名上运行、不带 ArionPay 品牌标识的现成支付页面已列入我们的路线图。在此之前,上述白标 API 可以为您提供一个完全属于您的支付页面。

查看路线图

关于白标 API 的问题

付款如何保留在您自己的网站上、费用是多少,以及即将推出的功能。

不会。您自己的页面会显示准确金额、地址和二维码,客户从他们的钱包付款。如果愿意,您可以为需要帮助的客户添加一个指向 ArionPay 支付页面的链接。