4.2.3 退款通知

联调环境

POST

商户通知地址

注意事项

异步如果未返回正确响应会进行重发，目前只会重复通知5次，如果后续增加次数将按照以下通知间隔时间进行通知
1s 5s 10s 30s 1m 2m 3m 4m 5m 6m 7m 8m 9m 10m 20m 30m 1h 2h

📌

收到异步通知后请返回文字字符串"success"

请求参数

Body 参数application/json

code

integer

请求状态

必需

返回200=成功，其他状态均为失败

data

object

返回数据体

必需

mchOrderNo

string

商户订单号

必需

payOrderNo

string

平台订单号

必需

mchRefundOrderNo

string

商户退款订单号

可选

号

instOrderNo

string

平台退款订单号

可选

refundAmount

string

退款金额

可选

单位元

payInfo

string

订单金额

可选

单位元

reason

string

退款原因

可选

amount

string

订单金额

必需

单位元

status

string

退款状态

必需

1 初始化 2 退款中 3 退款完成 4 退款失败

message

string

退款说明

可选

退款说明

successTime

integer

退款成功时间

可选

msg

string

返回信息

可选

appId

string

应用APPID

必需

string

商户编码

可选

sign

string

签名

必需

timestamp

string

时间戳

必需

signType

string

签名方式目前仅支持RSA2

必需

示例

{
  "code": 88,
  "data": {
    "mchOrderNo": "in Duis esse ad ex",
    "payOrderNo": "nostrud mollit laborum Excepteur ad",
    "mchRefundOrderNo": "adipisicing",
    "instOrderNo": "Ut",
    "refundAmount": "825.19",
    "payInfo": "aliquip velit",
    "reason": "fugiat aute irure laboris do",
    "amount": "990.29",
    "status": "culpa",
    "message": "anim et commodo minim nulla",
    "successTime": 1746098515530
  },
  "msg": "nostrud et dolore commodo",
  "appId": "59",
  "sn": "qui Lorem laboris",
  "sign": "velit officia aliquip sint",
  "timestamp": "1736153882",
  "signType": "et Excepteur ex Ut"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.qywh8.com商户通知地址' \
--header 'Content-Type: application/json' \
--data-raw '{
    "code": 88,
    "data": {
        "mchOrderNo": "in Duis esse ad ex",
        "payOrderNo": "nostrud mollit laborum Excepteur ad",
        "mchRefundOrderNo": "adipisicing",
        "instOrderNo": "Ut",
        "refundAmount": "825.19",
        "payInfo": "aliquip velit",
        "reason": "fugiat aute irure laboris do",
        "amount": "990.29",
        "status": "culpa",
        "message": "anim et commodo minim nulla",
        "successTime": 1746098515530
    },
    "msg": "nostrud et dolore commodo",
    "appId": "59",
    "sn": "qui Lorem laboris",
    "sign": "velit officia aliquip sint",
    "timestamp": "1736153882",
    "signType": "et Excepteur ex Ut"
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

success

4.2.2 退款查询

5.1.1.1 页面版快捷下单接口