如何通过 API 对接我的网站或机器人?

ScarabPay 团队 · 更新于 23 十月 2026

如果你希望订单自动完成支付和交付,请使用 API。你的服务器创建账单,将客户引导至支付页面,并在付款到账时接收签名 Webhook。

1. 获取密钥

打开你的项目,进入开发者标签页。你将获得一个用于真实付款的正式(live)密钥和一个用于测试的沙盒(sandbox)密钥。

开发者标签页中的 API 密钥和 Webhook 设置
开发者标签页中的 API 密钥和 Webhook 设置
请妥善保管密钥密钥仅显示一次。请只将其存储在你的服务器上,切勿放在移动 App 或公开页面中。如果密钥泄露,请点击更换密钥。

2. 添加 Webhook

  1. 输入你的网站或机器人服务器上用于接收事件的网址,然后点击保存。
  2. 复制签名密钥并保存在你的服务器上。
  3. 点击发送测试事件,检查你的服务器是否返回状态码 200。

3. 创建账单

发送创建账单的请求,附上金额和你的订单号,然后将客户重定向到返回的支付链接。收到 invoice.paid 事件后,即可交付订单。

固定地址

对于机器人中的余额充值,你可以为每位客户分配一个永久充值地址。每笔充值都会发送一个 deposit.received 事件。

为你的客户创建的永久地址
为你的客户创建的永久地址

PHP、Node.js 和 Python 的完整请求示例请参阅 API 文档。


相关文章

这篇文章解答了你的问题吗?

仍需帮助? 联系我们