ticketing 申请出票接口

该接口用于订单支付，申请出票。
通过调用ticketing接口，进行支付和申请出票。合作方调用该接口通知FR24进行订单扣款。扣款成功后会返回接口调用成功。票号将在票号推送接口获取，或通过调用orderDetail接口获取。
调用成功代表FR24收到了出票申请，待确认该订单是否可以出票，不代表已经在出票。确认可以出票后会通过orderChangeInforming接口推送状态的变更，未通知则代表还在确认中。
若超过订单保留时长还未支付订单，则会取消订单。

请求参数

Header 参数

Accept-Encoding

string

必需

使用gzip压缩格式

默认值:

gzip, deflate, br

content-Type

string

响应格式

必需

默认值:

application/json

appKey

string

用户账户

必需

默认值:

Body 参数application/json

authentication

object

用户认证信息

必需

sign

string

签名

必需

appkey + appsecret + timestamp加密后的字符串，加密见附录

timestamp

string

使用 unix 时间戳

必需

单位：秒

orderNo

string

FR24订单号

必需

正则匹配:

^\d*$

partnerOrderNo

string

合作方订单号

可选

currency

string

报价币种

必需

totalPrice

number

订单总价

必需

paymentMethod

string

支付方式

必需

0 - 余额支付

正则匹配:

^\d*$

seriesTraceId

string

上一个业务请求接口返回的traceId

可选

此字段为开发者选项，FR24通过此traceId追踪并分析合作商的上一个调用接口，方便双方在出现问题时能够快速追踪整条链路

seriesRsTime

number

上一个业务请求接口，从请求该接口到获取结果的时长

可选

单位为ms；此字段为开发者选项，FR24通过该时长分析合作商的网络延迟情况，以提升双方的数据质量。

示例

{
  "authentication": {
    "sign": "{{sign}}",
    "timestamp": "{{timestamp}}"
  },
  "orderNo": "18599020016177152",
  "partnerOrderNo": "",
  "totalPrice": 22148,
  "currency": "CNY",
  "paymentMethod": "0",
  "seriesTraceId": "order_NEWAPI250117113939340071145",
  "seriesRsTime": 12051
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200OK

application/json

Body

traceId

string

追溯码

必需

code

string

状态码

必需

000000 代表成功，其他代表失败

message

string

状态说明

必需

processingTime

number

处理时长

必需

单位：ms

>= 0

data

object (出票响应)

返回的所有数据

可选

当status为（失败）时，内容为空

orderNo

string

FR24订单号

必需

orderStatus

enum<string>

订单状态

可选

枚举值:

1112131415

partnerOrderNo

string

合作方订单号

必需

instantTicketing

array [object {5}]

立即出票信息

可选

totalPrice

number

订单总价

必需

currency

string

交易币种

必需

示例

成功Real Case

{
    "traceId": "applyticket_NEWAPI250117114253463071146",
    "code": "000000",
    "message": "成功",
    "processingTime": 10874,
    "data": {
        "orderNo": "18599020016177152",
        "orderStatus": null,
        "partnerOrderNo": "",
        "instantTicketing": [
            {
                "airlinePnr": "5JUDXY",
                "gdsPnr": "RMIOBA",
                "paxId": "1",
                "paxName": "VJKOX/SBLUE",
                "ticketNo": ""
            },
            {
                "airlinePnr": "5JUDXY",
                "gdsPnr": "RMIOBA",
                "paxId": "2",
                "paxName": "ZBI/QHNEA",
                "ticketNo": ""
            }
        ],
        "totalPrice": 22148,
        "currency": "CNY"
    }
}