2:卡密提取
<p><strong>请求URL:</strong> </p>
<ul>
<li><code>http://www.test.damaicheng.com/index.php?r=xuniapinew/giftCard&kehuid =50&orderid=1001&sign=***</code></li>
</ul>
<p><strong>请求方式:</strong></p>
<ul>
<li>GET </li>
</ul>
<p><strong>参数:</strong> </p>
<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;">kehuid</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">int</td>
<td>客户id</td>
</tr>
<tr>
<td style="text-align: left;">goodid</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">int</td>
<td>商品id</td>
</tr>
<tr>
<td style="text-align: left;">orderid</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>订单号,在客户系统中的订单id</td>
</tr>
<tr>
<td style="text-align: left;">useraccount</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>用户id或用户名</td>
</tr>
<tr>
<td style="text-align: left;">sign</td>
<td style="text-align: left;"><code>是</code></td>
<td style="text-align: left;">string</td>
<td>签名</td>
</tr>
<tr>
<td style="text-align: left;">phone</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>手机号</td>
</tr>
<tr>
<td style="text-align: left;">num</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>提取数量,默认1</td>
</tr>
<tr>
<td style="text-align: left;">integral</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">int</td>
<td>订单总积分值</td>
</tr>
<tr>
<td style="text-align: left;">note</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>备注字段</td>
</tr>
<tr>
<td style="text-align: left;">addtime</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>订单生成时间,默认为当前时间。格式 yyyy-MM-ddHH:mm:ss : 2028-01-0123:59:59</td>
</tr>
</tbody>
</table>
<p><strong>返回示例</strong>
成功</p>
<pre><code>{
"status ":"1", //成功
"message ":"\u5317\u4eac\u ", //错误信息
"order_id":"6434",
"good_id":"103525", //商品id
"good_name":"5元京东E卡", //商品名称
"tel":"6434367", //电话
"crash":"5.5", //售价
"info": [
{
"cardno": "JDV114455370", //卡密产品卡号
"cardpwd": "7D3E-3EA3-EE24-B48B", //卡密产品密码
"validity": "2019-09-21" //有效期
}
]</code></pre>
<p>失败</p>
<pre><code>{
"status ":"0", //失败,其他参数,具体查看message参数,这个状态值仅仅代表提交订单是否成功,与充值是否成功不同
"message ":"\u5317\u4eac\u ", //错误信息
}</code></pre>
<p><strong>返回参数说明</strong> </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;">status</td>
<td style="text-align: left;">int</td>
<td>1成功,其他数为错误,详情看message参数,<code>这个状态值仅仅代表大麦成是否受理。真实提取状态,请通过 info 数组数量,是否满足请求的数量。如不满足,后续通过异步形式,大麦城会主动通知到客户</code> <a href="https://www.showdoc.com.cn/dmc/2707672318858807" title="查看接口">查看接口</a></td>
</tr>
<tr>
<td style="text-align: left;">message</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;">good_id</td>
<td style="text-align: left;">int</td>
<td>商品id</td>
</tr>
<tr>
<td style="text-align: left;">good_name</td>
<td style="text-align: left;">string</td>
<td>商品名称</td>
</tr>
<tr>
<td style="text-align: left;">tel</td>
<td style="text-align: left;">string</td>
<td>充值手机号</td>
</tr>
<tr>
<td style="text-align: left;">crash</td>
<td style="text-align: left;">decimal</td>
<td>商品成本</td>
</tr>
<tr>
<td style="text-align: left;">info</td>
<td style="text-align: left;">string</td>
<td>提取的卡密信息,库存不足时该字段为空,有库存后会将卡号卡密通过客户提供的回调地址推送给客户</td>
</tr>
<tr>
<td style="text-align: left;">cardno</td>
<td style="text-align: left;">string</td>
<td>卡号</td>
</tr>
<tr>
<td style="text-align: left;">cardpwd</td>
<td style="text-align: left;">string</td>
<td>卡密</td>
</tr>
<tr>
<td style="text-align: left;">validity</td>
<td style="text-align: left;">string</td>
<td>有效期</td>
</tr>
</tbody>
</table>
<p><strong>注意:</strong> </p>
<ul>
<li>
<p>注:库存不足时也可以提交订单,只是不会返回卡密信息,大麦城更新库存后将卡密异步推送到客户端,因为话费类订单是异步通知订单状态的,客户可以在接收通知的接口中预留接收卡密的字段</p>
<p><strong>备注</strong> </p>
</li>
<li>更多返回错误代码请看首页的错误代码描述</li>
</ul>