Skip to main content
版本: 1.0.x

支付回调

商户系统应实现用于接收 PTS 回调的 API。 PTS 将向在 支付请求 中提供的 callback_url 发送请求。

注意

请确保您在支付请求中提供的 callback_url 有效,并允许 PTS 的域名 通过您的防火墙。否则可能导致交易不同步。

回调请求

HTTP 请求方法: POST / Content-Type: application/json

Note

✅ 必填 ⭕ 可選 ❌ 不適用

参数类型必填签名描述
user_id字符串商户标识码
order_id字符串商户系统的支付订单ID。订单ID应保持唯一。
transaction_id字符串PTS 交易ID
channel字符串请参考 货币和通道
submit_currency字符串提交的货币
submit_amount浮点数提交的金额(支持最多6位小数)
accept_currency字符串实际支付的货币
accept_amount浮点数支付的金额(支持最多6位小数)
exchange_rate浮点数汇率
status字符串0000 = 等待
1000 = 处理中
2000 = 成功
3000 = 失败
4000 = 订单错误
timestamp整数交易的最后更新时间戳(10位数字)
submit_promo浮点数提交金额促销(支持最多6位小数)
accept_promo浮点数支付的货币的促销金额(支持最多6位小数)
payment_address字符串专用于加密货币,如有需要,请通知客服人员
receiving_address字符串专用于加密货币,如有需要,请通知客服人员
error_message字符串错误信息
sign字符串签名字符串

商户响应

当接收到回调时,请使用 Content-Type: text/plain 返回字符串 SUCCESS。 如果出现任何问题,请返回字符串 FAILED