AutoPay

在線代付


AutoPay支付接口

<h3>&lt;center&gt;版本记录&lt;/center&gt;</h3> <table> <thead> <tr> <th style="text-align: left;">&lt;center&gt;Ver. No.&lt;/center&gt;</th> <th style="text-align: left;">&lt;center&gt;Ver. Date&lt;/center&gt;</th> <th style="text-align: left;">&lt;center&gt;Revised By&lt;/center&gt;</th> <th>&lt;center&gt;Description&lt;/center&gt;</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">&lt;center&gt;1&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2020/12/11&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Les&lt;/center&gt;</td> <td>&lt;center&gt;定稿&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;2&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2020/12/16&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Les&lt;/center&gt;</td> <td>&lt;center&gt;更新异步通知注意事项&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;3&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2020/12/18&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Les&lt;/center&gt;</td> <td>&lt;center&gt;修改参数选项表示&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;4&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2020/12/24&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Les&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;5&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2021/01/06&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Les&lt;/center&gt;</td> <td>&lt;center&gt;修改请求参数限制&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;6&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2021/03/12&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;7&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2021/03/15&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;8&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2021/05/13&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;9&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2021/07/14&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;10&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2021/10/04&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;修改支付方式&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;11&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2022/02/22&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式(20~22)&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;12&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2022/02/26&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Les&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式(23~25)&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;13&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2022/03/21&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;调整文档格式内容&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;14&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2022/04/20&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增参数: 付款人姓名(payerName)&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;15&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2022/05/09&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式(26~27)&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;16&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2022/05/09&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式(QQ紅包: 28)&lt;/center&gt;</td> </tr> <tr> <td style="text-align: left;">&lt;center&gt;17&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;2022/08/08&lt;/center&gt;</td> <td style="text-align: left;">&lt;center&gt;Chase&lt;/center&gt;</td> <td>&lt;center&gt;新增支付方式(固定二维码: 29)&lt;/center&gt;</td> </tr> </tbody> </table> <h3><strong>目录</strong></h3> <h4>一 、文档说明</h4> <pre><code> 1. 文档说明 2. 阅读对象 3. 系统说明 4. 代付流程 5. 查询流程 6. 代付密钥</code></pre> <h4>二 、AutoPay参数定义</h4> <pre><code> 1. 上行过程接口定义 2. 下行异步通知过程接口定义 3. 查询流程接口定义</code></pre> <hr /> <h3><strong>一、文档说明</strong></h3> <h4><strong>1.文档说明</strong></h4> <p>本说明文档用于指导本站认证商户实现与 AUTOPAY 代付接口的顺利对接。请相关技术人员详细阅读本文档。</p> <h4><strong>2.阅读对象</strong></h4> <p>商户开发人员。 AUTOPAY 接口相关技术人员。</p> <h4><strong>3.术语定义</strong></h4> <p>商户号: AUTOPAY 为使用外部接入接口的商户统一分配的唯一标识。 商户密钥: AUTOPAY 为使用外部接入接口的商户统一分配的32位字符串,该信息作为 AUTOPAY 商户系统数据交互时身份确认的依据,需商户妥善保管。</p> <h4><strong>4.代付流程</strong></h4> <p>通常,一次代付最少包括2个交互过程。第一个过程是 AUTOPAY 商户系统将代付等信息提交到 AUTOPAY 接口的过程,称之为上行过程。第二个过程是在代付完成后, AUTOPAY 接口通过server to server 方式将代付结果告知商户系统的过程,称之为下行异步通知过程。</p> <h4><strong>5.查询流程</strong></h4> <p>商户系统将订单成功提交给 AUTOPAY 接口后的任意时间,商户系统可发起请求查询订单的 处理结果。该流程由商户系统发起,由接口返回相应结果。</p> <h4><strong>6.代付密钥</strong></h4> <p>AUTOPAY 接口采用 MD5 加密方式对传输数据进行签名验证,具体请参考相关接口定义。对MD5 加密后的签名值,请注意结果的大小写务必正确。为了确保签名值不是因为 MD5 加密算法而导致结果不正确,请各商户在调用接口前对字符串 1234567890abcdefghijklmnopqrstuvwxyz 使用 MD5 加密算法进行加密,若加密结果为928f7bcdcd08869cc44c1bf24e7abec6 则表示 MD5 加密正常。</p> <h3><strong>二、 AutoPay 参数定义</strong></h3> <h4><strong>0.测试环境 </strong></h4> <pre><code> domain: http://pay-test.autopayla.com appId: 9995283977FB5E7E key: 48AC10BEB1963BCB8AD4E867EADD73BD</code></pre> <h4><strong>1.上行过程接口定义(商户系统发起请求)</strong></h4> <h5><strong>1.1 支付请求网址</strong></h5> <p><code>正式接入URL: 支付域名(后台查看) + /DMAW2KD7/autoPayDs/sendOrder.zv</code></p> <p><code>**注意!请求地址请设定成可动态配置**</code></p> <h5><strong>1.2 接入方式: <code>FORM POST</code> 方式</strong></h5> <h5><strong>1.3 请求参数:</strong></h5> <table> <thead> <tr> <th style="text-align: left;">参数含意</th> <th style="text-align: left;">参数名称</th> <th style="text-align: left;">必传</th> <th style="text-align: left;">签名</th> <th>长度</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">接口版本</td> <td style="text-align: left;">version</td> <td style="text-align: left;">是</td> <td style="text-align: left;">否</td> <td>4</td> <td>固定值:“V1.0”</td> </tr> <tr> <td style="text-align: left;">商户号</td> <td style="text-align: left;">appId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>30</td> <td>商户在支付平台的唯一标识</td> </tr> <tr> <td style="text-align: left;">支付类型</td> <td style="text-align: left;">orderType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>2</td> <td>支付宝扫码:1&lt;br&gt;支付宝APP:2&lt;br&gt;微信扫码:3&lt;br&gt;微信APP:4&lt;br&gt;网银支付:5&lt;br&gt;支付宝转账银行卡:6&lt;br&gt;微信转账银行卡:7&lt;br&gt;快捷支付:8&lt;br&gt;银联WAP(云闪付):9&lt;br&gt;云转卡:10&lt;br&gt;IndiaBank:12&lt;br&gt;IndiaUPI:13&lt;br&gt;IndiaMoMoPay:14&lt;br&gt;USDT-ERC20:15&lt;br&gt;USDT-TRC20:16&lt;br&gt;USDT-OMNI:17&lt;br&gt;IndonesiaBank:18&lt;br&gt;电子钱包OVO:19&lt;br&gt;越南卡转卡:20&lt;br&gt;越南扫码:21&lt;br&gt;越南直连:22&lt;br&gt;越南MOMOPAY:23&lt;br&gt;越南ZALO:24&lt;br&gt;越南VIETTELPAY:25&lt;br&gt;越南VNPAY:26&lt;br&gt;虚拟币:27&lt;br&gt;QQ紅包:28&lt;br&gt;固定二维码:29</td> </tr> <tr> <td style="text-align: left;">商户订单号</td> <td style="text-align: left;">merchOrderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>32</td> <td>商户系统产生的唯一订单号,此订单号不可重复</td> </tr> <tr> <td style="text-align: left;">交易日期</td> <td style="text-align: left;">orderDate</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>14</td> <td>商户系统生成的订单日期格式:&lt;br&gt;格式:YYYYMMddHHmmss&lt;br&gt;(年[4位]月[2位]日[2位]时[2位]分[2位]秒[2位])&lt;br&gt;ex:20180529123020</td> </tr> <tr> <td style="text-align: left;">支付金额</td> <td style="text-align: left;">amount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>15</td> <td>仅允许两位小数,必须大于零(0.00)</td> </tr> <tr> <td style="text-align: left;">支付通知地址</td> <td style="text-align: left;">notifyUrl</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>128</td> <td>服务器异步通知商户接口路径,支付平台主动调商户接口通知订单支付结果。(<code>若不需回调则传送空值</code>)</td> </tr> <tr> <td style="text-align: left;">请求Ip</td> <td style="text-align: left;">clientIp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>15</td> <td>申请者的Ip位置</td> </tr> <tr> <td style="text-align: left;">会员账号</td> <td style="text-align: left;">clientAccount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">是</td> <td>25</td> <td>申请者的会员账号</td> </tr> <tr> <td style="text-align: left;">会员装置</td> <td style="text-align: left;">clientTerminal</td> <td style="text-align: left;">是</td> <td style="text-align: left;">否</td> <td>50</td> <td>申请者的会员装置类型:&lt;br&gt;pc:1&lt;br&gt;android:2&lt;br&gt;ios:3</td> </tr> <tr> <td style="text-align: left;">付款人姓名</td> <td style="text-align: left;">payerName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">否</td> <td>25</td> <td>付款人姓名。&lt;br&gt;<code>若此值为空,且通道要求必传,则会跳转付款人输入页面</code></td> </tr> <tr> <td style="text-align: left;">扩展字段</td> <td style="text-align: left;">merchRemark</td> <td style="text-align: left;">否</td> <td style="text-align: left;">否</td> <td>240</td> <td>英文或中文字符串,支付完成后,按照原样返回给商户,请在传值前URL Encoding。</td> </tr> <tr> <td style="text-align: left;">签名</td> <td style="text-align: left;">sign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">否</td> <td>2048</td> <td>详见签名规则</td> </tr> <tr> <td style="text-align: left;">签名方式</td> <td style="text-align: left;">signType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">否</td> <td>6</td> <td>签名方式(MD5)</td> </tr> </tbody> </table> <h5><strong>1.4 MD5签名</strong></h5> <p><strong>1.4.1 MD5签名说明</strong> 待签名数据为上表中加入签名列值为<code>是</code>的参数(<code>包含空值</code>)以及商户密钥,签名顺序为表依照ASCII 排序( <code>CASE SENSITIVE</code> )由 <code>a到z并加商户密钥。 MD5 签名结果需转成大写,原串及格式如下:</code></p> <pre><code class="language-java">amount={amount}&amp;amp;appId={appId}&amp;amp;clientAccount={clientAccount}&amp;amp;clientIp={clientIp}&amp;amp;merchOrderNo={merchOrderNo}&amp;amp;notifyUrl={notifyUrl}&amp;amp;orderDate={orderDate}&amp;amp;orderType={orderType}&amp;amp;key={key}</code></pre> <p>其中,key为商户密钥。</p> <p><strong>1.4.2 MD5接入实例:(假设商户Id为1234,商户密钥为123456789)</strong> 实际进行 MD5 加密的串是</p> <pre><code class="language-java">amount=100.00&amp;amp;appId=1234&amp;amp;clientAccount=TEST&amp;amp;clientIp=192.168.0.1&amp;amp;merchOrderNo=PF202008300005332944 &amp;amp;notifyUrl=http://api.callbackTest.com&amp;amp;orderDate=20200830202601&amp;amp;orderType=1 &amp;amp;key=123456789</code></pre> <p>该串 MD5 加密结果为<code>FBF0941E45922AAF67B1E6D00DD0AAB7</code></p> <p><strong>1.4.3 特别说明:</strong> ①在接口使用中,商户系统内发起请求时应使用页面跳转的方式跳转到接口地址。如在jsp中,使用 response.sendRedirect (接口地址及参数),在 .net 中,使用Response.Redirect (接口地址及参数)。 ②根据 HTTP 协议要求,提交参数的值中若存在特殊字符(如:空格、@等)时,为使 AUTOPAY 接口能接收到正确的参数,这些特殊字符需要做 URL Encoding 。需特别注意的是,此时待签名数据应该是原生值而不是 encoding 之后的值。</p> <p>&lt;hr&gt;</p> <h3><strong>2.下行异步通知过程接口定义( AUTOPAY 系统发起请求)</strong></h3> <p><strong><code>重要!!接收到异步通知的时后请调用我们的查询接口二次确认订单状态!</code></strong></p> <p><strong>2.1 接入URL:过程1中请求参数notifyUrl值</strong> <strong>2.2 接入方式:POST方式</strong> <strong>2.3 请求协议参数:</strong></p> <table> <thead> <tr> <th>参数含义</th> <th>参数名称</th> <th>必传</th> <th>签名</th> <th>长度</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>商户号</td> <td>appId</td> <td>是</td> <td>是</td> <td>30</td> <td>商户在支付平台的唯一标识</td> </tr> <tr> <td>平台订单号</td> <td>orderNo</td> <td>是</td> <td>是</td> <td>32</td> <td>平台系统产生的唯一订单号(AUTOPAY)</td> </tr> <tr> <td>商户订单号</td> <td>merchOrderNo</td> <td>是</td> <td>是</td> <td>32</td> <td>商户系统产生的唯一订单号</td> </tr> <tr> <td>订单状态</td> <td>status</td> <td>是</td> <td>是</td> <td>4</td> <td>订单状态:待处理(100)、处理中(200)、成功(300)、失败(400)</td> </tr> <tr> <td>交易日期</td> <td>orderDate</td> <td>是</td> <td>是</td> <td>14</td> <td>商户系统生成的订单日期&lt;br&gt;格式:格式:YYYYMMddHHmmss(年[4&lt;br&gt;位]月[2位]日[2位]时[2位]分[2位]秒[2位])&lt;br&gt;ex:20180529123020</td> </tr> <tr> <td>支付金额</td> <td>amount</td> <td>是</td> <td>是</td> <td>15</td> <td>以“元”为单位,仅允许两位小数,必须大于零&lt;br&gt;(<code>orderType=12或13时,单位为卢比</code>)&lt;br&gt;(<code>orderType=18或19时,单位为印尼盾</code>)</td> </tr> <tr> <td>扩展字段</td> <td>merchRemark</td> <td>否</td> <td>否</td> <td>240</td> <td>英文或中文字符串,支付完成后,按照原样返&lt;br&gt;回给商户,收到值后须URL Decodin g</td> </tr> <tr> <td>签名</td> <td>sign</td> <td>是</td> <td>否</td> <td>1024</td> <td></td> </tr> </tbody> </table> <p><strong>2.4 返回协议参数:</strong></p> <table> <thead> <tr> <th>参数含意</th> <th>参数名称</th> <th>必填</th> <th>长度</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>返回值</td> <td>AUTOPAY</td> <td>是</td> <td>5</td> <td>不区分大小写,只能回传 AUTOPAY</td> </tr> </tbody> </table> <h5><strong>2.5 MD5签名</strong></h5> <p><strong>2.5.1 MD5签名说明:</strong> 待签名数据为上表中加入签名列值为<code>是</code>的参数以及商户密钥,签名顺序为表依照ASCII 排序( <code>CASE SENSITIVE</code> )由 <code>a到z并加商户密钥。具体 MD5 签名结果并大写原串及格式如下:</code></p> <pre><code class="language-java">amount={amount}&amp;amp;appId={appId}&amp;amp;merchOrderNo={merchOrderNo}&amp;amp;orderDate={orderDat}&amp;amp;orderNo={orderNo}&amp;amp;status={status}&amp;amp;key={key}</code></pre> <p>其中,key为商户密钥。</p> <p><strong>2.5.2 接入实例:(假设商户Id为1234,商户密钥为123456789)</strong> 实际进行MD5加密的串是</p> <pre><code class="language-java">amount=100.00&amp;amp;appId=1234&amp;amp;merchOrderNo=PF202008240003978416&amp;amp;orderNo=DF202008249980000001 &amp;amp;status=400&amp;amp;orderDate=20200830183510&amp;amp;key=123456789</code></pre> <p>该串 MD5 加密结果为 8DAF2249C7DCAC8809F840E4D07D96A0</p> <p><strong>2.6 特别说明:</strong> ① 下行异步通知过程在整个支付流程中一定存在。商户系统在收到下行通知过程后,<strong>需</strong> <strong>向 AUTOPAY 支付API接口返回<code>AUTOPAY</code></strong>。 AUTOPAY 支付 API 接口根据该返回值判断 商户系统是否已经收到结果。若返回结果不是“ AUTOPAY ”, AUTOPAY 支付 API 接口会 根据商家和 AUTOPAY 支付 API 接口的约定,再次反复向 notifyUrl 发送结果,直到商户 返回<code>AUTOPAY</code>或者达到和商户约定的重复发送次数。 ② 当 AUTOPAY 支付 API 接口在下行异步通知过程中返回在线支付结果时,商户系统在收 到数据后,应该通过 sign 值判断是否是有效的返回数据,防止数据在网络传输过程 中被恶意篡改。</p> <p><strong>2.7 注意事项:</strong> ① 在收到 AUTOPAY 支付 API 接口订单下行异步通知结果时,商户系统需首先验证订单通知的合法性,如果不合法,则不要更新商户系统上的订单状态。 ② 商户系统内订单状态和订单实际金额务必以此次 AUTOPAY 支付 API 接口订单异步通知的结果为准。 ③ 商户系统在成功提交订单后,在未没有收到 AUTOPAY 支付 API 接口异步通知结果时,请不要更新商户系统上的订单状态 ④ 在下行异步通知过程中商户系统返回结果值“ AUTOPAY ”回 AUTOPAY 支付 API 接口时,“ AUTOPAY ”并不是将 AUTOPAY 支付 API 接口在下行异步通知的结果原样返回。商户系统返回值“ AUTOPAY ”时表示商户系统已经成功接收到了结果(不论结果是什么,总之是收到了),而其他值表示因为某些原因商户系统并不认为 AUTOPAY 支付 API 接口的返回是有效的。 AUTOPAY 支付 API接口在收到商户系统的返回后,如果返回的值为“ AUTOPAY ” AUTOPAY 支付 API 接口将不再次发送结果,否则 AUTOPAY 支付 API 接口会根据 AUTOPAY 支付 API 接口同商户的约定再次发送结果。</p> <hr /> <h3><strong>3.查询流程接口定义</strong></h3> <p><strong>3.1 支付查询请求网址</strong></p> <p><code>正式接入URL: 支付域名(后台查看) + /DMAW2KD7/autoPayDs/queryOrder.zv</code></p> <p><code>**注意!查询地址请设定成可动态配置**</code></p> <p><strong>3.2 接入方式:<code>FORM POST</code> 方式</strong> <strong>3.3 请求参数:</strong></p> <table> <thead> <tr> <th>参数含义</th> <th>参数名称</th> <th>必传参数</th> <th>签名参数</th> <th>长度</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>商户号</td> <td>appId</td> <td>是</td> <td>是</td> <td>30</td> <td>商户在支付平台的唯一标识</td> </tr> <tr> <td>商户订单号</td> <td>merchOrderNo</td> <td>是</td> <td>是</td> <td>32</td> <td>商户系统产生的唯一订单号,此订单&lt;br&gt;号不可重复</td> </tr> <tr> <td>签名</td> <td>sign</td> <td>是</td> <td>否</td> <td>1024</td> <td></td> </tr> </tbody> </table> <p><strong>3.4 MD5 Sign </strong> <strong>3.4.1 MD5签名说明:</strong> 待签名数据为上表中加入签名列值为' 是 '的参数以及商户密钥,签名顺序为表依照ASCII排序由 <code>a到z并加商户密钥。具体MD5签名结果并大写原串及格式如下</code>:</p> <pre><code class="language-java">appId={appId}&amp;amp;merchOrderNo={merchOrderNo}&amp;amp;key={key}</code></pre> <p>其中,key为商户密钥。</p> <p><strong>3.4.2 MD5接入实例:</strong> (假设商户Id为1234,商户密钥为123456789) 实际进行MD5加密的串是</p> <pre><code class="language-java">appId=1234&amp;amp;merchOrderNo=PF202008240003978416&amp;amp;key=123456789</code></pre> <p>该串MD5加密结果为 43D25D0A0DA0AC3B3E4C266ACF989D4E</p> <p><strong>3.5 返回协议参数:</strong></p> <p><strong><em>3.5.1 请求返回固定参数:</em></strong></p> <table> <thead> <tr> <th>参数含意</th> <th>参数名称</th> <th>必传</th> <th>签名</th> <th>长度</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>状态码</td> <td>code</td> <td>是</td> <td>否</td> <td>4</td> <td>回应状态码,0000请求本次请求成功</td> </tr> <tr> <td>回应讯息</td> <td>msg</td> <td>是</td> <td>否</td> <td>2048</td> <td>回应讯息</td> </tr> <tr> <td>订单讯息</td> <td>data</td> <td>是</td> <td>否</td> <td>4096</td> <td>订单查询的讯息,验签只需检验里面的内容</td> </tr> </tbody> </table> <p><strong><em>3.5.2 请求返回订单讯息(data):</em></strong></p> <table> <thead> <tr> <th>参数含意</th> <th>参数名称</th> <th>必传</th> <th>签名</th> <th>长度</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>平台订单号</td> <td>orderNo</td> <td>是</td> <td>是</td> <td>32</td> <td>平台系统产生的唯一订单号(AUTOPAY)</td> </tr> <tr> <td>商户订单号</td> <td>merchOrderNo</td> <td>是</td> <td>是</td> <td>32</td> <td>商户系统产生的唯一订单号,此订单号不可重复</td> </tr> <tr> <td>支付金额</td> <td>amount</td> <td>是</td> <td>是</td> <td>15</td> <td>以人民币“元”为单位,仅允许两位小数,必须大于零(2.00)&lt;br&gt;(<code>orderType=12或13时,单位为卢比</code>)&lt;br&gt;(<code>orderType=18或19时,单位为印尼盾</code>)</td> </tr> <tr> <td>订单状态</td> <td>status</td> <td>是</td> <td>是</td> <td>4</td> <td>订单状态:待处理(100)、处理中(200)、成功(300)、失败(400)、冲正(500)</td> </tr> <tr> <td>交易日期</td> <td>orderDate</td> <td>是</td> <td>是</td> <td>14</td> <td>商户系统生成的订单日期&lt;br&gt;格式:格式:YYYYMMDDHHmmss(年[4&lt;br&gt;位]月[2位]日[2位]时[2位]分[2位]秒[2位])&lt;br&gt;ex:20180529123020</td> </tr> <tr> <td>签名</td> <td>sign</td> <td>是</td> <td>否</td> <td>2048</td> <td>详见签名规则</td> </tr> <tr> <td>签名方式</td> <td>signType</td> <td>是</td> <td>否</td> <td>6</td> <td>签名方式(MD5)</td> </tr> </tbody> </table> <p><strong>以json格式回传,范例结果如下:</strong> <strong>查询成功范例</strong></p> <pre><code class="language-json">{&amp;quot;msg&amp;quot;:&amp;quot;请求成功&amp;quot;, &amp;quot;code&amp;quot;:&amp;quot;0000&amp;quot;, &amp;quot;data&amp;quot;:{&amp;quot;amount&amp;quot;:&amp;quot;93.98&amp;quot;, &amp;quot;orderDate&amp;quot;:&amp;quot;&amp;quot;, &amp;quot;orderNo&amp;quot;:&amp;quot;DF202008209980000003&amp;quot;, &amp;quot;sign&amp;quot;:&amp;quot;9B5EB1E54A658FB179D05762C84F7464&amp;quot;, &amp;quot;status&amp;quot;:&amp;quot;100&amp;quot;, &amp;quot;merchantOrderNo&amp;quot;:&amp;quot;PF202008200001800685&amp;quot;} }</code></pre> <p><strong>查询失败范例:</strong></p> <pre><code class="language-json">{&amp;quot;msg&amp;quot;:&amp;quot;缺少必要参数[appId not found]&amp;quot;,&amp;quot;code&amp;quot;:&amp;quot;1000&amp;quot;,&amp;quot;data&amp;quot;:&amp;quot;&amp;quot;}</code></pre>

页面列表

ITEM_HTML