4.1.4 交易结果通知

联调环境

https://api.qywh8.com

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

平台订单号

必需

channelOrderNo

string

渠道订单号

可选

第三方渠道订单号

instOrderNo

string

支付机构订单号

可选

微信支付宝等平台订单号

payDataType

string

支付数据类型

可选

pay_url-支付链接，data-数据体，none-空支付参数

payInfo

string

跳转支付数据

可选

state

string

订单状态

必需

只有条码支付才会返回，条码订单状态，订单状态，1=初始化，2=支付中，3=支付成功，4=已撤销，5=订单关闭 6=订单关闭中 7=支付失败

amount

string

订单金额

必需

单位元

payAmount

string

实际支付金额

可选

单位元

payType

string

支付类型

必需

WECHAT: 微信 ALIPAY: 支付宝 UNION_PAY: 云闪付 DIGITAL: 数字人民币

paySubType

string

支付方式

必需

NATIVE :扫码支付； SCAN : 反扫支付； JSAPI :微信JSAPI、支付宝JSAPI支付、银联JSAPI支付； SIMPLE :简易支付； MINI_APP :微信小程序支付、支付宝小程序支付； H5 :h5 支付； APP :APP 支付； PC :支付宝PC支付

sceneType

integer

场景类型

可选

1 线下 2 线上不传默认线下

providerCode

string

服务商编码

可选

channelCode

string

通道编码

可选

subChannelId

string

子通道id

可选

feeAmount

string

平台扣手续费

可选

feeRate

string

平台扣手续费率

可选

channelFeeAmount

string

通道扣手续费

可选

channelFeeRate

string

通道扣手续费率

可选

settlementAmount

string

实际记账金额

可选

即 amount-feeAmount-channelFeeAmount

subject

string

商品标题

可选

description

string

商品描述

可选

successTime

integer

支付成功时间

可选

单位毫秒

fundFreezeStat

integer

资金冻结状态

可选

1=冻结，0=解冻，仅微信小程序被管控的商户号才会返回

msg

string

返回信息

必需

appId

string

应用APPID

必需

string

商户编码

必需

sign

string

签名

必需

timestamp

string

时间戳

必需

signType

string

签名方式目前仅支持RSA2

必需

示例

{
    "code": 17,
    "data": {
        "mchOrderNo": "est labore laborum ullamco dolor",
        "payOrderNo": "eiusmod ex elit do",
        "channelOrderNo": "enim ullamco nulla",
        "instOrderNo": "non amet fugiat enim ut",
        "payDataType": "occaecat enim Duis ullamco veniam",
        "payInfo": "non enim",
        "state": "天津市",
        "amount": "91.91",
        "payAmount": "280.69",
        "payType": "est",
        "paySubType": "quis est aute",
        "sceneType": 14,
        "providerCode": "61",
        "channelCode": "82",
        "subChannelId": "14",
        "feeAmount": "260.69",
        "feeRate": "commodo",
        "channelFeeAmount": "87.49",
        "channelFeeRate": "reprehenderit sunt eiusmod officia",
        "settlementAmount": "303.75",
        "subject": "voluptate aute",
        "description": "对才细名领走及业。太要象且把律作样。观而可结步。",
        "successTime": 1745002192418
    },
    "msg": "ea nisi cillum eiusmod",
    "appId": "48",
    "sn": "ullamco sunt adipisicing aute",
    "sign": "elit proident",
    "timestamp": "1736152739",
    "signType": "dolore"
}

示例代码

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": 17,
    "data": {
        "mchOrderNo": "est labore laborum ullamco dolor",
        "payOrderNo": "eiusmod ex elit do",
        "channelOrderNo": "enim ullamco nulla",
        "instOrderNo": "non amet fugiat enim ut",
        "payDataType": "occaecat enim Duis ullamco veniam",
        "payInfo": "non enim",
        "state": "天津市",
        "amount": "91.91",
        "payAmount": "280.69",
        "payType": "est",
        "paySubType": "quis est aute",
        "sceneType": 14,
        "providerCode": "61",
        "channelCode": "82",
        "subChannelId": "14",
        "feeAmount": "260.69",
        "feeRate": "commodo",
        "channelFeeAmount": "87.49",
        "channelFeeRate": "reprehenderit sunt eiusmod officia",
        "settlementAmount": "303.75",
        "subject": "voluptate aute",
        "description": "对才细名领走及业。太要象且把律作样。观而可结步。",
        "successTime": 1745002192418
    },
    "msg": "ea nisi cillum eiusmod",
    "appId": "48",
    "sn": "ullamco sunt adipisicing aute",
    "sign": "elit proident",
    "timestamp": "1736152739",
    "signType": "dolore"
}'

返回响应

🟢200OK

application/json

Body

object {0}

示例

success

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

4.1.3 交易关闭

4.2.1 实时退款