API文档示例

API文档示例


异步通知

<h4>简要描述:</h4> <ul> <li>本支付网关向商户服务器发送一个请求</li> <li>商户收到请求后进行业务操作</li> </ul> <h4>请求URL:</h4> <ul> <li> <p>商户传入/后台设置的merchantNoticeUrl 字段</p> </li> <li>请求方式:</li> </ul> <ul> <li>POST</li> </ul> <h4>参数:</h4> <table> <thead> <tr> <th>参数名</th> <th>必选</th> <th>类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>merchantId</td> <td>是</td> <td>long</td> <td>商户id</td> </tr> <tr> <td>outTradeNo</td> <td>是</td> <td>string</td> <td>商户订单号</td> </tr> <tr> <td>totalAmount</td> <td>是</td> <td>long</td> <td>金额 单位 分</td> </tr> <tr> <td>payStatus</td> <td>是</td> <td>int</td> <td>支付状态 11待支付 22支付成功 33支付异常</td> </tr> <tr> <td>dateFormatTime</td> <td>是</td> <td>string</td> <td>用户时间戳</td> </tr> <tr> <td>sign</td> <td>是</td> <td>string</td> <td>请求参数md5后的加密字符串</td> </tr> </tbody> </table> <h4>签名示例:</h4> <pre><code>merchantId=商户Id&amp;outTradeNo=商户订单号&amp;totalAmount=金额&amp;payStatus=11&amp;dateFormatTime=时间戳{商户密钥}</code></pre> <h4>返回示例</h4> <p><code>"ok"</code></p> <p>商户返回ok则表示已经收到本网关发送的消息,并且已经处理完成 本网关将不在发送该订单信息到商户服务器,否则本网关将再次发起异步通知。 同一个订单异步通知 最多3次 时间分别为 用户支付成功1秒后 20分钟后 30分钟后 商户如果正常处理完自己的逻辑必须严格返回”ok”, 否则会影响后面的支付通知 商户收到通知后 payStatus==22 为支付成功 商户必须处理好重复订单通知逻辑 本网关可能会重复发起支付成功的通知 商户已经处理好的通知直接返回ok字符串即可 商户必须严格验证签名 和金额是否一致 实际支付金额可能会跟订单金额有1元的向下浮动 也可以在回调方法内调用订单查询接口进行验证</p>

页面列表

ITEM_HTML