订单状态回调

POST

/merchant/orderNotify

本路径仅用于展示回调报文结构。实际请求地址为商户下单时传入的 notifyUrl，
由 TarsPay 主动发起 POST application/json 请求。

TarsPay 仅对终态订单发送通知。商户验签并完成幂等处理后，必须返回纯文本 OK（不区分大小写）。

Request

Header Params

Body Params application/jsonRequired

Example

{
    "bizType": 1,
    "payOrderId": "P202608080000000001",
    "mchNo": "M1234567890",
    "mchOrderNo": "AR_IN_202608080001",
    "orderAmount": "1000",
    "payAmount": "1030",
    "currency": "ARS",
    "state": 2,
    "fee": "30"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://payment.tarspay.com/merchant/orderNotify' \
--header 'X-RESP-SIGNATURE;' \
--header 'Content-Type: application/json' \
--data '{
    "bizType": 1,
    "payOrderId": "P202608080000000001",
    "mchNo": "M1234567890",
    "mchOrderNo": "AR_IN_202608080001",
    "orderAmount": "1000",
    "payAmount": "1030",
    "currency": "ARS",
    "state": 2,
    "fee": "30"
}'

Responses

🟢200

text/plain

返回 OK 表示通知处理成功。

Bodytext/plain

Example

"OK"

Modified at 2026-08-08 06:10:47

获取商户余额