直通车下单

BusTicketOrder(v2.0)直通车下单

接口说明

http请求方式:POST

url:http://cd917.com/OpenApi/BusTicketOrderV2

使用调试工具调试该接口
参数说明
参数 类型 长度 可空 描述
apiKey string 32 由官方平台提供的apiKey
productCode string 4-32 产品码

是双方在对接过程中,约定好的。通过产品码,可以在我方找到唯一对应的一个直通车产品,其去回程、线路、套餐均已确定好。

date datetime 出行日期
schedule string 5 乘坐班次,例如:08:30
quantity decimal 18(2) 数量
tel string 30 客人电话
collectedIDNumber
(选填)
string 20

身份证号码(部分产品需要填写)

是否必填请参看产品码列表返回值中的RequiredField

collectedContact
(选填)
string 20

取票人姓名(部分产品需要填写)

是否必填请参看产品码列表返回值中的RequiredField

number
(选填)
string 32 对接方订单号

如果提供此参数,将存入我方订单中,方便对接方根据自己的订单号查询下单是否成功。

sign string 32

由apiSecret,与参数productCode、date、schedule、quantity、tel,通过MD5签名运算后的值。

注意:选填参数不参与签名运算

签名规则
返回说明

Json格式的Result对象

{
    "ErrorCode": 0,
    "Success": true,
    "Message": null,
    "HasException": false,
    "Value": 123123222,
    "Tag": 3423321,
    "HasETicket": true
}
返回值 描述
Success 本次调用是否成功
ErrorCode 错误代码
Message 失败时为异常信息,成功时为null
Value Number:订单号
Tag 客人消费码(验证码)
HasETicket 是否包含电子票

电子票为异步下单,如果包含电子票,对接方应在下单成功后从获取订单状态接口中查询入园码

ShortUrl 我方消费码页面的短链接地址,如果是对接方发送短信,建议在短信中加入此链接。
客人可访问此地址查看入园码/验证码/上车码(乘坐直通车时,可直接出示页面中的上车码完成上车检票。如果是电子票,在景区入园时,也可展示页面中的二维码直接扫码入园)。
支持下单重试,但number参数必填(为对接方的订单号),如果没有填写number参数,视为新下单。
在带有number参数的情况下,我方会对此number进行判重检查,如果发现已经下过单,会将之前的订单返回 (Value为订单号,Tag为验证码,Success为False,Message为错误原因),