深爱支付接口文档

API聚合支付接口文档


支付结果通知API

<p><strong>简要描述:</strong> </p> <p>同步&amp;异步回调均以get方式返回数据。</p> <p>对后台通知交互时,如果平台收到商户的应答不是纯字符串success或超过5秒后返回时,平台认为通知失败,平台会通过一定的策略(<strong>通知频率为0/15/15/30/180/1800/1800/1800/1800/3600,单位:秒</strong>)间接性重新发起通知,尽可能提高通知的成功率,但不保证通知最终能成功。</p> <p>商户系统必须能够正确处理重复的通知。由于存在重新发送后台通知的情况, 因此同样的通知可能会多次发送给商户系统。<em>商户系统必须能够正确处理重复的通知。</em></p> <p>推荐的做法是, 当收到通知进行处理时, 首先检查对应业务数据的状态, 判断该通知是否已经处理过, 如果没有处理过再进行处理, 如果处理过直接返回结果成功。 在对业务数据进行状态检查和处理之前, 要采用数据锁进行并发控制, 以避免函数重入造成的数据混乱。</p> <p><strong>参数:</strong> </p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">sErrorCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>订单提交状态,1为成功,0为失败</td> </tr> <tr> <td style="text-align: left;">bType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>返回方式,1为直接返回 2为异步返回。该参数方便商户只发起一个回调通知地址在一个页面做判断。</td> </tr> <tr> <td style="text-align: left;">ForUserId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户编号,即商户会员ID</td> </tr> <tr> <td style="text-align: left;">LinkID</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>商户订单流水号,商户发起支付时的订单号原样返回</td> </tr> <tr> <td style="text-align: left;">Moneys</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>支付金额,单位元</td> </tr> <tr> <td style="text-align: left;">AssistStr</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string</td> <td>附加字符串,商户网站传递过来的附加信息,将原样返回</td> </tr> <tr> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">string</td> <td>32位MD5签名</td> </tr> </tbody> </table> <p><strong>签名字符串:</strong> <code>sErrorCode=&amp;bType=&amp;ForUserId=&amp;LinkID=&amp;Moneys=&amp;AssistStr=&amp;keyValue=商户密钥</code></p> <p><strong>注意:</strong>签名之前一定要先将字符串转换为小写后再签名;通过MD5(32位)方式签名(编码必须是gb2312,加密后转换为小写)。 </p> <p><strong>签名举例:</strong></p> <blockquote> <p>待签名字符串:sErrorCode=1&amp;bType=2&amp;ForUserId=76342&amp;LinkID=20180807122048488&amp;Moneys=1&amp;AssistStr=&amp;keyValue=vtstvnh7SmFDAywWHmQfEtMGbiQlBpco</p> <p>签名结果: 2a4a7a7c2be638caa5f770d2936eec21</p> </blockquote>

页面列表

ITEM_HTML