门票下单

TicketOrder(v2.0)门票下单

接口说明

http请求方式:POST

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

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

是双方在对接过程中,约定好的。通过产品码,可以在我方找到唯一对应的一个产品。

quantity decimal 18(2) 数量
tel string 30 客人电话
date
(选填)
string 32 出行日期

某些特殊产品景区有游玩日期限制的,需要确定出行日期
如果不填则默认为下单当日

collectedIDNumber
(选填)
string 20

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

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

collectedContact
(选填)
string 20

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

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

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

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

sign string 32

由apiSecret,与参数productCode、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为错误原因),