6.3 付款通知

联调环境

https://api.qywh8.com

POST

商户通知地址

1、向付款请求中上送的后台通知地址，通知成功的付款交易结果。

注意事项

异步如果未返回正确响应会进行重发，目前只会重复通知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

返回数据体

必需

mchChannelCode

string

通道编码

必需

entryType

string

入账方式

必需

1=支付宝账户，2=微信零钱，3=银行卡，4=渠道内部户

mchOrderNo

string

商户订单号

必需

amount

string

付款金额

必需

clientIp

string

必需

remark

string

付款说明

必需

name

string

收款方姓名

必需

cardNo

string

收款人账号

必需

支付宝为支付宝账号，微信为openid，银行卡为银行卡账号，渠道内部户为内部账号

payeeType

string

收款方类型

必需

1=个人，2=企业，入账方式为3或4必传，其它非必传

bankCode

string

收款方银行编码

可选

入账方式为3必传，其它非必传，具体渠道侧编码请咨询销售

bankName

string

收款方银行名称

可选

入账方式为3必传，其它非必传，具体渠道侧编码请咨询销售

branchCode

string

联行号

可选

入账方式为3必传，其它非必传

status

integer

付款状态

必需

2=处理中，3=转账完成，4=转账失败，6=交易退票

payOrderNo

string

平台订单号

必需

channelOrderNo

string

渠道订单号

可选

instOrderNo

string

支付机构订单号

可选

successTime

integer

成功时间

可选

单位毫秒

refundSuccessTime

integer

退票成功时间

可选

单位毫秒

extra

object

可选

notifyUrl

string

异步通知地址

可选

message

string

驳回原因

可选

msg

string

返回信息

可选

appId

string

应用APPID

可选

string

商户编码

可选

sign

string

签名

可选

timestamp

string

时间戳

可选

signType

string

签名方式目前仅支持RSA2

可选

示例

{
    "code": 0,
    "data": {
        "mchChannelCode": "string",
        "entryType": "string",
        "mchOrderNo": "string",
        "amount": "string",
        "clientIp": "string",
        "remark": "string",
        "name": "string",
        "cardNo": "string",
        "payeeType": "string",
        "bankCode": "string",
        "bankName": "string",
        "branchCode": "string",
        "status": 0,
        "payOrderNo": "string",
        "channelOrderNo": "string",
        "instOrderNo": "string",
        "successTime": 0,
        "refundSuccessTime": 0,
        "extra": {
            "accountType": "string",
            "payerShowName": "string"
        },
        "notifyUrl": "string",
        "message": "string"
    },
    "msg": "string",
    "appId": "string",
    "sn": "string",
    "sign": "string",
    "timestamp": "string",
    "signType": "string"
}

示例代码

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": 0,
    "data": {
        "mchChannelCode": "string",
        "entryType": "string",
        "mchOrderNo": "string",
        "amount": "string",
        "clientIp": "string",
        "remark": "string",
        "name": "string",
        "cardNo": "string",
        "payeeType": "string",
        "bankCode": "string",
        "bankName": "string",
        "branchCode": "string",
        "status": 0,
        "payOrderNo": "string",
        "channelOrderNo": "string",
        "instOrderNo": "string",
        "successTime": 0,
        "refundSuccessTime": 0,
        "extra": {
            "accountType": "string",
            "payerShowName": "string"
        },
        "notifyUrl": "string",
        "message": "string"
    },
    "msg": "string",
    "appId": "string",
    "sn": "string",
    "sign": "string",
    "timestamp": "string",
    "signType": "string"
}'

返回响应

🟢200OK

application/json

Body

No schema defined

示例

success

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

6.2 付款查询

6.4 付款余额查询