万博manbetx官网手机授权下单

BusTicketOrder(v2.0)万博manbetx官网手机授权下单

接口说明

http请求方式:POST

url:http://www.nx917.com/OpenApi/BusTicketOrderV2

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

是双方在对接过程中,约定好的。通过产品码,可以在我方找到唯一对应的一个万博manbetx官网手机授权产品,其去回程、线路、套餐均已确定好。

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