本地支付下单接口
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>本地钱包支付</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>https://localhost:8080/payment/gateway/api/backTransReq</code> 正式地址请联系技术索取</li>
</ul>
<h5>请求数据方式</h5>
<ul>
<li>post </li>
<li>x-www-form-urlencoded</li>
<li>金额单位：分</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;">requestNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>请求流水号</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>版本号，固定填：V1.0</td>
</tr>
<tr>
<td style="text-align: left;">productId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>产品类型，例如：GCASH，具体请看[[产品附录]][12]</td>
</tr>
<tr>
<td style="text-align: left;">transId</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>交易类型，固定值：38</td>
</tr>
<tr>
<td style="text-align: left;">signType</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名类型，固定值：MD5</td>
</tr>
<tr>
<td style="text-align: left;">merchantNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>clipspay分配的商户号</td>
</tr>
<tr>
<td style="text-align: left;">orderDate</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>订单申请日期yyyyMMdd</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>商户订单号，商户上送的流水号，商户号下唯一</td>
</tr>
<tr>
<td style="text-align: left;">terminalNo</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>clipspay分配的终端号</td>
</tr>
<tr>
<td style="text-align: left;">terNoSign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>clipspay分配的终端参数key</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>支付金额，单位分，例如：上送10 USD，实际订单单金额为0.1USD，（注意：巴基斯坦和韩国不能有小数金额，只能整数）</td>
</tr>
<tr>
<td style="text-align: left;">currencyCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>交易币种，规则：国际统一币种简称</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>异步通知地址，用于后台接收clipspay的最终结果</td>
</tr>
<tr>
<td style="text-align: left;">returnUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>同步接受地址，仅用于展示页面结果(兼容post, get接收参数)</td>
</tr>
<tr>
<td style="text-align: left;">shopUrl</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>网店交易网址，该网址必须在clipspay进行报备</td>
</tr>
<tr>
<td style="text-align: left;">ipAddress</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>支付时，持卡人所在的真实IP地址</td>
</tr>
<tr>
<td style="text-align: left;">billCountryCode</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>账单签收国家(国家代码简称，2位，大写)</td>
</tr>
<tr>
<td style="text-align: left;">billState</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>账单签收洲(省)</td>
</tr>
<tr>
<td style="text-align: left;">billCity</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>账单城市</td>
</tr>
<tr>
<td style="text-align: left;">billAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>账单详细地址</td>
</tr>
<tr>
<td style="text-align: left;">billZipCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>账单邮编</td>
</tr>
<tr>
<td style="text-align: left;">billfirstName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>持卡人名</td>
</tr>
<tr>
<td style="text-align: left;">billlastName</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>持卡人姓</td>
</tr>
<tr>
<td style="text-align: left;">billPhone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>持卡人电话</td>
</tr>
<tr>
<td style="text-align: left;">billEmail</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>持卡人邮箱</td>
</tr>
<tr>
<td style="text-align: left;">shippingCountryCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货国家(国家代码简称，2位，大写)</td>
</tr>
<tr>
<td style="text-align: left;">shippingState</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货州(省)</td>
</tr>
<tr>
<td style="text-align: left;">shippingCity</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货城市</td>
</tr>
<tr>
<td style="text-align: left;">shippingAddress</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货地址</td>
</tr>
<tr>
<td style="text-align: left;">shippingZipCode</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货地址邮编</td>
</tr>
<tr>
<td style="text-align: left;">shippingEmail</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货邮箱地址</td>
</tr>
<tr>
<td style="text-align: left;">shippingPhoneNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货人电话</td>
</tr>
<tr>
<td style="text-align: left;">shippingFirstName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货人名</td>
</tr>
<tr>
<td style="text-align: left;">shippingLastName</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>收货人姓</td>
</tr>
<tr>
<td style="text-align: left;">cardNo</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>卡号</td>
</tr>
<tr>
<td style="text-align: left;">expDate</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>信用卡有效期 MMYY</td>
</tr>
<tr>
<td style="text-align: left;">cvv</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>信用卡背面的cvv</td>
</tr>
<tr>
<td style="text-align: left;">district</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>区县，district, neighborhood, etc(Boleto必填)</td>
</tr>
<tr>
<td style="text-align: left;">street</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>街道，street name(Boleto必填)</td>
</tr>
<tr>
<td style="text-align: left;">number</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>门牌号，building number(Boleto必填)</td>
</tr>
<tr>
<td style="text-align: left;">cerdType</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>证件类型,暂时支持CPF或者CNPJ；没有则填CPF</td>
</tr>
<tr>
<td style="text-align: left;">cerdId</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>证件号码；示例：53033315550(Boleto,Gcash必填)</td>
</tr>
<tr>
<td style="text-align: left;">goodsJson</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>商品描述,示例：<code>[{&quot;goodsName&quot;:&quot;Socks&quot;,&quot;quantity&quot;:2,&quot;goodsPrice&quot;:15.2},{&quot;goodsName&quot;:&quot;Socks&quot;,&quot;quantity&quot;:2,&quot;goodsPrice&quot;:15.2}]</code></td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注，预留信息，随便填写</td>
</tr>
<tr>
<td style="text-align: left;">signature</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>验签字段</td>
</tr>
</tbody>
</table>
<h5>返回参数说明(注意返回参数要求动态接受，平台保留增加字段的可能性)</h5>
<table>
<thead>
<tr>
<th style="text-align: left;">参数名</th>
<th style="text-align: left;">类型</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">requestNo</td>
<td style="text-align: left;">string</td>
<td>交易请求流水号</td>
</tr>
<tr>
<td style="text-align: left;">version</td>
<td style="text-align: left;">string</td>
<td>版本号</td>
</tr>
<tr>
<td style="text-align: left;">merchantNo</td>
<td style="text-align: left;">string</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">orderDate</td>
<td style="text-align: left;">string</td>
<td>订单日期</td>
</tr>
<tr>
<td style="text-align: left;">orderNo</td>
<td style="text-align: left;">string</td>
<td>商户订单号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">string</td>
<td>支付金额，单位为分</td>
</tr>
<tr>
<td style="text-align: left;">respCode</td>
<td style="text-align: left;">string</td>
<td>应答码，P000或0000表示接收交易成功<br />该接口其他返回码表示失败</td>
</tr>
<tr>
<td style="text-align: left;">respDesc</td>
<td style="text-align: left;">string</td>
<td>错误描述</td>
</tr>
<tr>
<td style="text-align: left;">redirectUrl</td>
<td style="text-align: left;">string</td>
<td>收银台页面链接<strong>URLDecoder解码使用</strong> ,不存在时需解析formField</td>
</tr>
<tr>
<td style="text-align: left;">formField</td>
<td style="text-align: left;">string</td>
<td>本地钱包返回的二维码和条码信息，当respCode=P000有返回，示例：{"qrCode":"21899935300000090000010010928588801761932418","line":"21890010071092858880417619324183993530000009000"}，需要URLDecoder解码该字段使用,其中qrCode是条形码，line(Boleto有返回)是数字线，[boleto效果图](<a href="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=be4b09fb846b62fb6303e9c3b8ddb9a7">https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=be4b09fb846b62fb6303e9c3b8ddb9a7</a> "boleto效果图") 银行转帐信息示例：{"expirationTime": "2022-09-16 00:02:22 GMT-07:00","bankAccountInfo": {"bankCode": "332","beneficiaryName": "antonio silva","bankAccountNumber": "286435","bankAccountType": "CHECKING","bankBranchId": "0001","ispb": "13140088","document": {"documentId": "60131743007","type": "CPF"}}</td>
</tr>
<tr>
<td style="text-align: left;">signature</td>
<td style="text-align: left;">string</td>
<td>验签字段</td>
</tr>
</tbody>
</table>
<p>请求示例</p>
<pre><code class="language-json">{
&quot;amount&quot;: &quot;10&quot;,
&quot;billAddress&quot;: &quot;239 Indian River Rd,114&quot;,
&quot;billCity&quot;: &quot;Orange&quot;,
&quot;billCountryCode&quot;: &quot;US&quot;,
&quot;billEmail&quot;: &quot;earlhammiefdsadfsa2@qq.com&quot;,
&quot;billPhone&quot;: &quot;4752817435&quot;,
&quot;billState&quot;: &quot;CT&quot;,
&quot;billZipCode&quot;: &quot;06477&quot;,
&quot;billfirstName&quot;: &quot;Earl&quot;,
&quot;billlastName&quot;: &quot;Hammie&quot;,
&quot;currencyCode&quot;: &quot;USD&quot;,
&quot;district&quot;: &quot;Jardim Gaivotas&quot;,
&quot;goodsJson&quot;: &quot;[{\&quot;quantity\&quot;:1,\&quot;goodsPrice\&quot;:12.5,\&quot;goodsName\&quot;:\&quot;钢笔\&quot;}]&quot;,
&quot;ipAddress&quot;: &quot;127.0.0.1&quot;,
&quot;merchantNo&quot;: &quot;800440050942370&quot;,
&quot;notifyUrl&quot;: &quot;http://www.baidu.com&quot;,
&quot;number&quot;: &quot;15&quot;,
&quot;orderDate&quot;: &quot;20221220&quot;,
&quot;orderNo&quot;: &quot;R1671525061442&quot;,
&quot;productId&quot;: &quot;0119&quot;,
&quot;remark&quot;: &quot;remark&quot;,
&quot;requestNo&quot;: &quot;R1671525061442&quot;,
&quot;returnUrl&quot;: &quot;http://www.baidu.com&quot;,
&quot;shippingAddress&quot;: &quot;239 Indian River Rd,114&quot;,
&quot;shippingCity&quot;: &quot;Orange&quot;,
&quot;shippingCountryCode&quot;: &quot;US&quot;,
&quot;shippingEmail&quot;: &quot;earlhammiefdsadfsa2@qq.com&quot;,
&quot;shippingFirstName&quot;: &quot;Earl&quot;,
&quot;shippingLastName&quot;: &quot;Hammie&quot;,
&quot;shippingPhoneNo&quot;: &quot;4752817435&quot;,
&quot;shippingState&quot;: &quot;CT&quot;,
&quot;shippingZipCode&quot;: &quot;06477&quot;,
&quot;shopUrl&quot;: &quot;http://www.baidu.com&quot;,
&quot;signType&quot;: &quot;MD5&quot;,
&quot;signature&quot;: &quot;7675f20ba3fe9b783e457c1a91ff7847&quot;,
&quot;street&quot;: &quot;Rua 9 de setembro&quot;,
&quot;terNoSign&quot;: &quot;NzMyNGRmODk2NjhhNDlkZjkxZTBlNmQ4YThiMmE4ODA&quot;,
&quot;terminalNo&quot;: &quot;10000166&quot;,
&quot;transId&quot;: &quot;01&quot;,
&quot;version&quot;: &quot;V1.0&quot;
}</code></pre>
<h5>返回示例</h5>
<pre><code class="language-json">{
&quot;shippingCity&quot;: &quot;Orange&quot;,
&quot;redirectUrl&quot;: &quot;http://localhost:8080//payment_war_exploded/gateway/online/autoSubmit/2DCB867B5BEED69FAF04998E88573FF0&quot;,
&quot;goodsJson&quot;: &quot;[{\&quot;quantity\&quot;:1,\&quot;goodsPrice\&quot;:12.5,\&quot;goodsName\&quot;:\&quot;钢笔\&quot;}]&quot;,
&quot;signature&quot;: &quot;7125dff67fd654611a6b952d628231d8&quot;,
&quot;transId&quot;: &quot;01&quot;,
&quot;billState&quot;: &quot;CT&quot;,
&quot;shippingPhoneNo&quot;: &quot;4752817435&quot;,
&quot;remark&quot;: &quot;remark&quot;,
&quot;number&quot;: &quot;15&quot;,
&quot;billCountryCode&quot;: &quot;US&quot;,
&quot;billfirstName&quot;: &quot;Earl&quot;,
&quot;billZipCode&quot;: &quot;06477&quot;,
&quot;street&quot;: &quot;Rua 9 de setembro&quot;,
&quot;shippingZipCode&quot;: &quot;06477&quot;,
&quot;signType&quot;: &quot;MD5&quot;,
&quot;returnUrl&quot;: &quot;http://www.baidu.com&quot;,
&quot;billlastName&quot;: &quot;Hammie&quot;,
&quot;terminalNo&quot;: &quot;10000166&quot;,
&quot;amount&quot;: &quot;10&quot;,
&quot;respDesc&quot;: &quot;Success&quot;,
&quot;orderNo&quot;: &quot;R1671524630072&quot;,
&quot;terNoSign&quot;: &quot;NzMyNGRmODk2NjhhNDlkZjkxZTBlNmQ4YThiMmE4ODA&quot;,
&quot;productId&quot;: &quot;0119&quot;,
&quot;shippingLastName&quot;: &quot;Hammie&quot;,
&quot;tradeNo&quot;: &quot;100004129290&quot;,
&quot;ipAddress&quot;: &quot;127.0.0.1&quot;,
&quot;billCity&quot;: &quot;Orange&quot;,
&quot;requestNo&quot;: &quot;R1671524630072&quot;,
&quot;shopUrl&quot;: &quot;http://www.baidu.com&quot;,
&quot;version&quot;: &quot;V1.0&quot;,
&quot;shippingCountryCode&quot;: &quot;US&quot;,
&quot;billAddress&quot;: &quot;239 Indian River Rd,114&quot;,
&quot;billPhone&quot;: &quot;4752817435&quot;,
&quot;district&quot;: &quot;Jardim Gaivotas&quot;,
&quot;shippingFirstName&quot;: &quot;Earl&quot;,
&quot;notifyUrl&quot;: &quot;http://www.baidu.com&quot;,
&quot;shippingAddress&quot;: &quot;239 Indian River Rd,114&quot;,
&quot;shippingState&quot;: &quot;CT&quot;,
&quot;payId&quot;: &quot;100004203170&quot;,
&quot;currencyCode&quot;: &quot;USD&quot;,
&quot;orderDate&quot;: &quot;20221220&quot;,
&quot;respCode&quot;: &quot;0000&quot;,
&quot;merchantNo&quot;: &quot;800440050942370&quot;,
&quot;shippingEmail&quot;: &quot;earlhammiefdsadfsa2@qq.com&quot;
}</code></pre>
<h5>备注</h5>
<ul>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>
<p>[12]: <a href="https://www.showdoc.com.cn/clipspaywallet/10023769128254369">https://www.showdoc.com.cn/clipspaywallet/10023769128254369</a> "产品类型附录"</p>