卡券购买下单
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>卡券购买下单接口</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>网关地址 + /dcapi/card/payOrder</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>POST</li>
</ul>
<h5>请求类型</h5>
<ul>
<li>application/x-www-form-urlencoded</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;">appid</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合作商appid</td>
</tr>
<tr>
<td style="text-align: left;">card_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>卡券产品ID</td>
</tr>
<tr>
<td style="text-align: left;">num</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>数量</td>
</tr>
<tr>
<td style="text-align: left;">auto_confirm_hour</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>可从商品列表或者单个商品列表信息中查询,字段同名,接口中有详细说明。比如10, 代表10小时质保,10小时后自动确认收货, 选择不同的质保时间,则会有一定的售价叠加, 售价叠加费率明细如附录说明 <code>质保时间可选2023.02.22新增</code></td>
</tr>
<tr>
<td style="text-align: left;">out_order_id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合作商订单ID</td>
</tr>
<tr>
<td style="text-align: left;">order_money</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>合作商订单总额,防止调价导致亏本,为必传值并参与签名,当进价总额高于订单总额,则无法下单。若值为0,则不行校验。<code>单位/元</code></td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>签名(不参与签名)签名方式请参考-签名算法方式说明</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<pre><code> {
&quot;code&quot;: 1,
&quot;msg&quot;: &quot;下单成功&quot;,
&quot;result&quot;: [
{
&quot;order_id&quot;: &quot;2023082621250118187&quot;,
&quot;card_num&quot;: &quot;11222&quot;,
&quot;card_pass&quot;: &quot;77888&quot;,
&quot;money&quot;: &quot;4.20&quot;,
&quot;status&quot;: 3
}
],
&quot;other&quot;: {
&quot;pay_order_id&quot;: &quot;2023082621250118166&quot;,
&quot;card_id&quot;: 184,
&quot;create_time&quot;: &quot;2022-08-26 21:25:00&quot;,
&quot;update_time&quot;: &quot;2022-08-26 22:33:14&quot;,
&quot;remark&quot;: &quot;-用户主动确认收货&quot;
}
}</code></pre>
<h3>返回参数说明</h3>
<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;">pay_order_id</td>
<td style="text-align: left;">string</td>
<td>平台支付单号</td>
</tr>
<tr>
<td style="text-align: left;">order_id</td>
<td style="text-align: left;">string</td>
<td>平台下单订单号</td>
</tr>
<tr>
<td style="text-align: left;">card_num</td>
<td style="text-align: left;">string</td>
<td>卡密信息 卡号</td>
</tr>
<tr>
<td style="text-align: left;">card_pass</td>
<td style="text-align: left;">string</td>
<td>卡密内容</td>
</tr>
<tr>
<td style="text-align: left;">money</td>
<td style="text-align: left;">string</td>
<td>实际购买单价</td>
</tr>
<tr>
<td style="text-align: left;">status</td>
<td style="text-align: left;">string</td>
<td>卡密状态 2 待确认 3 已完成 4 纠纷中 5 纠纷已完成 6 已取消</td>
</tr>
<tr>
<td style="text-align: left;">card_id</td>
<td style="text-align: left;">string</td>
<td>购买的产品ID</td>
</tr>
<tr>
<td style="text-align: left;">type</td>
<td style="text-align: left;">string</td>
<td>卡密类型 0 官方激活码 1 卡号和密码 2 图片二维码 3 链接+卡密 4 链接直兑</td>
</tr>
<tr>
<td style="text-align: left;">typeName</td>
<td style="text-align: left;">string</td>
<td>卡密类型名称</td>
</tr>
<tr>
<td style="text-align: left;">create_time</td>
<td style="text-align: left;">string</td>
<td>下单时间</td>
</tr>
<tr>
<td style="text-align: left;">update_time</td>
<td style="text-align: left;">string</td>
<td>订单更新时间</td>
</tr>
<tr>
<td style="text-align: left;">remark</td>
<td style="text-align: left;">string</td>
<td>订单备注</td>
</tr>
</tbody>
</table>
<h3>card_num 和 card_pass 说明</h3>
<p>这两个参数根据产品类型,代表的含义不同,具体说明如下</p>
<ul>
<li>type = 0 官方激活码 card_pass 官方激活码 card_num 为空</li>
<li>type = 1 卡号和卡密 card_pass 卡号 card_num 卡密</li>
<li>type = 2 图片二维码 card_pass 二维码链接地址 card_num 二维码内容</li>
<li>type = 3 链接+卡密 card_pass 卡密 card_num 兑换地址</li>
<li>type = 4 链接直兑 card_pass 充值链接 card_num 充值说明</li>
</ul>
<h3>auto_confirm_hour 选择不同质保时间-不同的售价叠加说明表 <code>2023.02.22新增</code></h3>
<p>单位(小时)</p>
<p><strong>详细可选择质保时间,可从商品卡密列表或者卡密商品详情中查看</strong></p>
<p>举例说明</p>
<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;">10</td>
<td style="text-align: left;">10小时</td>
<td>0.15%</td>
</tr>
<tr>
<td style="text-align: left;">12</td>
<td style="text-align: left;">12小时</td>
<td>0.3%</td>
</tr>
<tr>
<td style="text-align: left;">24</td>
<td style="text-align: left;">24小时</td>
<td>0.6%</td>
</tr>
<tr>
<td style="text-align: left;">48</td>
<td style="text-align: left;">48小时</td>
<td>1.5%</td>
</tr>
</tbody>
</table>