# 信用卡异步通知

### 信用卡信息通知 <a href="#cefqcb" id="cefqcb"></a>

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

> 接口说明

适用对象：`普通商户` `特约商户`

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

请求方式：`POST`

请求类型：`application/x-www-form-urlencoded`

> 通知参数

<table><thead><tr><th width="152">字段名</th><th width="138">变量名</th><th width="71">必填</th><th>类型</th><th>示例值</th><th>描述</th></tr></thead><tbody><tr><td>支付订单号</td><td>payOrderId</td><td>是</td><td>String(30)</td><td>P12021022311124442600</td><td>返回支付系统订单号</td></tr><tr><td>商户号</td><td>mchNo</td><td>是</td><td>String(30)</td><td>M1621873433953</td><td>商户号</td></tr><tr><td>应用ID</td><td>appId</td><td>是</td><td>String(24)</td><td>60cc09bce4b0f1c0b83761c9</td><td>应用ID</td></tr><tr><td>商户订单号</td><td>mchOrderNo</td><td>是</td><td>String(30)</td><td>20160427210604000490</td><td>返回商户传入的订单号</td></tr><tr><td>支付接口</td><td>ifCode</td><td>是</td><td>String(30)</td><td>wxpay</td><td>支付接口编码</td></tr><tr><td>支付方式</td><td>wayCode</td><td>是</td><td>String(30)</td><td>WX_LITE</td><td>支付方式,微信小程序WX_LITE</td></tr><tr><td>订单金额</td><td>amount</td><td>是</td><td>BigDecimal</td><td>100.00</td><td>订单金额（保留<mark style="color:red;">2位小数</mark>）</td></tr><tr><td>实际金额</td><td>amountActual</td><td>是</td><td>BigDecimal</td><td>98.00</td><td>实际支付金额（保留<mark style="color:red;">2位小数</mark>）</td></tr><tr><td>货币代码</td><td>currency</td><td>是</td><td>String(3)</td><td>cny</td><td>三位货币代码,人民币:cny</td></tr><tr><td>订单状态</td><td>state</td><td>是</td><td>String(1)</td><td>2</td><td>支付订单状态<br>0-订单生成<br>1-支付中<br>2-支付成功<br>3-支付失败<br>4-已撤销<br>5-已退款<br>6-订单关闭</td></tr><tr><td>客户端IP</td><td>clientIp</td><td>否</td><td>String(32)</td><td>210.73.10.148</td><td>客户端IPV4地址</td></tr><tr><td>商品标题</td><td>subject</td><td>是</td><td>String(64)</td><td>商品标题测试</td><td>商品标题</td></tr><tr><td>商品描述</td><td>body</td><td>是</td><td>String(256)</td><td>商品描述测试</td><td>商品描述</td></tr><tr><td>渠道订单号</td><td>channelOrderNo</td><td>否</td><td>String</td><td>20160427210604000490</td><td>对应渠道的订单号</td></tr><tr><td>渠道错误码</td><td>errCode</td><td>否</td><td>String</td><td>1002</td><td>渠道下单返回错误码</td></tr><tr><td>渠道错误描述</td><td>errMsg</td><td>否</td><td>String</td><td>134586944573118714</td><td>渠道下单返回错误描述</td></tr><tr><td>扩展参数</td><td>extParam</td><td>否</td><td>String(512)</td><td>134586944573118714</td><td>商户扩展参数</td></tr><tr><td>创建时间</td><td>createdAt</td><td>是</td><td>String(13)</td><td>1622016572190</td><td>订单创建时间,13位时间戳</td></tr><tr><td>成功时间</td><td>successTime</td><td>否</td><td>String(13)</td><td>1622016572190</td><td>订单支付成功时间,13位时间戳</td></tr><tr><td>通知请求时间</td><td>reqTime</td><td>是</td><td>String(30)</td><td>1622016572190</td><td>通知请求时间，,13位时间戳</td></tr><tr><td>签名</td><td>sign</td><td>是</td><td>String(32)</td><td>C380BEC2BFD727A4B6845133519F3AD6</td><td>签名值，详见签名算法</td></tr></tbody></table>

\> 返回结果

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

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

`通知示例数据`

```json
{
    "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"
}
```
