回调通知接口(由商户自定义)

POST

notifyUrl

签名规则: 将请求参数JSON化(参数有序)之后,获取到的签名放在header中,直接从响应头中获取到签名,验签方式使用工具类中的verifyEcdsaSignature()即可.

该接口由商户自己实现,收到我方回调之后,无关乎业务状态,一但收到我方通知,请返回字符串OK即可,无须返回JSON格式数据,且由商户保证业务的幂等性,多次通知仅处理一次

Request

Header Params

Body Params application/json

Example

{
    "bizType": 2,
    "currency": "PKR",
    "failReason": "payment failed",
    "fee": "2",
    "mchNo": "M1688443982",
    "mchOrderNo": "YN7220230300929",
    "orderAmount": "100",
    "payAmount": "100",
    "payOrderId": "P1681112064487976961",
    "state": 3
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://payment.tarspay.comnotifyUrl' \
--header 'X-RESP-SIGNATURE: 3046022100ae8634a9db66c069030483012e7d0e38ebca6d924b82d8bb2e240764dafeb4f3022100ba3e3bd90346652e681b4b1b25e55d983002d84160fb9c696fb20ea3e4742e76' \
--header 'Content-Type: application/json' \
--data '{
    "bizType": 2,
    "currency": "PKR",
    "failReason": "payment failed",
    "fee": "2",
    "mchNo": "M1688443982",
    "mchOrderNo": "YN7220230300929",
    "orderAmount": "100",
    "payAmount": "100",
    "payOrderId": "P1681112064487976961",
    "state": 3
}'

Responses

🟢200成功

application/json

Bodyapplication/json

Example

OK

Modified at 2025-07-15 07:30:10

获取余额信息

接入指引