支付下单
<ul>
<li>商户业务系统通过支付下单接口发起支付收款订单。</li>
</ul>
<h4>请求URL</h4>
<ul>
<li><code>https://live.dreamo9.com/api/payment</code></li>
</ul>
<h4>请求方式</h4>
<ul>
<li><code>POST</code></li>
</ul>
<h4>请求类型</h4>
<ul>
<li><code>application/json</code></li>
</ul>
<h4>测试说明</h4>
<p><font color="red"> 1、测试环境 "amount"金额中包含 数字[ 3 支付失败]，[2 支付成功]，系统会自动回调相应状态。</br>
2、针对孟加拉BDT >> 金额中包含这[73 部分支付]包含[83 超额支付]系统自动回调对应的支付状态</font></p>
<h4>参数</h4>
<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 style="text-align: left;">示例值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">mchNo</td>
<td style="text-align: left;">商户号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td style="text-align: left;">M1234567890</td>
<td>商户号</td>
</tr>
<tr>
<td style="text-align: left;">appId</td>
<td style="text-align: left;">应用ID</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td style="text-align: left;">60cc09bce4b0f1c0b83761c9</td>
<td>应用ID</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">商户订单号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td style="text-align: left;">202205101000000000</td>
<td>商户生成的订单号</td>
</tr>
<tr>
<td style="text-align: left;">amount</td>
<td style="text-align: left;">支付金额</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">10000</td>
<td>单位: 分</td>
</tr>
<tr>
<td style="text-align: left;">currency</td>
<td style="text-align: left;">货币代码</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td style="text-align: left;">INR</td>
<td>货币代码: </br>INR: 印度卢比 </br>BRL: 巴西雷亚儿</br>PKR: 巴基斯坦卢比</br>MXN: 墨西哥比索</br><a href="https://www.showdoc.com.cn/dreamo9/10967762154473017">更多支持币种参见全局/国家币种</a></td>
</tr>
<tr>
<td style="text-align: left;">clientIp</td>
<td style="text-align: left;">客户端IP</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(16)</td>
<td style="text-align: left;">61.73.10.150</td>
<td>客户端 IPV4 地址</td>
</tr>
<tr>
<td style="text-align: left;">uid</td>
<td style="text-align: left;">客户id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td style="text-align: left;">u9999</td>
<td><font color="red">必填该字段</font>，保证一个uid只对应一个用户</td>
</tr>
<tr>
<td style="text-align: left;">customerName</td>
<td style="text-align: left;">客户姓名</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td style="text-align: left;">Nitin Gadge</td>
<td>客户姓名 <code>细节详见下方 tips</code></td>
</tr>
<tr>
<td style="text-align: left;">customerEmail</td>
<td style="text-align: left;">客户邮箱</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td style="text-align: left;">Nitin198483@gmail.com</td>
<td>客户邮箱</td>
</tr>
<tr>
<td style="text-align: left;">customerPhone</td>
<td style="text-align: left;">客户手机号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(64)</td>
<td style="text-align: left;">8197220658</td>
<td>客户手机号 10 位</td>
</tr>
<tr>
<td style="text-align: left;">notifyUrl</td>
<td style="text-align: left;">异步通知地址</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(128)</td>
<td style="text-align: left;"><a href="https://test/notify.html">https://test/notify.html</a></td>
<td>支付结果异步回调URL,只有传了该值才会发起回调</td>
</tr>
<tr>
<td style="text-align: left;">returnUrl</td>
<td style="text-align: left;">跳转通知地址</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(128)</td>
<td style="text-align: left;"><a href="https://test/return.html">https://test/return.html</a></td>
<td>支付结果同步跳转通知URL</td>
</tr>
<tr>
<td style="text-align: left;">expiredTime</td>
<td style="text-align: left;">订单关单时间</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td style="text-align: left;">3600</td>
<td>单位: 秒,巴西地区默认30分钟，商户可自定义关单时间</br>订单在(创建时间 + 失效时间)后关单，订单状态为失败。</td>
</tr>
<tr>
<td style="text-align: left;">extParam</td>
<td style="text-align: left;">商户扩展参数</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td style="text-align: left;">1234567890</td>
<td>例{\"test\":\"payin\"}</td>
</tr>
<tr>
<td style="text-align: left;">channelExtra</td>
<td style="text-align: left;">渠道扩展参数</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(512)</td>
<td style="text-align: left;">支付方式类型 <font color="red">示例</font></br>{"payType":"xx"}</td>
<td>指定支付方式<font color="red">必填该字段</font></br> payType 对应支付枚举值参考下方细节<code>详见 tips</code>↓</td>
</tr>
<tr>
<td style="text-align: left;">reqTime</td>
<td style="text-align: left;">请求时间</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">long</td>
<td style="text-align: left;">1652148000000</td>
<td>请求接口时间,13位毫秒时间戳</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">签名</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td style="text-align: left;">4F5914CE3E1B31DAA230B4E2FCD9524B</td>
<td><code>详见签名算法</code></td>
</tr>
</tbody>
</table>
<h4>请求示例</h4>
<pre><code>印度示例
{
&quot;amount&quot;: 10000,
&quot;mchOrderNo&quot;: &quot;test_20241112152533&quot;,
&quot;sign&quot;: &quot;BF156A53E6BA969A9B56346C5BDB0849&quot;,
&quot;reqTime&quot;: 1731396333145,
&quot;customerName&quot;: &quot;ctiy&quot;,
&quot;uid&quot;: &quot;Uid_001&quot;,
&quot;customerPhone&quot;: &quot;8197220658&quot;,
&quot;appId&quot;: &quot;A7890111&quot;,
&quot;customerEmail&quot;: &quot;ctiy@gmail.com&quot;,
&quot;clientIp&quot;: &quot;14.145.53.145&quot;,
&quot;notifyUrl&quot;: &quot;http://googe.com&quot;,
&quot;currency&quot;: &quot;INR&quot;,
&quot;mchNo&quot;: &quot;M17189001&quot;
}
巴西示例
{
&quot;amount&quot;: 98000,
&quot;appId&quot;: &quot;A111312&quot;,
&quot;clientIp&quot;: &quot;122.176.45.89&quot;,
&quot;currency&quot;: &quot;BRL&quot;,
&quot;uid&quot;: &quot;A999&quot;,
&quot;customerEmail&quot;: &quot;9540103760@gmail.com&quot;,
&quot;customerName&quot;: &quot;test david&quot;,
&quot;customerPhone&quot;: &quot;7421362880&quot;,
&quot;mchNo&quot;: &quot;M1154368114&quot;,
&quot;mchOrderNo&quot;: &quot;100202547101542333103&quot;,
&quot;notifyUrl&quot;: &quot;https://www.example.com&quot;,
&quot;channelExtra&quot;: &quot;{\&quot;document\&quot;:\&quot;94871989040\&quot;}&quot;,
&quot;reqTime&quot;: 1720597053853,
&quot;sign&quot;: &quot;2ED2v8418F3B6D7P37M7594C3F94EC84&quot;
}
沙特示例
{
&quot;amount&quot;: 5000,
&quot;appId&quot;: &quot;A111312&quot;,
&quot;clientIp&quot;: &quot;122.176.45.89&quot;,
&quot;currency&quot;: &quot;SAR&quot;,
&quot;customerEmail&quot;: &quot;9540103760@gmail.com&quot;,
&quot;customerName&quot;: &quot;david&quot;,
&quot;customerPhone&quot;: &quot;7421362880&quot;,
&quot;uid&quot;: &quot;C12345&quot;,
&quot;mchNo&quot;: &quot;M1154368114&quot;,
&quot;mchOrderNo&quot;: &quot;100202547101542333103&quot;,
&quot;channelExtra&quot;: &quot;{\&quot;payType\&quot;:\&quot;GLOBAL_CARD\&quot;}&quot;,//其他类型支付则对应文档中枚举值
&quot;notifyUrl&quot;: &quot;https://www.example.com&quot;,
&quot;reqTime&quot;: 1720597053853,
&quot;sign&quot;: &quot;2ED2v8418F3B6D7P37M7594C3F94EC95&quot;
}</code></pre>
<h4>返回参数说明</h4>
<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>int</td>
<td>0</td>
<td>0: 成功 其他: 失败</br><code>详见错误码</code></td>
</tr>
<tr>
<td>返回信息</td>
<td>msg</td>
<td>否</td>
<td>String(128)</td>
<td>签名失败</td>
<td>具体错误原因</br>例如：签名失败、参数格式校验错误</td>
</tr>
<tr>
<td>签名信息</td>
<td>sign</td>
<td>否</td>
<td>String(32)</td>
<td>1F0A241B0349894B0C8D68BE0CB40EE1</td>
<td>对data内数据签名，如data为空则不返回</td>
</tr>
<tr>
<td>返回数据</td>
<td>data</td>
<td>否</td>
<td>String(512)</td>
<td>{}</td>
<td>指定返回数据，json格式数据</td>
</tr>
</tbody>
</table>
<h5>data数据格式</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;">payOrderId</td>
<td style="text-align: left;">支付订单号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>P202205101000111111</td>
<td>支付系统订单号</td>
</tr>
<tr>
<td style="text-align: left;">mchOrderNo</td>
<td style="text-align: left;">商户订单号</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String(32)</td>
<td>202205101000000000</td>
<td>商户传入的订单号</td>
</tr>
<tr>
<td style="text-align: left;">orderState</td>
<td style="text-align: left;">订单状态</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">int</td>
<td>1</td>
<td>订单支付状态</br>0: 订单生成<br/>1: 支付中<br/>2: 支付成功</br>3: 支付失败 </br>7:部分支付</br>8:超额支付</td>
<td>7/8订单状态只针对孟加拉</br>其他国家可忽略</td>
</tr>
<tr>
<td style="text-align: left;">payDataType</td>
<td style="text-align: left;">支付数据类型</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">String</td>
<td>payUrl</td>
<td>支付参数类型<br/>payUrl: 跳转链接的方式<br/>form: 表单方式<br/>codeUrl: 二维码地址<br/>codeImgUrl: 二维码图片地址<br/>none: 空支付参数</td>
</tr>
<tr>
<td style="text-align: left;">upiUrl</td>
<td style="text-align: left;">DeepLink</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String(128)</td>
<td>pa=xxx@x&pn=x&tr=xxxx&mc=1234562&am=100.00&cu=INR&tn=x&mam=100.0</td>
<td>深度唤起链接,用法见目录DeepLink详细说明</td>
</tr>
<tr>
<td style="text-align: left;">payData</td>
<td style="text-align: left;">支付数据</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td><a href="https://test/pay.html">https://test/pay.html</a></td>
<td>发起支付用到的支付参数</td>
</tr>
<tr>
<td style="text-align: left;">pixCode</td>
<td style="text-align: left;">pix 支付代码</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>00020126920014br.gov.bcb.pix2570qrcodes.sulcredi.coop.br/v2/v3/at/49349954-d53f-4e77-b681-41202c844d255204000053039865802BR5922ARKPAGO LTDA6009SAO PAULO62070503***63049101</td>
<td>pix 支付时使用到的支付代码</td>
</tr>
<tr>
<td style="text-align: left;">qrCode</td>
<td style="text-align: left;">pix的qr代码</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>00020126920014br.gov.bcb.pix2570qrcodes.sulcredi.coop.br/v2/v3/at/49349954-d53f-4e77-b681-41202c844d255204000053039865802BR5922ARKPAGO LTDA6009SAO PAULO62070503***63049101</td>
<td>pix 支付时使用到的二维码代码，可转成二维码</td>
</tr>
<tr>
<td style="text-align: left;">errCode</td>
<td style="text-align: left;">上游错误码</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>ACQ.PAYMENT_AUTH_CODE_INVALID</td>
<td>上游渠道返回的错误码</td>
</tr>
<tr>
<td style="text-align: left;">errMsg</td>
<td style="text-align: left;">上游错误描述</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">String</td>
<td>Business Failed 失败</td>
<td>上游渠道返回的错误描述</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code>{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;errCode&quot;: &quot;ACQ.PAYMENT_AUTH_CODE_INVALID&quot;,
&quot;errMsg&quot;: &quot;Business Failed【支付失败，获取顾客账户信息失败，请顾客刷新付款码后重新收款，如再次收款失败，请联系管理员处理。[SOUNDWAVE_PARSER_FAIL]】&quot;,
&quot;mchOrderNo&quot;: &quot;mho1234567890&quot;,
&quot;orderState&quot;: 3,
&quot;payOrderId&quot;: &quot;P202205101000111111&quot;
},
&quot;msg&quot;: &quot;SUCCESS&quot;,
&quot;sign&quot;: &quot;1F0A241B0349894B0C8D68BE0CB40EE1&quot;
}
{
&quot;code&quot;: 0,
&quot;data&quot;: {
&quot;mchOrderNo&quot;: &quot;20240510202405103&quot;,
&quot;orderState&quot;: 1,
&quot;payData&quot;: &quot;https://example.com?orderNo=PI-0512143579169782991392777&quot;,
&quot;payDataType&quot;: &quot;payUrl&quot;,
&quot;payOrderId&quot;: &quot;P1789584890222526466&quot;,
&quot;upiUrl&quot;: &quot;pa=xxx@x&amp;pn=x&amp;tr=xxxx&amp;mc=1234562&amp;am=100.00&amp;cu=INR&amp;tn=x&amp;mam=100.0&quot;
},
&quot;msg&quot;: &quot;SUCCESS&quot;,
&quot;sign&quot;: &quot;1D3397A6B16719BB0D123D5AAFA8431A&quot;
}</code></pre>
<h2>收款单笔限额</h2>
<table>
<thead>
<tr>
<th>国家/地区</th>
<th>支付方式</th>
<th>说明</th>
<th>代收最小额(元)</th>
<th>代收最大额(元)</th>
<th>退款</th>
</tr>
</thead>
<tbody>
<tr>
<td>BRL</td>
<td>PAGBANK</td>
<td></td>
<td>1 BRL</td>
<td>40000 BRL</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>BRL</td>
<td>PAYPAL</td>
<td></td>
<td>1 BRL</td>
<td>40000 BRL</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>BRL</td>
<td>PIX</td>
<td>巴西PIX支付</td>
<td>1 BRL</td>
<td>20,000 BRL</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>INR</td>
<td>UPI</td>
<td>印度UPI支付</td>
<td>50 INR</td>
<td>50,000 INR</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>PKR</td>
<td>Ewallet</td>
<td>巴基斯坦电子钱包支付:Easypaisa、JazzCash</td>
<td>100 PKR</td>
<td>50,000 PKR</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>MXN</td>
<td>Banktransfer</td>
<td>（SPEI 转账付款）</td>
<td>1 MXN</td>
<td>50000.00 MXN</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>MXN</td>
<td>PAYPAL</td>
<td>PAYPAL</td>
<td>1 MXN</td>
<td>7400000.00 MXN</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>PE</td>
<td>ewallet</td>
<td>秘鲁电子钱包</td>
<td>1 PEN</td>
<td>340000 PEN</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>PE</td>
<td>银行转账(checkout)</td>
<td>银行转账</td>
<td>10 PEN</td>
<td>10000 PEN</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>SAR Global</td>
<td>credit card debit card</td>
<td>卡支付，支持地区有沙特、阿联酋、科威特、卡塔尔、阿曼、巴林；支持卡品牌 visa、MasterCard、AMEX，沙特支持本地 mada 卡，科威特地区支持 KNET 卡</td>
<td>0.1 本地币</td>
<td>5000 本地币</td>
<td>沙特支持全额原路退款</td>
</tr>
<tr>
<td>AED</td>
<td>阿联酋APPLE、Global</td>
<td>阿联酋APPLE、Global支付</td>
<td>1 AED</td>
<td>5000 AED</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>SAR</td>
<td>STC</td>
<td>沙特 wallet STC 钱包支付</td>
<td>0.1 SAR</td>
<td>10,000 SAR</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>SAR</td>
<td>APPLE</td>
<td>沙特APPLE</td>
<td>1 SAR</td>
<td>5000 SAR</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>COP</td>
<td>PSE、PAYPAL</td>
<td>哥伦比亚银行转账</td>
<td>1 COP</td>
<td>38000000.00 COP</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>COP</td>
<td>credit_card</td>
<td>哥伦比亚银行转账</td>
<td>1 COP</td>
<td>38000000.00 COP</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>COP</td>
<td>CO_NEQUI</td>
<td>哥伦比亚银行转账</td>
<td>5000 COP</td>
<td>38000000.00 COP</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>TRY</td>
<td>Wallet</td>
<td>Gpay 钱包</td>
<td>1 TRY</td>
<td>500,000TRY</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>TRY</td>
<td>Wallet</td>
<td>BKM Express 钱包</td>
<td>1 TRY</td>
<td>8,500 TRY</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>TRY</td>
<td>Prepaid Card</td>
<td>EPin 预付卡</td>
<td>1 TRY</td>
<td>500,000 TRY</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>TRY</td>
<td>Prepaid Card</td>
<td>Ininal 预付卡</td>
<td>1 TRY</td>
<td>100,000 TRY</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>TRY</td>
<td>Transfer</td>
<td>Transfer 银行转账</td>
<td>1 TRY</td>
<td>50,000 TRY</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>TRY</td>
<td>Card</td>
<td>visa,MasterCard,AMEX,Toy本地卡组</td>
<td>1 TRY</td>
<td>90,000 TRY</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>BDT</td>
<td>Wallet</td>
<td>孟加拉电子钱包 Bkash,Nagad,Rocket</td>
<td>200 BDT</td>
<td>50,000 BDT</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>PHP</td>
<td>Wallet</td>
<td>菲律宾电子钱包 GCASH</td>
<td>200 PHP</td>
<td>50,000 PHP</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>IDR</td>
<td>Wallet</td>
<td>印尼DANA 钱包</td>
<td>1 IDR</td>
<td>100,000 IDR</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>CLP</td>
<td>其他</td>
<td>智利</td>
<td>1000 CLP</td>
<td>5000000 CLP</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>CLP</td>
<td>PayPal</td>
<td>智利</td>
<td>100 CLP</td>
<td>5000000 CLP</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>USD</td>
<td>PayPal</td>
<td>美国</td>
<td>100 USD</td>
<td>99999999 USD</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>EGP</td>
<td>E-wallet</td>
<td>埃及</td>
<td>5EGP</td>
<td>20000 EGP</td>
<td>不支持原路退款</td>
</tr>
<tr>
<td>EGP</td>
<td>Fawry</td>
<td>埃及</td>
<td>10EGP</td>
<td>100000 EGP</td>
<td>不支持原路退款</td>
</tr>
</tbody>
</table>
<h1>Tips：</h1>
<h3>巴西</h3>
<p>巴西参数
customerName：格式firstName+lastName 需要中间有空格 规则 1-50个字符 支付英文、葡语、支持空格、不支持特殊字符/数字</p>
<p>1、使用dreamo收银台无需传递参数 document(税号) 只携带支付类型type对应枚举值即可,</p>
<p><strong>支付方式类型</strong></p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>PIX</td>
<td>PIX</td>
</tr>
<tr>
<td>PAGBANK</td>
<td>PAGBANK</td>
</tr>
</tbody>
</table>
<p>示例参考</p>
<pre><code class="language-java">channelExtra: &quot;{\&quot;payType\&quot;:\&quot;PIX\&quot;}&quot;</code></pre>
<p>2、使用自建收银台需传递支付类型type和真实document(税号)枚举值,</p>
<p><strong>支付方式类型</strong>
示例参考</p>
<pre><code class="language-java">channelExtra: &quot;{\&quot;payType\&quot;:\&quot;PIX\&quot;,\&quot;document\&quot;:\&quot;94871989040\&quot;}&quot;</code></pre>
<table>
<thead>
<tr>
<th>巴西传参</th>
<th>税号 (CPF 11位/CNPJ 14位</th>
</tr>
</thead>
<tbody>
<tr>
<td>document</td>
<td>94871989040</td>
</tr>
</tbody>
</table>
<hr />
<h4>巴西 PAYPAL</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>电子钱包</td>
<td>PAYPAL</td>
</tr>
</tbody>
</table>
<h4>沙特</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>沙特STC</td>
<td>SA_STC</td>
</tr>
<tr>
<td>沙特指定卡支付</td>
<td>GLOBAL_CARD</td>
</tr>
<tr>
<td>沙特APPLE</td>
<td>APPLE</td>
</tr>
</tbody>
</table>
<h4>阿联酋</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>阿联酋APPLE</td>
<td>APPLE</td>
</tr>
<tr>
<td>阿联酋指定卡支付</td>
<td>GLOBAL_CARD</td>
</tr>
</tbody>
</table>
<h4>土耳其</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>Gpay 钱包</td>
<td>TR_GPAY</td>
</tr>
<tr>
<td>BKM Express 钱包</td>
<td>TR_BKM_EXPRESS</td>
</tr>
<tr>
<td>EPin 预付卡</td>
<td>TR_EPIN (不推荐)</td>
</tr>
<tr>
<td>Ininal 预付卡</td>
<td>TR_ININAL (暂停)</td>
</tr>
<tr>
<td>卡支付visa,MasterCard,AMEX,Troy本地卡组</td>
<td>GLOBAL_CARD</td>
</tr>
<tr>
<td>银行转账</td>
<td>TRANSFER</td>
</tr>
<tr>
<td>paparaWALLET</td>
<td>TR_PAPARA_WALLET</td>
</tr>
<tr>
<td>paparaCard</td>
<td>TR_PAPARA_CARD</td>
</tr>
<tr>
<td>VA</td>
<td>VA</td>
</tr>
</tbody>
</table>
<h4>孟加拉</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。
注意：孟加拉支付会出现部分支付/超额支付状态、请查看status</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>电子钱包Bkash</td>
<td>BD_BKASH</td>
</tr>
<tr>
<td>电子钱包Nagad</td>
<td>BD_NAGAD</td>
</tr>
</tbody>
</table>
<h4>巴基斯坦</h4>
<p>JAZZCASH |EASYPAISA<br />
用我们收银台无需传参支付方式payType，收银台选择支付类型支付将自动唤起APP </p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>电子钱包JAZZCASH</td>
<td>PK_JAZZCASH</td>
</tr>
<tr>
<td>电子钱包EASYPAISA</td>
<td>PK_EASYPAISA</td>
</tr>
</tbody>
</table>
<h4>菲律宾</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>电子钱包</td>
<td>PN_GCASH</td>
</tr>
</tbody>
</table>
<h4>埃及</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。
注意： 参数 customerPhone 埃及手机号必须0开头的 如：01234567890 的总共 11 位</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
<th>描述</th>
</tr>
</thead>
<tbody>
<tr>
<td>电子钱包</td>
<td>EG_VODAFONE</td>
<td>表示埃及 Vodafone Cash 电子钱包支付</td>
</tr>
<tr>
<td>OTC</td>
<td>EG_FAWRY_REFERENCE</td>
<td>表示通过 Fawry 线下网点，使用 reference 编号付款（即场外付款）</td>
</tr>
<tr>
<td>QR</td>
<td>EG_FAWRY_R2P</td>
<td>表示 Fawry 的“Request to Pay”二维码支付，用户用电子钱包扫码付款</td>
</tr>
</tbody>
</table>
<h4>印尼</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。
交易金额必须为“整数“</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>电子钱包</td>
<td>ID_DANA</td>
</tr>
</tbody>
</table>
<h4>智利</h4>
<p>交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。</p>
<table>
<thead>
<tr>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>Checkout （聚合收银台）</td>
</tr>
<tr>
<td>PAYPAL （e-wallet）</td>
</tr>
</tbody>
</table>
<p>哥伦比亚
交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>PSE</td>
<td><code>CO_PSE</code></td>
</tr>
<tr>
<td>credit card</td>
<td><code>AMEX</code> <code>MASTERCARD</code> <code>DINERS</code> <code>VISA</code></td>
</tr>
<tr>
<td>e-wallet</td>
<td><code>PAYPAL</code> <code>CO_NEQUI</code>（NEQUI最低限额5000COP）</td>
</tr>
</tbody>
</table>
<p>秘鲁
交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>e-wallet</td>
<td><code>PAYPAL</code></td>
</tr>
<tr>
<td>聚合支付（banktransferm、 QR (Yape / Plin)、Pagar en Efectivo）</td>
<td><code>Checkout</code></td>
</tr>
</tbody>
</table>
<p>美国
交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>e-wallet</td>
<td><code>PAYPAL</code></td>
</tr>
</tbody>
</table>
<p>墨西哥
交易请求时需要指定固定的支付方式，channelExtra则需要payType传参对应枚举值。</p>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>payType 传参</th>
</tr>
</thead>
<tbody>
<tr>
<td>wallet</td>
<td><code>PAYPAL</code></td>
</tr>
<tr>
<td>SPEI</td>
<td><code>SPEI</code></td>
</tr>
</tbody>
</table>
<p><!--
沙特：
VA 支付方式接入流程图
<img src="https://www.showdoc.com.cn/server/api/attachment/visitFile?sign=e1ebb8d7f3c72acb08cb3c3d0f9e6ea1&amp;file=file.png" alt="" />
--></p>
<p><!--</p>
<h5>越南支付方式</h5>
<table>
<thead>
<tr>
<th>支付方式</th>
<th>说明</th>
<th>代收最小额(分)</th>
<th>代收最大额(分)</th>
</tr>
</thead>
<tbody>
<tr>
<td>907</td>
<td>越南网银支付</td>
<td>50,000.00</td>
<td>300,000,000.00</td>
</tr>
<tr>
<td>908</td>
<td>越南银行转帐、扫码支付</td>
<td>50,000.00</td>
<td>300,000,000.00</td>
</tr>
<tr>
<td>923</td>
<td>越南MOMO</td>
<td>20,000.00</td>
<td>20,000,000.00</td>
</tr>
<tr>
<td>925</td>
<td>越南Viettel Pay</td>
<td>20,000.00</td>
<td>20,000,000.00</td>
</tr>
</tbody>
</table>
<p>INR:印度卢比; COP:哥伦比亚比索; BRL:巴西雷亚儿; IDR:印尼盾; VND:越南盾; THB:泰铢; NGN:尼日利亚奈拉; MYR:马来西亚; MXN:墨西哥比索; ZAR:南非兰特; PHP:菲律宾比索; TRY:土耳其里拉; CLP:智利; PEN:秘鲁; KES:肯尼亚; BDT:孟加拉; MAD:摩洛哥; EGP:埃及
--></p>