汇卡SUP开放接口
  1. 订单接口
汇卡SUP开放接口
  • 产品介绍
  • 加密算法
  • 接口列表
    • 运维接口
      • 健康检查
    • 分类接口
      • 查询分类列表
    • 产品接口
      • 查询产品列表
      • 查询产品详情
    • 订单接口
      • 订单新增
        POST
      • 订单查询
        POST
      • 回调通知
        POST
  1. 订单接口

回调通知

POST
最后修改时间:2025-03-30 10:04:45
特别提醒:商户系统对于开启结果通知的内容一定要做签名验证,并校验通知的信息是否与商户侧的信息一致,防止数据泄露导致出现“假通知”,造成资金损失。
只推送这些状态(3-已完成,4-已取消,5-已退款,11-处理失败)
如果平台收到商户的应答不符合规范或超时,则认为通知失败,平台会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。
(通知频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m)
平台判断成功规则
1.
json结构,code==200
2.
ok
3.
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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
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
}
上一页
订单查询
Built with