核心业务流程说明

代收流程

1.

商户调用 POST /api/pay/unifiedOrder 创建代收订单。

2.

TarsPay 返回 payUrl 和 payData，商户应原样引导付款人访问。

3.

付款人完成支付后，TarsPay 向下单请求中的 notifyUrl 发送订单状态回调。

4.

商户验签、核对订单并完成幂等处理后返回纯文本 OK。

5.

未收到回调或需要补偿核对时，调用 POST /api/payInInfo 查询订单。

代收规则

币种固定为 ARS。

amount 必须是 100 的整数倍。

wayCode 的可选值见附件码表。

returnUrl 只用于前端跳转，不能代替异步通知。

代付流程

1.

商户调用 POST /api/payOut/unifiedOrder 创建代付订单。

2.

wayCode 支持 CVU 或 CBU，取值说明见附件码表。

3.

code = 0 仅表示订单已受理或进入队列。

4.

商户通过订单状态回调或 POST /api/payOutInfo 获取最终结果。

代付规则

币种固定为 ARS。

amount 仅支持正整数，不支持小数点。

customerAccountNumber 必须是 22 位 CVU 或 CBU。

最终状态以回调或查单返回的 state 为准。

回调处理

1.

读取原始 JSON 请求体和 Header X-RESP-SIGNATURE。

2.

使用商户对应的签名方案验证回调签名。

3.

核对 mchNo、订单号、币种和金额。

4.

按订单号和订单状态执行幂等处理。

5.

仅在 state = 2 时执行完整成功业务逻辑；其他状态按附件码表处理。

6.

处理完成后返回纯文本 OK。

同一订单可能收到重复通知。不得因为回调重试而重复发货、重复入账或重复退款。

Modified at 2026-08-08 07:52:32

创建代收订单