绑卡支付下单

<h5>简要描述</h5> <ul> <li>商户需调用该接口生成订单；</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/vborder/bindpay/create</code></li> </ul> <h5>请求方式</h5> <ul> <li>POST </li> </ul> <h5>参数</h5> <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;">orderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td>商户绑卡支付请求号,商户系统内部生成的订单号，需要保持在同一个商户下唯一 <br> <span style="color:#F00"> 示例：2022090700001</td> </tr> <tr> <td style="text-align: left;">bindId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td>绑卡请求成功后返回的，每次支付需要使用<br><span style="color:#F00"> 示例：xxxxxxxxxxxxxx</td> </tr> <tr> <td style="text-align: left;">userType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(10)</td> <td>可选项如下:<br>IMEI:imei<br>MAC:网卡地址<br>USER_ID:用户 ID<br>EMAIL:用户注册email<br>PHONE:用户注册手机号<br>ID_CARD:用户身份证号<br>AGREEMENT_NO:用户纸质订单协议号<br>WECHAT:微信号</td> </tr> <tr> <td style="text-align: left;">userIp</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td>传真实用户请求IP，否则可能会有风控的问题</td> </tr> <tr> <td style="text-align: left;">identifyId</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(50)</td> <td>用户标识,保证每个支付用户唯一，绑卡的标识性数据。形成绑卡关系后，卡会绑定在这个用户标识下。 <br> <span style="color:#F00"> 示例：如用户类型选择EMAIL,标识则为xxxx@email.com</span></td> </tr> <tr> <td style="text-align: left;">orderAmount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">Long(11)</td> <td>订单总金额,以分为单位 <br><span style="color:#F00"> 示例：100</td> </tr> <tr> <td style="text-align: left;">goodName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td>商品名称<br><span style="color:#F00"> 示例：保单缴费</span></td> </tr> <tr> <td style="text-align: left;">notifyUrl</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(256)</td> <td>异步支付结果通知地址，暂不支持<br><span style="color:#F00"> 示例： <a href="https://notify.com/xxx">https://notify.com/xxx</a></td> </tr> <tr> <td style="text-align: left;">expiredTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td>订单支付过期时间 <br>格式："yyyy-MM-dd HH:mm:ss" 不传默认120分钟 <br><span style="color:#F00"> 2022-09-07 12:23:45</td> </tr> <tr> <td style="text-align: left;">ext1</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(512)</td> <td>附加数据,在通知中原样返回 ,<span style="color:#F00"> 不允许使用^字符</td> </tr> <tr> <td style="text-align: left;">ext2</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(512)</td> <td>附加数据,在通知中原样返回 ,<span style="color:#F00"> 不允许使用^字符</td> </tr> <tr> <td style="text-align: left;">divideType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(16)</td> <td>分账订单标记 <br>DELAY_SETTLE:需要分账<br>REAL_TIME:不需要分账<br>REAL_TIME_DIVIDE:实时分账;需同时传入divideDetail 不上送默认不需要分账 <span style="color:#F00"> 示例： DELAY_SETTLE</td> </tr> <tr> <td style="text-align: left;">divideDetail</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td>分账明细 <br>divideType为实时分账时，必传。JSON格式：<br>divideRecvCustomerNo:分账接收方<br>divideAmount:分账金额 <br>detailCustomerSeq:分账明细单号<br>divideDesc:分账描述 <span style="color:#F00"> 示例： [{"detailCustomerSeq":"20240403000001","divideDesc":"分账","divideRecvCustomerNo":"0000000002","divideAmount":"2"}]</td> </tr> <tr> <td style="text-align: left;">divideNotifyUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td>分账通知地址，不传则不通知 <span style="color:#F00"> 示例： <a href="https://notify.com/xxx">https://notify.com/xxx</a></td> </tr> </tbody> </table> <h5>返回参数说明</h5> <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;">customerNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td>商户号 <br><span style="color:#F00"> 示例：202112090603</td> </tr> <tr> <td style="text-align: left;">orderNo</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td>商户绑卡请求号<br><span style="color:#F00"> 示例：2022090700001</td> </tr> <tr> <td style="text-align: left;">errCode</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td>错误编码 <br><span style="color:#F00"> 示例：0000</td> </tr> <tr> <td style="text-align: left;">errMessage</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(256)</td> <td>错误描述<br><span style="color:#F00"> 示例：成功</td> </tr> <tr> <td style="text-align: left;">verifyCodeType</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(256)</td> <td>验证码类型<br>SMS：短信验证码<br>VOICE：语言验证码<br>NONE：无需验证码<br>当返回SMS或VOICE时，需调用绑卡支付短验请求接口，请求发送验证码<span style="color:#F00"> 示例：NONE</td> </tr> <tr> <td style="text-align: left;">extParamMap</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td>绑卡支付需补充的信息，以“;”分隔如果有值返回，需通过绑卡支付确认接口回填<br>例有 BankCardNo 参数返回，那么在调绑卡支付确认接口时需回传银行卡号信息<span style="color:#F00"> 示例：NONE</td> </tr> <tr> <td style="text-align: left;">payStatus</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td><strong>支付状态</strong> <br>WAITPAY：待支付<br> PROCESSING：订单支付中<br>SUCCESS：订单支付成功<br>TIME_OUT：订单已过期<br>FAIL：订单支付失败<br>CLOSE：订单关闭 <br><span style="color:#F00"> 示例：SUCCESS</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{ &quot;code&quot;:&quot;200&quot;, &quot;success&quot;:true, &quot;data&quot;:&quot;{\&quot;customerNo\&quot;:\&quot;202112090603\&quot;,\&quot;reqmsg\&quot;:\&quot;g3vyXbxqFP6ejHAsbRgnw4iwFaZiLu59CeFLSlZ9duouQhXDP5GX/H+n/4g4OhM9SxyBavyQQKBzEN1E2myq+vs5+PAvBq0twqnL+Jh/HwXLmyC3hQVPzMulSLnyUr3iORDFHCLUtQ9rst+nhsjQyBR+2hlgFeNqpz+HNxpMogMOOfaLgHW7SxxF4BMfDK5tBE8mB2KkLrii416BiDpJKbDOgZ+K3B+Th//UpCTcdeaWLP1Bvt8X5oauI5futPRegNIseNtOJ5nTZHWLnMT8bURETfsZkOzOaykkpP1KDa2L4fkan76hW10CJK94sCYiHQiCYhYRVtbyVSzYLneph0javXVDucmY0FaAkglivZ/6Uu2kpyRZDD+sj0ohUJC0gK5x6G6ue7l47Knujr2w7q5jHnLBnhBt5+sENMD+wMaTs4TAgmQCw0AtnS9mVVbe6PYptLNN7rMMDPQc9QiB0F6T0NcTtCUGk14tND65iJY0gNHCo6EO1IvlKB/Zv9sm45zXRQ/LceYvtrsDM1IaQF67Z2+s6XUnApVD7x48z6Ec1sh/S1MD4XSmyXerIYcON75qG0LrmUkNNHUawqMoB6Izhu9CzrkzIsR5ufaUHPV9Z09olc3+OkoInepxCphmVfLW8hYZIeAlzB5py9iKHGKkCyCgU14v8HKXDivpvkaLroRyPKweiFzuxF5DuVlzZi8mdAVTjaImzuegxFTO7tJGStjoQexQs6nyetXuJ0+ytvaoXXdeZHphqQj6OoHmnA+iVZI6CO1PGCzu/Fwz4CtWSPUf6We1tjYYCLRYBtw3yPe9UpW1ygHP7e9G3/QW0WvmsUbg2okhYFEBXheeJX+nvONdUsHOuHGNktr/LAtrYooJUl2cI5Ts7bRk7qHNbvQeW39y9zzdlj1sLMqGvWRINg4coOc8M0EcdxAC/Pp4h7y+v1hCq6lTnI1dhmD1zACu/Ako6PcY76QK8Er43KYFW0AM7LJ0d+I5cYWfyf5nxh+oMNVPStIHOIouMWm7\&quot;}&quot;, &quot;msg&quot;:&quot;操作成功&quot; } reqmsg明文： { &quot;orderNo&quot;: &quot;202308100000012&quot;, &quot;customerNo&quot;: &quot;202112090603&quot;, &quot;verifyCodeType&quot;: &quot;NONE&quot;, &quot;errCode&quot;: &quot;0000&quot;, &quot;errMessage&quot;: &quot;成功&quot;, &quot;extParamMap&quot;: &quot;{\&quot;supplyNeedItemScene\&quot;:\&quot;NONE\&quot;,\&quot;needItems\&quot;:null}&quot;, &quot;payStatus&quot;: &quot;WAITPAY&quot; } { &quot;errCode&quot;: &quot;2104&quot;, &quot;errMessage&quot;: &quot;订单已存在，请勿重复提交&quot;, &quot;payStatus&quot;: &quot;WAITPAY&quot; }</code></pre> <h5>错误码</h5> <table> <thead> <tr> <th style="text-align: left;">错误码</th> <th style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">0000</td> <td style="text-align: left;">成功</td> </tr> <tr> <td style="text-align: left;">1001</td> <td style="text-align: left;">系统异常</td> </tr> <tr> <td style="text-align: left;">1002</td> <td style="text-align: left;">请求参数错误</td> </tr> <tr> <td style="text-align: left;">1003</td> <td style="text-align: left;">必填参数为空</td> </tr> <tr> <td style="text-align: left;">1004</td> <td style="text-align: left;">IP地址未授权</td> </tr> <tr> <td style="text-align: left;">1005</td> <td style="text-align: left;">签名校验失败</td> </tr> <tr> <td style="text-align: left;">1006</td> <td style="text-align: left;">访问频率超限</td> </tr> <tr> <td style="text-align: left;">1007</td> <td style="text-align: left;">网络异常</td> </tr> <tr> <td style="text-align: left;">1008</td> <td style="text-align: left;">参数校验失败</td> </tr> <tr> <td style="text-align: left;">1009</td> <td style="text-align: left;">加解密失败</td> </tr> <tr> <td style="text-align: left;">9999</td> <td style="text-align: left;">其他错误，不可设置交易为失败</td> </tr> <tr> <td style="text-align: left;">2001</td> <td style="text-align: left;">商户信息异常，请联系客服</td> </tr> <tr> <td style="text-align: left;">2002</td> <td style="text-align: left;">渠道处理失败</td> </tr> <tr> <td style="text-align: left;">2101</td> <td style="text-align: left;">订单已支付成功</td> </tr> <tr> <td style="text-align: left;">2102</td> <td style="text-align: left;">订单处理中</td> </tr> <tr> <td style="text-align: left;">2104</td> <td style="text-align: left;">订单已存在，请勿重复提交</td> </tr> <tr> <td style="text-align: left;">2106</td> <td style="text-align: left;">订单不存在</td> </tr> <tr> <td style="text-align: left;">2107</td> <td style="text-align: left;">商户订单号重复，请重新生产订单号</td> </tr> <tr> <td style="text-align: left;">2108</td> <td style="text-align: left;">订单支付失败</td> </tr> <tr> <td style="text-align: left;">3101</td> <td style="text-align: left;">订单已关闭</td> </tr> <tr> <td style="text-align: left;">3105</td> <td style="text-align: left;">订单已过期</td> </tr> <tr> <td style="text-align: left;">3107</td> <td style="text-align: left;">关单失败</td> </tr> <tr> <td style="text-align: left;">7000</td> <td style="text-align: left;">请调用查单接口</td> </tr> <tr> <td style="text-align: left;">7008</td> <td style="text-align: left;">短验发送失败/错误，请调用绑卡支付请求短验接口</td> </tr> <tr> <td style="text-align: left;">7009</td> <td style="text-align: left;">查无此绑卡记录，请提供准确的绑卡ID或者用户信息</td> </tr> <tr> <td style="text-align: left;">7999</td> <td style="text-align: left;">其他错误，交易失败</td> </tr> </tbody> </table>

聚合支付开放api

绑卡支付下单

页面列表