3.1 pos刷卡支付-退款统一下单接口
<h2>星驿付pos刷卡支付-退款统一下单接口</h2>
<p><strong>接口地址</strong>:<code>/pay/api/1.0/starPosUnifiedOrder</code></p>
<p><strong>请求方式</strong>:<code>POST</code></p>
<p><strong>请求数据类型</strong>:<code>application/json</code></p>
<p><strong>响应数据类型</strong>:<code>*/*</code></p>
<p><strong>接口描述</strong>:</p>
<p><strong>请求示例</strong>:</p>
<pre><code class="language-javascript">{
&quot;appId&quot;: &quot;&quot;,
&quot;custId&quot;: &quot;&quot;,
&quot;mchNo&quot;: &quot;&quot;,
&quot;notifyUrl&quot;: &quot;&quot;,
&quot;orderDate&quot;: &quot;&quot;,
&quot;orderType&quot;: &quot;&quot;,
&quot;originalThreeOrderNo&quot;: &quot;&quot;,
&quot;payType&quot;: &quot;&quot;,
&quot;sign&quot;: &quot;&quot;,
&quot;sn&quot;: &quot;&quot;,
&quot;threeOrderNo&quot;: &quot;&quot;,
&quot;timeStamp&quot;: &quot;&quot;,
&quot;txamt&quot;: &quot;&quot;,
&quot;version&quot;: &quot;&quot;,
&quot;wayCode&quot;: &quot;&quot;
}</code></pre>
<p><strong>请求参数</strong>:</p>
<p><strong>请求参数</strong>:</p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数说明</th>
<th>请求类型</th>
<th>是否必须</th>
<th>数据类型</th>
<th>schema</th>
</tr>
</thead>
<tbody>
<tr>
<td>req</td>
<td>req</td>
<td>body</td>
<td>true</td>
<td>星驿付pos支付统一下单请求实体</td>
</tr>
<tr>
<td>&emsp;&emsp;appId</td>
<td>应用id</td>
<td><code>true</code></td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;mchNo</td>
<td>商户号</td>
<td><code>true</code></td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;notifyUrl</td>
<td>通知地址</td>
<td>false</td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;closeNotifyUrl</td>
<td>关单通知地址</td>
<td>false</td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;orderDate</td>
<td>原订单交易日期</td>
<td>false</td>
<td>string</td>
<td>扫码退货、刷卡撤销、刷卡退货时必传 格式yyyyMMdd</td>
</tr>
<tr>
<td>&emsp;&emsp;orderType</td>
<td>交易方式</td>
<td>false</td>
<td>string</td>
<td>00-扫码</br>01-刷卡</td>
</tr>
<tr>
<td>&emsp;&emsp;originalThreeOrderNo</td>
<td>原交易订单号 扫码退货、刷卡撤销、刷卡退货时必传</td>
<td>false</td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;payType</td>
<td>操作类型</td>
<td><code>true</code></td>
<td>string</td>
<td>01-消费</br>02-刷卡撤销</br>03-刷卡退货</br>04-扫码退货</td>
</tr>
<tr>
<td>&emsp;&emsp;sign</td>
<td>签名</td>
<td><code>true</code></td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;sn</td>
<td>设备SN</td>
<td><code>true</code></td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;threeOrderNo</td>
<td>商户订单号</td>
<td><code>true</code></td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;timeStamp</td>
<td>时间戳 默认当前时间</td>
<td>false</td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;txamt</td>
<td>消费者支付/退货金额</td>
<td>false</td>
<td>string</td>
<td>单位：分</td>
</tr>
<tr>
<td>&emsp;&emsp;version</td>
<td>版本号 默认1.0.0</td>
<td>false</td>
<td>string</td>
</tr>
<tr>
<td>&emsp;&emsp;wayCode</td>
<td>支付方式</td>
<td><code>true</code></td>
<td>string</td>
<td>ALIPAY(支付宝)</br>WECHAT(微信)</br>UNIONPAY(银联)</td>
</tr>
</tbody>
</table>
<p><strong>响应状态</strong>:</p>
<table>
<thead>
<tr>
<th>状态码</th>
<th>说明</th>
<th>schema</th>
</tr>
</thead>
<tbody>
<tr>
<td>200</td>
<td>OK</td>
<td>StarBaseResp</td>
</tr>
<tr>
<td>201</td>
<td>Created</td>
</tr>
<tr>
<td>401</td>
<td>Unauthorized</td>
</tr>
<tr>
<td>403</td>
<td>Forbidden</td>
</tr>
<tr>
<td>404</td>
<td>Not Found</td>
<td>Not Found</td>
</tr>
</tbody>
</table>
<p><strong>响应参数</strong>:</p>
<table>
<thead>
<tr>
<th>参数名称</th>
<th>参数说明</th>
<th>类型</th>
<th>schema</th>
</tr>
</thead>
<tbody>
<tr>
<td>code</td>
<td>string</td>
<td>000000表示成功</td>
</tr>
<tr>
<td>data</td>
<td>object</td>
</tr>
<tr>
<td>msg</td>
<td>string</td>
<td>返回描述</td>
</tr>
</tbody>
</table>
<p><strong>响应示例</strong>:</p>
<pre><code class="language-javascript">{
&quot;code&quot;: &quot;000000&quot;,
&quot;data&quot;: null,
&quot;msg&quot;: &quot;成功&quot;
}</code></pre>