聚合支付开放api


b2b/b2c/转账支付 创建订单

<h5>b2b/b2c/转账支付 创建订单接口</h5> <ul> <li>描述:获取支付URL</li> </ul> <h5>请求URL</h5> <ul> <li><code>/api/vborder/ebank/standard/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 style="text-align: left;">说明</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">orgCode</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(32)</td> <td style="text-align: left;">机构编码 &lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt;示例:123456&lt;/span&gt;</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 style="text-align: left;">商户订单号,商户系统内部生成的订单号,需要保持在同一个商户下唯一&lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt;示例:18348290098298292838</td> </tr> <tr> <td style="text-align: left;">orderAmount</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(11)</td> <td style="text-align: left;">订单金额 (单位:分)&lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt;示例:100</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 style="text-align: left;">异步支付结果通知地址&lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt; 示例:<a href="http://www.xxx.com/payCallback">http://www.xxx.com/payCallback</a></td> </tr> <tr> <td style="text-align: left;">directPayType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(11)</td> <td style="text-align: left;">网银支付时通道编码可参考网银直直联参数,不传值时显示全产品(B2B/B2C/转账支付),当控制页面显示时,和扩展参数中的limitPayType二选一 &lt;br&gt; 参考:下方的银行列表,直联模式设置该参数后,直接调用支付工具,不显示易宝移动收银台页面。&lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt; 示例:EBANK_B2C</td> </tr> <tr> <td style="text-align: left;">goodName</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(64)</td> <td style="text-align: left;">商品名称 ,&lt;br&gt; &lt;span style=&quot;color:#F00&quot;&gt;不支持特殊符号:英文的双引号&quot;&quot;&lt;/span&gt; &lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt;示例: 网银</td> </tr> <tr> <td style="text-align: left;">realName</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td style="text-align: left;">校验账户信息,默认不校验账户信息 &lt;br&gt; 需要校验账户时上送该信息 &lt;br&gt;上送格式为JSON 格式字符串,定义如下{&quot;accountName&quot;:&quot;账户名称&quot;,&quot;mobilePhoneNo&quot;:&quot;手机号&quot;,&quot;bankCardNo&quot;:&quot;银行卡号&quot;} &lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt;示例:{&quot;accountName&quot;:&quot;微保科技&quot;,&quot;mobilePhoneNo&quot;:&quot;13809809807&quot;,&quot;bankCardNo&quot;:&quot;62284800000000000&quot;}</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 style="text-align: left;">扩展参数,格式为json,原样返回,<strong>见下面参数说明</strong> &lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt; 示例: {&quot;limitPayType&quot;:&quot;EBANK_B2B&quot;}</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 style="text-align: left;">附加数据,在通知中原样返回</td> </tr> <tr> <td style="text-align: left;">expiredTime</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String</td> <td style="text-align: left;">订单超时时间订单过期时间,格式为yyyy-MM-dd HH:mm:ss,为空时默认在请求下单120分钟后失效 &lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt; 示例: 2022-09-07 12:32:00</td> </tr> <tr> <td style="text-align: left;">returnUrl</td> <td style="text-align: left;">否</td> <td style="text-align: left;">String(256)</td> <td style="text-align: left;">支付成功后页面回调地址 &lt;br&gt;该值不为空的情况下,会在该值的基础上添加以下参数:customerNo=xxx&amp;orderNo=xxx&amp;platformSeq=xxx&amp;platformSign=xxx&lt;br&gt;&lt;span style=&quot;color:#F00&quot;&gt; 示例:<a href="http://wx3.chinavbao.cn/api/order/returnurl/testpage?customerNo=202003260001&amp;orderNo=TPB308806672618400&amp;platformSeq=S1565230490330193921&amp;platformSign=C18BAD8DC59D2A6BA31C29101BD0FBDD">http://wx3.chinavbao.cn/api/order/returnurl/testpage?customerNo=202003260001&amp;orderNo=TPB308806672618400&amp;platformSeq=S1565230490330193921&amp;platformSign=C18BAD8DC59D2A6BA31C29101BD0FBDD</a></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 style="text-align: left;">分账订单标记 &lt;br&gt;DELAY_SETTLE:需要分账&lt;br&gt;REAL_TIME:不需要分账&lt;br&gt;REAL_TIME_DIVIDE:实时分账;需同时传入divideDetail 不上送默认不需要分账 &lt;span style=&quot;color:#F00&quot;&gt; 示例: 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 style="text-align: left;">分账明细 &lt;br&gt;divideType为实时分账时,必传。JSON格式:&lt;br&gt;divideRecvCustomerNo:分账接收方&lt;br&gt;divideAmount:分账金额 &lt;br&gt;detailCustomerSeq:分账明细单号&lt;br&gt;divideDesc:分账描述 &lt;span style=&quot;color:#F00&quot;&gt; 示例: [{&quot;detailCustomerSeq&quot;:&quot;20240403000001&quot;,&quot;divideDesc&quot;:&quot;分账&quot;,&quot;divideRecvCustomerNo&quot;:&quot;0000000002&quot;,&quot;divideAmount&quot;:&quot;2&quot;}]</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 style="text-align: left;">分账通知地址 ,不传则不通知 &lt;span style=&quot;color:#F00&quot;&gt; 示例: <a href="https://notify.com/xxx">https://notify.com/xxx</a></td> </tr> </tbody> </table> <h5>ext1扩展参数如下</h5> <p><em>注:(显示控制:limitPayType和上面的参数directPayType只能二选一)</em></p> <table> <thead> <tr> <th style="text-align: left;">参数名</th> <th style="text-align: left;">必选</th> <th style="text-align: left;">类型</th> <th>说明</th> <th style="text-align: left;">示例</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">limitPayType</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string(128)</td> <td>页面只展示指定的支付方式,可展示一种或多种支付方式:WECHAT 微信,ALIPAY 支付宝,(聚合扫码支付要同时传微信和支付宝)EBANK_B2B 网银B2B,EBANK_B2C 网银B2C,BANK_TRANSFER_PAY 银行转账支付</td> <td style="text-align: left;">示例:&quot;limitPayType&quot;:&quot;YJZF,EBANK_B2B,BANK_TRANSFER_PAY&quot;</td> </tr> <tr> <td style="text-align: left;">reCreateOrder</td> <td style="text-align: left;">否</td> <td style="text-align: left;">string(128)</td> <td>网银支付下单默认返回第一次下单生成的链接,如需要去渠道重新下单,可上传该参数, true:重新下单</td> <td style="text-align: left;">true</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>商户号</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>商户订单号</td> </tr> <tr> <td style="text-align: left;">payUrl</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(256)</td> <td>支付链接</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>错误编码</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>错误描述</td> </tr> </tbody> </table> <h5>返回示例</h5> <pre><code>{     &amp;quot;code&amp;quot;:&amp;quot;200&amp;quot;,     &amp;quot;success&amp;quot;:true,     &amp;quot;data&amp;quot;:&amp;quot;{\&amp;quot;customerNo\&amp;quot;:\&amp;quot;202112090603\&amp;quot;,\&amp;quot;reqmsg\&amp;quot;:\&amp;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\&amp;quot;}&amp;quot;,     &amp;quot;msg&amp;quot;:&amp;quot;操作成功&amp;quot; } reqmsg明文: { &amp;quot;orderNo&amp;quot;: &amp;quot;20220907000005&amp;quot;, &amp;quot;customerNo&amp;quot;: &amp;quot;202112090603&amp;quot;, &amp;quot;payUrl&amp;quot;: &amp;quot;https://cash.yeepay.com/cashier/std?sign=qUF1dNya099PNqcLLEKi1wpQKu0bRlxJPe2YRW0Yb1LsdHQmrg8NUeaPAJSPcUD1vQRqMUVNAZm3PCF8KEJd9rLP6PHgQcqtJ-6srW1ni72pdvcUl3GFDTgBg1BgZvJy9RLBfTjEnDQhKVUSgpJ0J5TFMSKyXzVzo1c16kSsPXIDZJO9aHAedHhmUSqULFd6citLKysXWqPqtC3VFGiW_iXoEvWaiha6HmANvi5GZRnxujOqZsT6pMoqhssMSLqCH7ymvqhJ0b3XhOQ875CuIUfm0_sdCZc_d_p6oqN0_AMlJQEQlH2SguL4i9tpCuhXjtQ0m1DVW1RxuCN_YHg2dA$SHA256&amp;amp;appKey=app_10034054064&amp;amp;merchantNo=10034054064&amp;amp;token=6E7F1A3F600A717B8525472E2DC874D3AC05D32529FBCD4DDCB1D66CE09CD439&amp;amp;timestamp=1662516493&amp;amp;directPayType=&amp;amp;cardType=&amp;amp;userNo=&amp;amp;userType=&amp;amp;ext=null&amp;quot;, &amp;quot;errCode&amp;quot;: &amp;quot;0000&amp;quot;, &amp;quot;errMessage&amp;quot;: &amp;quot;成功&amp;quot; }</code></pre> <h5>收银台页面重定向</h5> <h6>收银台支付后,会重定向到商户指定页面,重定向时候参数如下,下单接口请求参数 returnUrl 传入接收页面回调地址。</h6> <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>商户号</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>商户订单号</td> </tr> <tr> <td style="text-align: left;">platformSeq</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(256)</td> <td>平台流水号</td> </tr> <tr> <td style="text-align: left;">platformSign</td> <td style="text-align: left;">是</td> <td style="text-align: left;">String(32)</td> <td>签名</td> </tr> </tbody> </table> <h5>具体支持银行列表</h5> <table> <thead> <tr> <th style="text-align: left;">银行名称</th> <th style="text-align: left;">通道编码 – B2C</th> <th style="text-align: left;">通道编码 – B2B</th> </tr> </thead> <tbody> <tr> <td style="text-align: left;">工商银行</td> <td style="text-align: left;">ICBC_B2C</td> <td style="text-align: left;">ICBC_B2B</td> </tr> <tr> <td style="text-align: left;">招商银行</td> <td style="text-align: left;">CMBCHINA_B2C</td> <td style="text-align: left;">CMBCHINA_B2B</td> </tr> <tr> <td style="text-align: left;">建设银行</td> <td style="text-align: left;">CCB_B2C</td> <td style="text-align: left;">CCB_B2B</td> </tr> <tr> <td style="text-align: left;">兴业银行</td> <td style="text-align: left;">CIB_B2C</td> <td style="text-align: left;">CIB_B2B</td> </tr> <tr> <td style="text-align: left;">民生银行</td> <td style="text-align: left;">CMBC_B2C</td> <td style="text-align: left;">CMBC_B2B</td> </tr> <tr> <td style="text-align: left;">光大银行</td> <td style="text-align: left;">CEB_B2C</td> <td style="text-align: left;">CEB_B2B</td> </tr> <tr> <td style="text-align: left;">中国银行</td> <td style="text-align: left;">BOC_B2C</td> <td style="text-align: left;">BOC_B2B</td> </tr> <tr> <td style="text-align: left;">平安银行</td> <td style="text-align: left;">SZPA_B2C</td> <td style="text-align: left;">SZPA_B2B</td> </tr> <tr> <td style="text-align: left;">中信银行</td> <td style="text-align: left;">ECITIC_B2C</td> <td style="text-align: left;">ECITIC_B2B</td> </tr> <tr> <td style="text-align: left;">上海银行</td> <td style="text-align: left;">SHB_B2C</td> <td style="text-align: left;">SHB_B2B</td> </tr> <tr> <td style="text-align: left;">上海浦东发展银行</td> <td style="text-align: left;">SPDB_B2C</td> <td style="text-align: left;">SPDB_B2B</td> </tr> <tr> <td style="text-align: left;">华夏银行</td> <td style="text-align: left;">HXB_B2C</td> <td style="text-align: left;">HXB_B2B</td> </tr> <tr> <td style="text-align: left;">北京银行</td> <td style="text-align: left;">BCCB_B2C</td> <td style="text-align: left;">BCCB_B2B</td> </tr> <tr> <td style="text-align: left;">中国农业银行</td> <td style="text-align: left;">ABC_B2C</td> <td style="text-align: left;">ABC_B2B</td> </tr> <tr> <td style="text-align: left;">中国邮政储蓄银行</td> <td style="text-align: left;">PSBC_B2C</td> <td style="text-align: left;">PSBC_B2B</td> </tr> <tr> <td style="text-align: left;">徽商银行</td> <td style="text-align: left;">HSB_B2C</td> <td style="text-align: left;">HSB_B2B</td> </tr> <tr> <td style="text-align: left;">青岛银行</td> <td style="text-align: left;">不支持</td> <td style="text-align: left;">QDYH_B2B</td> </tr> <tr> <td style="text-align: left;">浙商银行</td> <td style="text-align: left;">CZ_B2C</td> <td style="text-align: left;">CZ_B2B</td> </tr> <tr> <td style="text-align: left;">齐鲁银行</td> <td style="text-align: left;">QLYH_B2C</td> <td style="text-align: left;">QLYH_B2B</td> </tr> <tr> <td style="text-align: left;">晋商银行</td> <td style="text-align: left;">JSHB_B2C</td> <td style="text-align: left;">不支持</td> </tr> <tr> <td style="text-align: left;">莱商银行</td> <td style="text-align: left;">不支持</td> <td style="text-align: left;">ISBC-B2B</td> </tr> <tr> <td style="text-align: left;">厦门银行</td> <td style="text-align: left;">不支持</td> <td style="text-align: left;">XMCCB_B2B</td> </tr> </tbody> </table> <p>在标准收银台接口 directPayType 参数中传入以下直连编码,按需显示收银台对应的网银支付方式。</p> <table> <thead> <tr> <th>参数</th> <th>说明</th> </tr> </thead> <tbody> <tr> <td>EBANK_B2B</td> <td>收银台只展示网银支付模块且只展示B2B</td> </tr> <tr> <td>EBANK_B2C</td> <td>收银台只展示网银支付模块且只展示B2C</td> </tr> <tr> <td>EBANK</td> <td>收银台只展示网银支付模块,包含B2B、B2C</td> </tr> </tbody> </table>

页面列表

ITEM_HTML