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;">机构编码 <br><span style="color:#F00">示例:123456</span></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;">商户订单号,商户系统内部生成的订单号,需要保持在同一个商户下唯一<br><span style="color:#F00">示例: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;">订单金额 (单位:分)<br><span style="color:#F00">示例: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;">异步支付结果通知地址<br><span style="color:#F00"> 示例:<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二选一 <br> 参考:下方的银行列表,直联模式设置该参数后,直接调用支付工具,不显示易宝移动收银台页面。<br><span style="color:#F00"> 示例: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;">商品名称 ,<br> <span style="color:#F00">不支持特殊符号:英文的双引号""</span> <br><span style="color:#F00">示例: 网银</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;">校验账户信息,默认不校验账户信息 <br> 需要校验账户时上送该信息 <br>上送格式为JSON 格式字符串,定义如下{"accountName":"账户名称","mobilePhoneNo":"手机号","bankCardNo":"银行卡号"} <br><span style="color:#F00">示例:{"accountName":"微保科技","mobilePhoneNo":"13809809807","bankCardNo":"62284800000000000"}</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> <br><span style="color:#F00"> 示例: {"limitPayType":"EBANK_B2B"}</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分钟后失效 <br><span style="color:#F00"> 示例: 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;">支付成功后页面回调地址 <br>该值不为空的情况下,会在该值的基础上添加以下参数:customerNo=xxx&orderNo=xxx&platformSeq=xxx&platformSign=xxx<br><span style="color:#F00"> 示例:<a href="http://wx3.chinavbao.cn/api/order/returnurl/testpage?customerNo=202003260001&orderNo=TPB308806672618400&platformSeq=S1565230490330193921&platformSign=C18BAD8DC59D2A6BA31C29101BD0FBDD">http://wx3.chinavbao.cn/api/order/returnurl/testpage?customerNo=202003260001&orderNo=TPB308806672618400&platformSeq=S1565230490330193921&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;">分账订单标记 <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 style="text-align: left;">分账明细 <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 style="text-align: left;">分账通知地址 ,不传则不通知 <span style="color:#F00"> 示例: <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;">示例:"limitPayType":"YJZF,EBANK_B2B,BANK_TRANSFER_PAY"</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>{
&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;20220907000005&quot;,
&quot;customerNo&quot;: &quot;202112090603&quot;,
&quot;payUrl&quot;: &quot;https://cash.yeepay.com/cashier/std?sign=qUF1dNya099PNqcLLEKi1wpQKu0bRlxJPe2YRW0Yb1LsdHQmrg8NUeaPAJSPcUD1vQRqMUVNAZm3PCF8KEJd9rLP6PHgQcqtJ-6srW1ni72pdvcUl3GFDTgBg1BgZvJy9RLBfTjEnDQhKVUSgpJ0J5TFMSKyXzVzo1c16kSsPXIDZJO9aHAedHhmUSqULFd6citLKysXWqPqtC3VFGiW_iXoEvWaiha6HmANvi5GZRnxujOqZsT6pMoqhssMSLqCH7ymvqhJ0b3XhOQ875CuIUfm0_sdCZc_d_p6oqN0_AMlJQEQlH2SguL4i9tpCuhXjtQ0m1DVW1RxuCN_YHg2dA$SHA256&amp;appKey=app_10034054064&amp;merchantNo=10034054064&amp;token=6E7F1A3F600A717B8525472E2DC874D3AC05D32529FBCD4DDCB1D66CE09CD439&amp;timestamp=1662516493&amp;directPayType=&amp;cardType=&amp;userNo=&amp;userType=&amp;ext=null&quot;,
&quot;errCode&quot;: &quot;0000&quot;,
&quot;errMessage&quot;: &quot;成功&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>