信用卡异步通知

信用卡信息通知

当信用卡的状态或者信息发生变化时,BePay网关会向商户系统发起消息通知。如果商户系统没有正确返回,BePay网关会延迟再次通知。

接口说明

适用对象:普通商户 特约商户

请求URL:该链接是商户主动发起操作的接口提交的参数notifyUrl设置或者信用卡系统主动通知时,商户后台填写的信用卡通知链接地址,如果无法访问链接,商户系统将无法接收到BePay系统的通知。

请求方式:POST

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

通知参数

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

支付订单号

payOrderId

String(30)

P12021022311124442600

返回支付系统订单号

商户号

mchNo

String(30)

M1621873433953

商户号

应用ID

appId

String(24)

60cc09bce4b0f1c0b83761c9

应用ID

商户订单号

mchOrderNo

String(30)

20160427210604000490

返回商户传入的订单号

支付接口

ifCode

String(30)

wxpay

支付接口编码

支付方式

wayCode

String(30)

WX_LITE

支付方式,微信小程序WX_LITE

订单金额

amount

BigDecimal

100.00

订单金额(保留2位小数

实际金额

amountActual

BigDecimal

98.00

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

货币代码

currency

String(3)

cny

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

订单状态

state

String(1)

2

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

客户端IP

clientIp

String(32)

210.73.10.148

客户端IPV4地址

商品标题

subject

String(64)

商品标题测试

商品标题

商品描述

body

String(256)

商品描述测试

商品描述

渠道订单号

channelOrderNo

String

20160427210604000490

对应渠道的订单号

渠道错误码

errCode

String

1002

渠道下单返回错误码

渠道错误描述

errMsg

String

134586944573118714

渠道下单返回错误描述

扩展参数

extParam

String(512)

134586944573118714

商户扩展参数

创建时间

createdAt

String(13)

1622016572190

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

成功时间

successTime

String(13)

1622016572190

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

通知请求时间

reqTime

String(30)

1622016572190

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

签名

sign

String(32)

C380BEC2BFD727A4B6845133519F3AD6

签名值,详见签名算法

> 返回结果

业务系统处理后同步返回给支付中心,返回字符串 success 则表示成功,返回非success则表示处理失败,支付中心会再次通知业务系统。(通知频率为0/30/60/90/120/150,单位:秒)

注意:返回的字符串必须是小写,且前后不能有空格和换行符。

通知示例数据

{
    "amount": "5.00",
    "body": "商品描述",
    "clientIp": "192.166.1.132",
    "createdAt": "1622016572190",
    "currency": "cny",
    "extParam": "",
    "ifCode": "wxpay",
    "mchNo": "M1621873433953",
    "appId": "60cc09bce4b0f1c0b83761c9",
    "mchOrderNo": "mho1621934803068",
    "payOrderId": "20210525172643357010",
    "state": "3",
    "subject": "商品标题",
    "wayCode": "WX_BAR",
    "sign": "C380BEC2BFD727A4B6845133519F3AD6"
}

Last updated