退款通知回调

开发中

POST

/xxx/notify/refund

请求参数

Query 参数

reqTime

string

请求时间戳

必需

示例值:

20190723141000

sign

string

签名

必需

示例值:

4A5078DABBCE0D9C4E7668DACB96FF7A

Body 参数application/json

appId

string

应用Id

必需

业务系统的应用Id

channelPayOrderNo

string

渠道支付订单号

必需

支付网关与支付渠道之间的唯一订单号，比如与工行聚合支付的交易编号

channelOrderNo

string

渠道退款订单号

必需

返回支付网关与支付渠道之间的唯一退款订单号，

mchRefundNo

string

商户退款单号

必需

业务系统这一笔退款记录的唯一编号，

payAmount

string

支付金额

必需

单位分

refundAmount

string

退款金额

必需

单位分

refundState

string

退款状态

必需

退款状态0-订单生成1-退款中2-退款成功3-退款失败4-退款关闭

errCode

string

渠道错误码

可选

渠道返回错误码

errMsg

string

渠道错误描述

可选

渠道返回错误描述

extJsonb

string

扩展参数

必需

业务系统扩展参数

createdTime

string

创建时间

必需

退款订单创建时间

successTime

string

成功时间

可选

退款订单退款成功时间

示例

{
    "appId": "string",
    "channelPayOrderNo": "string",
    "channelOrderNo": "string",
    "mchRefundNo": "string",
    "payAmount": "string",
    "refundAmount": "string",
    "refundState": "string",
    "errCode": "string",
    "errMsg": "string",
    "extJsonb": "string",
    "createdTime": "string",
    "successTime": "string"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/xxx/notify/refund?reqTime=20190723141000&sign=4A5078DABBCE0D9C4E7668DACB96FF7A' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "string",
    "channelPayOrderNo": "string",
    "channelOrderNo": "string",
    "mchRefundNo": "string",
    "payAmount": "string",
    "refundAmount": "string",
    "refundState": "string",
    "errCode": "string",
    "errMsg": "string",
    "extJsonb": "string",
    "createdTime": "string",
    "successTime": "string"
}'

返回响应

🟢200成功

application/json

Body

code

string

返回状态

必需

success或-成功，非success-失败，返回非success则表示处理失败。若失败阶梯式回调，0/30/60/90/120/24*3600
success 也可用 COMMON_200 替代

msg

string

可选

data

object

可选

示例

{
    "code": "string",
    "msg": "string",
    "data": {}
}

修改于 2025-02-20 05:51:13

退款记录分页查询接口

增加