# 购票接口
> 仅限购票闸机使用,闸机购票或检票由心跳接口返回值确定。
购票目前仅支持二维码方式
~~~[api]
get:/buy
*int:partnerID#联合分配的合作方ID。
*int:now#机器当前 unix 时间戳
*int:key#随机码,服务器原样返回
*string:deviceID#设备id
* qrcode#二维码的值
<<<
success 可直接通行
{
"errNum": 0,
"retMsg": "success",
"deviceID":"设备id",
*int:key#随机码,服务器原样返回
"retData": {
orderid:支付订单号,
name:门票名称,
quantity:数量,
voice:是否播放语音1播放0不播放
remark:备注信息
}
}
<<<
paying支付中
{
"errNum": 111,
"retMsg": "支付中,请等待30秒后重新查询订单",
"deviceID":"设备id",
*int:key#随机码,服务器原样返回
"retData": {
orderid:支付订单号,
waittime:30
}
}
返回本状态时,表示用户展示付款码之后,需要支付密码时返回
orderid:支付的订单号,接下来调用查询购票支付状态接口时调用
waittime:等待倒计时,单位秒
<<<
error支付失败
{
"errNum": 非零错误码,
"retMsg": "错误信息",
"deviceID":"设备id",
*int:key#随机码,服务器原样返回
}
~~~
![购票流程说明](https://box.kancloud.cn/774ca7a7933c90366e855da987173730_454x694.png)