支付通知回调

开发中

POST

/xxx/notify/pay

请求参数

Query 参数

reqTime

string

必需

13位请求时间戳，当前时间毫秒数

示例值:

1742280700322

sign

string

必需

App的密钥+请求时间戳+appId 进行md5加密，再转大写（App密钥、appId都是指支付网关颁发的）

示例值:

4A5078DABBCE0D9C4E7668DACB96FF7A

Body 参数application/json

appId

string

应用Id

必需

业务系统的应用Id

channelOrderNo

string

渠道支付订单号

必需

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

mchOrderNo

string

商户订单号

必需

业务系统这一笔支付记录的唯一编号

wayCode

string

支付方式编码

必需

用户支付方式编码：WE_CHAT_PAY-微信支付；ALI_PAY-支付宝；UNION_PAY-银联支付；OTHER-其他

payState

string

支付状态

必需

支付订单状态0-订单生成1-支付中2-支付成功3-支付失败4-已撤销5-已退款6-订单关闭

amount

string

支付金额

必需

单位分

subject

string

商品名称

必需

商品名称

body

string

商品描述

必需

商品描述

errCode

string

渠道错误码

可选

渠道下单返回错误码

errMsg

string

渠道错误描述

可选

渠道下单返回错误描述

extJsonb

string

扩展参数

必需

业务系统扩展参数

createdTime

string

创建时间

必需

支付订单创建时间，13位时间戳

successTime

string

成功时间

可选

支付订单支付成功时间，13位时间戳

notifyUrl

string

异步通知地址

必需

支付结果异步回调URL,只有传了该值才会发起回调

payDetail

array [object {7}]

支付明细

必需

本笔支付订单的支付明细集合

businessId

string

业务系统费用明细Id

可选

业务系统费用明细Id

feeName

string

费用名称

必需

费用名称

feeDesc

string

费用描述

可选

费用描述

feeType

string

费用类型

可选

业务系统中的费用类型

creditDebit

string

收支标记

可选

D：为读者支付图书馆的款项（Debit）；C：为图书馆应支付读者的款项（Credit），一般是指给读者减免的费用

feeAmount

integer

费用金额

必需

单位分

extJsonb

string

扩展参数

可选

商户扩展参数,回调时会原样返回{"title" : "书刊名称",“barCode”: "图书条码"}

示例

{
    "appId": "string",
    "channelOrderNo": "string",
    "mchOrderNo": "string",
    "wayCode": "string",
    "payState": "string",
    "amount": "string",
    "subject": "string",
    "body": "string",
    "errCode": "string",
    "errMsg": "string",
    "extJsonb": "string",
    "createdTime": "string",
    "successTime": "string",
    "notifyUrl": "string",
    "payDetail": [
        {
            "businessId": "string",
            "feeName": "string",
            "feeDesc": "string",
            "feeType": "string",
            "creditDebit": "string",
            "feeAmount": 0,
            "extJsonb": "string"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/xxx/notify/pay?reqTime=1742280700322&sign=4A5078DABBCE0D9C4E7668DACB96FF7A' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appId": "string",
    "channelOrderNo": "string",
    "mchOrderNo": "string",
    "wayCode": "string",
    "payState": "string",
    "amount": "string",
    "subject": "string",
    "body": "string",
    "errCode": "string",
    "errMsg": "string",
    "extJsonb": "string",
    "createdTime": "string",
    "successTime": "string",
    "notifyUrl": "string",
    "payDetail": [
        {
            "businessId": "string",
            "feeName": "string",
            "feeDesc": "string",
            "feeType": "string",
            "creditDebit": "string",
            "feeAmount": 0,
            "extJsonb": "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-06-25 03:05:15

支付记录分页列表查询接口

OpenAPI-退款接口（测试）