创建机票订单

POST

/open/v1/flight/order/create

基于 offer_id + 乘客信息 + 联系人创建订单。offer_id 可由搜索直出或验价接口返回，10分钟内有效。

请求参数

Authorization

Header 参数

Body 参数application/json必填

示例

{
    "approval_id": "OA-998877",
    "callback_url": "https://merchant.com/callback",
    "contact": {
        "email": "zhangsan@example.com",
        "name": "张三",
        "phone": "13800138000"
    },
    "cost_center": "SALES-HZ",
    "external_user_id": "E123456",
    "external_user_name": "张三",
    "invoice_address": {
        "city": "杭州市",
        "detail_address": "文三路XX号",
        "district": "西湖区",
        "phone": "13800138000",
        "province": "浙江省",
        "recipient_name": "张三"
    },
    "need_invoice": false,
    "offer_id": "eyJhbGciOiJBMjU2R0NNIi...",
    "out_trade_no": "MERCHANT_ORDER_123",
    "passengers": [
        {
            "birthday": "1990-01-01",
            "card_valid_end_date": "2030-12-31",
            "id_number": "330106199001011234",
            "id_type": "ID_CARD",
            "name": "张三",
            "name_en": "ZHANG/SAN",
            "nationality_code": "CN",
            "phone": "13800138000",
            "sex": 1,
            "type": "adult"
        }
    ],
    "pay_mode": "user_pay",
    "return_offer_id": "eyJhbGciOiJBMjU2R0NNIi..."
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://open.longxiachuxing.com/api/open/v1/flight/order/create' \
--header 'Authorization;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "approval_id": "OA-998877",
    "callback_url": "https://merchant.com/callback",
    "contact": {
        "email": "zhangsan@example.com",
        "name": "张三",
        "phone": "13800138000"
    },
    "cost_center": "SALES-HZ",
    "external_user_id": "E123456",
    "external_user_name": "张三",
    "invoice_address": {
        "city": "杭州市",
        "detail_address": "文三路XX号",
        "district": "西湖区",
        "phone": "13800138000",
        "province": "浙江省",
        "recipient_name": "张三"
    },
    "need_invoice": false,
    "offer_id": "eyJhbGciOiJBMjU2R0NNIi...",
    "out_trade_no": "MERCHANT_ORDER_123",
    "passengers": [
        {
            "birthday": "1990-01-01",
            "card_valid_end_date": "2030-12-31",
            "id_number": "330106199001011234",
            "id_type": "ID_CARD",
            "name": "张三",
            "name_en": "ZHANG/SAN",
            "nationality_code": "CN",
            "phone": "13800138000",
            "sex": 1,
            "type": "adult"
        }
    ],
    "pay_mode": "user_pay",
    "return_offer_id": "eyJhbGciOiJBMjU2R0NNIi..."
}'

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "code": 0,
    "data": {
        "external_user_id": "E123456",
        "out_trade_no": "MERCHANT_123",
        "pay_expire_time": "2026-05-28 15:00:00",
        "pay_mode": "user_pay",
        "pnr": "ABC123",
        "status": "pending_pay",
        "system_no": "RDF202605281430001",
        "total_amount": 650
    },
    "message": "success",
    "request_id": "req_a1b2c3"
}

🟠400

修改于 2026-06-10 04:01:22

机场搜索

机票验价