订阅回调

商户系统应实现用于接收 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	浮点数	✅	✅	汇率
enabled	布林	✅	✅	订阅状态。true = 已启用，false = 已禁用。
subscribe_at	整数	✅	✅	订阅时间戳（10位数字）
timestamp	整数	✅	✅	交易的最后更新时间戳（10位数字）
payments	数组<Payment>	⭕	❌	付款清单
sign	字符串	✅	❌	签名字符串。请参阅 数据签名与验证

Payment 物件

参数	类型	描述
payment_id	String	订阅付款 PTS 交易ID
status	String	0000 = 等待 1000 = 处理中 2000 = 成功 3000 = 失败 4000 = 订单错误
timestamp	Integer	交易的最后更新时间戳（10位数字）

商户响应

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