回调通知

POST

特别提醒：商户系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息是否与商户侧的信息一致，防止数据泄露导致出现“假通知”，造成资金损失。

只推送这些状态（3-已完成，4-已取消，5-已退款，11-处理失败）

如果平台收到商户的应答不符合规范或超时，则认为通知失败，平台会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但不保证通知最终能成功。
（通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m）

平台判断成功规则

json结构，code==200

success

请求参数

Body 参数application/json

appId

string

appId

必需

nonce

string

随机串

必需

timestamp

string

时间戳

必需

sign

string

签名

必需

tradeNo

string

平台单号

必需

outOrderNo

string

商户侧订单号

必需

salesPrice

string

售价（单位：分）

必需

status

string

必需

状态（-1-下单失败，1-待处理，2-处理中，3-已完成，4-已取消，5-已退款，6-异常，7-待同步，8-取消中，9-退款中，11-处理失败）

completeTime

string

时间戳（毫秒）

可选

cardList

array [object {3}]

卡信息

可选

cardNo

string

卡号

可选

cardPwd

string

卡密

可选

expireTime

string

有效期

可选

示例

{
  "cardList": [
    {
      "cardNo": "925341",
      "cardPwd": "9AhgdPdw",
      "expireTime": "2025-03-30 23:59:59"
    }
  ],
  "tradeNo": "2025030419376567239848280065",
  "salesPrice": "20",
  "sign": "d98ae23bb9809c841346e53352ec249b",
  "completeTime": "1743265309549",
  "nonce": "3298961688",
  "outOrderNo": "2025030419376567234546679809",
  "appId": "xxxxxxxxxx",
  "timestamp": "1741088249923",
  "status": "3"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cardList": [
        {
            "cardNo": "925341",
            "cardPwd": "9AhgdPdw",
            "expireTime": "2025-03-30 23:59:59"
        }
    ],
    "tradeNo": "2025030419376567239848280065",
    "salesPrice": "20",
    "sign": "d98ae23bb9809c841346e53352ec249b",
    "completeTime": "1743265309549",
    "nonce": "3298961688",
    "outOrderNo": "2025030419376567234546679809",
    "appId": "xxxxxxxxxx",
    "timestamp": "1741088249923",
    "status": "3"
}'

返回响应

🟢200成功

application/json

Body

code

integer

状态码

必需

msg

null

信息

必需

data

null

数据

必需

示例

{
  "code": 200,
  "msg": null,
  "data": null
}

修改于 2025-03-30 10:04:45

订单查询