接入概览
把地址分配、充值确认与回调通知,接入你的业务系统。
U 收款为每个商户用户分配专属充值地址。用户转入资产后,平台识别链上交易,完成确认、记账与回调,再将资产归集到商户主钱包。
完成第一次接入从准备凭据到获取用户地址,按步骤跑通收款流程。签名你的请求了解 API Key、时间戳、Nonce 与 HMAC-SHA256。分配充值地址使用业务用户编号,创建或查询专属充值地址。接收充值回调验证通知签名,幂等更新你的业务账本。
一条完整的收款路径
- 平台激活商户后,商户在控制台配置主钱包、生成 API 凭据与回调密钥。
- 业务服务端调用用户接口,获得专属充值地址。
- 用户通过正确网络向该地址充值,无需先创建订单。
- 达到平台配置的确认数后,平台记账并发送充值回调。
- 归集任务把资金转入商户主钱包;归集进度与充值确认是两个不同状态。
接口约定
| 项目 | 约定 |
|---|---|
| 服务地址 | https://u.agpt.pro |
| 接口前缀 | /v1 |
| 请求与响应 | JSON,使用 UTF-8 |
| 金额 | 十进制字符串,例如 "12.50",不要使用浮点数计算账款 |
| 成功结果 | HTTP 200,业务数据位于 data |
| 失败结果 | 非 2xx 状态,错误信息位于 error |
| 调用位置 | 你的业务服务端,密钥不能放在浏览器或 App 内 |