出票完成通知
票务通知Webhook
一旦票务预订完成，您将在服务器上收到order.ticketed通知。您可以处理它并根据需要采取行动。例如，您可以向客户发送包含票务详情的预订确认邮件。
端点
您配置用于接收通知的URL
方法：Post
cid
类型: 字符串
必填: 是
描述: 用于跟踪请求的唯一客户端标识符。
默认值: 无
示例:
"XXXXXXX"
data
类型: 对象
必填: 是
描述: 包含订单相关信息。
默认值: 无
示例:
{
"orderNo": "TESTL20230922153224323",
"orderStatus": 2,
"paxTicketInfos": [ ... ]
}data.orderNo
类型: 字符串
必填: 是
描述: 与票务购买关联的唯一订单号。
默认值: 无
示例:
"TESTL20230922153224323"
data.orderStatus
类型: 整数
必填: 是
描述: 订单状态。
有效值:
0: 未支付
1: 出票中
2: 已出票
-3: 已取消(当预订因请求信息失败时) 订单号
默认值: 无
示例:
2
data.paxTicketInfos
类型: 对象数组
必填: 是
描述: 包含乘客及其关联票务信息的详细信息。
默认值: 无
data.paxTicketInfos[]
类型: 对象
必填: 是
描述: 单个乘客票务详情。
示例:
data.paxTicketInfos[].name
类型: 字符串
必填: 是
描述: 标准航空公司格式的乘客姓名(姓/名 中间名)。
默认值: 无
示例:
"zhang/lisi"
data.paxTicketInfos[].passengerType
类型: 整数
必填: 是
描述: 乘客类型。
有效值:
0= 成人1= 儿童2= 婴儿
默认值: 无
示例:
1
data.paxTicketInfos[].birthday
类型: 字符串
必填: 是
描述: 乘客出生日期，格式为
YYYYMMDD。默认值: 无
示例:
"20160202"
data.paxTicketInfos[].gender
类型: 字符串
必填: 是
描述: 乘客性别。 有效值:
M表示男性F表示女性
默认值: 无
示例:
"F"
data.paxTicketInfos[].cardNum
类型: 字符串
必填: 是
描述: 身份证件号码(护照或身份证)。
默认值: 无
示例:
"123458"
data.paxTicketInfos[].cardType
类型: 字符串
必填: 是
描述: 身份证件类型。
有效值:
PP - 护照
GA - 中国大陆公民的港澳通行证
TW - 中国大陆公民的台湾通行证
TB - 台湾同胞的大陆通行证
HY - 国际海员证
默认值: 无
示例:
"PP"
data.paxTicketInfos[].cardIssuePlace
类型: 字符串
必填: 是
描述: 签发身份证件的国家或机构。
默认值: 无
示例:
"CN"
data.paxTicketInfos[].cardExpired
类型: 字符串
必填: 是
描述: 身份证件的到期日期，格式为
YYYYMMDD。必须是未来的有效日期。默认值: 无
示例:
"20400101"
data.paxTicketInfos[].nationality
类型: 字符串
必填: 是
描述: 乘客国籍，使用国家代码(ISO 3166-1 alpha-2)。
默认值: 无
示例:
"CN"
data.paxTicketInfos[].ticketNos
类型: 字符串数组
必填: 是
描述: 与乘客关联的已出票票号列表。
默认值: 无
示例:
["S30814"]
data.paxTicketInfos[].airlinePNRs
类型: 字符串数组
必填: 是
描述: 乘客姓名记录(PNR)代码列表。
默认值: 无
示例:
["S30814"]
data.paxTicketInfos[].ancillaries
类型: 数组
必填: 是
描述: 与乘客关联的附加服务列表(例如额外行李、座位选择)。
默认值:
[]示例:
[]
status
类型: 整数
必填: 是
描述: 表示响应状态。
默认值: 无
示例:
-1
type
类型: 字符串
必填: 是
描述: 指定响应消息的类型。
默认值: 无
示例:
"order.ticketed"
Last updated
Was this helpful?