商户回调通知

参考式通知商户的回调地址

请求URL:https://{商户注册的回调地址}

请求方式:POST

请求类型:application/jsonapplication/x-www-form-urlencoded

请求参数

头部类型标记

HTTP头
类型
示例值
描述

notify-type

String

1

参考类型描述

当 notify-type = 1 时为法币入金通知

字段名
变量名
必填
类型
示例值
描述

支付订单号

payOrderId

String(30)

P12021022311124442600

返回支付系统订单号

商户号

mchNo

String(30)

M1621873433953

商户号

应用ID

appId

String(24)

60cc09bce4b0f1c0b83761c9

应用ID

商户订单号

mchOrderNo

String(30)

20160427210604000490

返回商户传入的订单号

商户用户ID

mchUserId

String(64)

8518033

返回商户平台用户ID

支付接口

ifCode

String(30)

wxpay

支付接口编码

支付方式

wayCode

String(30)

WX_LITE

支付方式,微信小程序WX_LITE

订单金额

amount

BigDecimal

100.00

订单金额(保留2位小数

实际金额

amountActual

BigDecimal

98.00

实际支付金额(保留2位小数

商户手续费金额

mchFeeAmount

BigDecimal

2.00

商户手续费金额(保留2位小数

货币代码

currency

String(3)

cny

三位货币代码,人民币:cny

订单状态

state

String(1)

2

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

用户是否承担费率

userBorneRates

String(1)

1

0-不承担 1-承担

客户端IP

clientIp

String(32)

210.73.10.148

客户端IPV4地址

商品标题

subject

String(64)

商品标题测试

商品标题

商品描述

body

String(256)

商品描述测试

商品描述

渠道订单号

channelOrderNo

String(64)

20160427210604000490

对应渠道的订单号

渠道错误码

errCode

String(128)

1002

渠道下单返回错误码

渠道错误描述

errMsg

String(256)

134586944573118714

渠道下单返回错误描述

扩展参数

extParam

String(512)

134586944573118714

商户扩展参数

渠道额外参数

channelExtra

String(512)

34586944573118714

渠道额外参数

创建时间

createdAt

String(13)

1622016572190

订单创建时间,13位时间戳

成功时间

successTime

String(13)

1622016572190

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

通知请求时间

reqTime

String(30)

1622016572190

通知请求时间,,13位时间戳

签名

sign

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名值,详见签名算法

当 notify-type = 3 时为法币出金通知

字段名
变量名
必填
类型
示例值
描述

商户号

mchNo

String(30)

M1621873433953

商户号

应用ID

appId

String(24)

60cc09bce4b0f1c0b83761c9

应用ID

商户订单号

mchOrderNo

String(30)

20160427210604000490

商户生成的转账订单号

商户用户ID

mchUserId

String(64)

51258516

商户平台用户ID

转账订单号

transferId

String(30)

T20160427210604000490

支付中心生成的转账单号

转账金额

amount

String(20)

100.00

订单金额(保留2位小数

商户手续费金额

mchFeeAmount

BigDecimal

2.00

商户手续费金额(保留2位小数

转账金额(美元)

amountU

BigDecimal

14.00

订单金额(换算美元)(保留2位小数

货币代码

currency

String(3)

cny

三位货币代码,人民币:cny

入账方式

entryType

String(64)

20160427210604000490

入账方式: WX_CASH-微信零钱; ALIPAY_CASH-支付宝转账; BANK_CARD-银行卡

转账状态

state

String(1)

2

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

收款账号

accountNo

String(64)

o6BcIwvTvIqf1zXZohc61biryWik

wxpay-openID, alipay-登录账号

收款人姓名

accountName

String(64)

张三

填入则验证姓名,否则不验证

收款人开户行名称

bankName

String(64)

中国工商银行

当前仅作为记录

转账备注信息

transferDesc

String(128)

测试转账

转账备注信息

渠道转账单号

channelOrderNo

String(64)

20160427210604000490

对应渠道的转账单号

渠道错误码

errCode

String(128)

1002

渠道返回错误码

渠道错误描述

errMsg

String(256)

134586944573118714

渠道返回错误描述

扩展参数

extraParam

String(512)

134586944573118714

商户扩展参数,回调时会原样返回

渠道额外参数

channelExtra

String(512)

134586944573118714

渠道额外参数,回调时会原样返回

创建时间

createdAt

String(13)

1622016572190

订单创建时间,13位时间戳

成功时间

successTime

String(13)

1622016572190

转账成功时间,13位时间戳

通知请求时间

reqTime

String(30)

1622016572190

通知请求时间,13位时间戳

签名

sign

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名值,详见签名算法

Last updated