接入指引

本文档适用于 TarsPay 阿根廷（AR / ARS）代收、代付、查单及余额查询接口。

接口地址

环境	Base URL
生产环境	`https://payment.tarspay.pro`

所有主动请求均使用 POST，请求和响应格式为 application/json。

接口列表

业务	路径
创建代收订单	`/api/pay/unifiedOrder`
查询代收订单	`/api/payInInfo`
创建代付订单	`/api/payOut/unifiedOrder`
查询代付订单	`/api/payOutInfo`
查询商户余额	`/api/balanceInfo`

订单状态回调由 TarsPay 请求商户下单时传入的 notifyUrl，不是固定的 TarsPay 接口路径。

请求鉴权

每个主动请求必须携带以下 Header：

Header	必填	说明
`X-API-KEY`	是	TarsPay 分配的 API Key
`X-API-NONCE`	是	13 位毫秒时间戳，请求有效期 5 分钟
`X-API-SIGNATURE`	是	请求签名

签名原文

HTTP_METHOD|REQUEST_PATH|NONCE|CANONICAL_PARAMS

CANONICAL_PARAMS 生成规则：

读取 JSON 请求体中的非空字段，空字符串和 null 不参与签名。

按字段名升序排列。

按 key=value 拼接，并使用 & 连接。

使用商户接入配置指定的签名算法生成 X-API-SIGNATURE。

代收下单签名原文示例：

POST|/api/pay/unifiedOrder|1754640000000|accountTax=12345678&amount=1000&currency=ARS&idType=DNI&mchNo=M1234567890&mchOrderNo=AR_IN_202608080001&notifyUrl=https://merchant.example.com/tarspay/notify&wayCode=QR

通用响应

{
  "code": 0,
  "msg": "SUCCESS",
  "data": {},
  "sign": ""
}

code = 0 表示请求成功，其他值表示失败。代付下单成功只表示订单已受理，不能作为最终出款成功依据。

异步通知

TarsPay 会向下单时传入的 notifyUrl 发送 JSON，并在 Header X-RESP-SIGNATURE 中携带回调签名。
商户必须先验签，再按 payOrderId 或 mchOrderNo 做幂等处理。处理完成后返回纯文本 OK（不区分大小写）。

wayCode 取值、证件类型和订单状态见“附件码表”。

接口地址#

接口列表#

请求鉴权#

签名原文#