准备工作
在将 AinePay 集成到您的后端之前,请成以下设置步骤。
1. 注册 AinePay 账户
您只需要一个电子邮箱即可注册。注册后,登录商户仪表盘并前往商户资料完成其余设置。
2. 商户状态和手续费
注册成功后商户账户不会自动激活,需要充值手续费余额到 10 USD 以上才能激活商户状态并解锁完整的支付功能。在后台管理概览页可以看到您的手续费充值地址和手续费余额,手续费将在您的客户存款到账后从手续费余额中扣除。
当商户余额变低时,AinePay 会在服务受影响之前发送电子邮件提醒。如果余额后来降至 0 USD 及以下,商户状态将变为非活跃,支付功能受限,这时您需要充值手续费再次激活。
当前默认费用表:
| 客户存款数量 | 费用 |
|---|---|
数量 < 1 USD | 数量 * 30% |
1 USD <= 数量 < 30 USD | 0.3 USD |
数量 >= 30 USD | 数量 * 1%,上限 100 USD |
对于同一条链上同一客户充值地址的首次成功存款,手续费固定为 0.5 USD,不按上述规则计算。后续存款再按上述规则收费。
如果您有自定义费用需求,请通过 support@ainepay.com 联系我们。
3. 设置资金归集地址
资金归集地址是商户指定的最终接收支付资金的地址,您的客户支付地址都是根据此归集地址按照智能合约确定性派生,因此务必保证这个地址的安全。
商户可以配置多个归集地址。创建订单时,您可以指定使用哪个归集地址。如果您未指定,AinePay 默认使用您最新的归集地址。
商户创建订单时应始终从 AinePay 获取实际的支付地址,否则平台无法正确管理该地址的订单及其支付生命周期。如果需要,您可以在获取之后根据地址的确定性生成规则进行验证。
资金归集地址和客户支付地址的确定性关系及合约绑定是 AinePay 不托管商户地址的关键设计,您可以在非托管章节中查看基于归集地址构建支付和归集流程的密码学解释。
4. 支付链接
支付链接不需要任何代码开发。商户在 AinePay 仪表盘成功创建订单后,AinePay 会将支付链接发送到您指定的电子邮箱。或者,您可以从仪表盘复制支付链接或地址信息并发送给您的客户。客户点击链接或通过其他方式完成支付即可完成交易。
如果您只需要此功能,请直接使用支付链接 —— 无需使用 API。其余章节仅供参考。
5. 创建商户 API 密钥
AinePay 提供两种商户密钥:
| 类型 | 用途 |
|---|---|
请求签名密钥 | 用于签署发送到 AinePay 的 API 请求。 |
Webhook 验证密钥 | 用于验证 AinePay 的 Webhook 消息。 |
密钥密文仅在首次创建时显示一次,之后将永久隐藏。如果您忘记了密文,请删除该密钥并创建一个新的。有关完整的签名和验证流程,请参阅 身份验证。
请安全存储这些密钥。
6. 设置通知 URL
AinePay 在添加通知 URL 时会进行验证,所以先准备 URL 测试的服务接口,然后返回商户仪表盘添加通知 URL。有关详细的回调模型和通知字段,请参阅 Webhooks 章节。