BookingRefund

BookingRefund
请求参数
array/passengers Element
array/segments Element
array/documentation Element
请求示例
返回参数
返回示例

用途：用于推送给供应商退款单，包括退款申请信息、行程、乘客等。
请求方式：POST
接口加密：否

请求参数

参数名称	类型	必填	说明
requestId	`string`	✅	请求ID，出票环节每个次调用是唯一的，长度32位
refundOrderNo	`string`	✅	AeroHub的退款单号
isRefundConfirm	`int`	✅	核价的退票单确认提交 0 核价转提交退票（为0时退票单已经创建成功，需要更新原退票单状态为refundStatus中对应状态）、1 其他提交
purchaseOrderNo	`string`	✅	AeroHub的订单号
refundType	`string`	✅	INVOLUNTARY:非自愿，VOLUNTARY: 自愿 , other:其他
refundReason	`string`	✅	退款原因：VOLUNTARY_CANCELLATION:自愿退票,VOID_TICKET:废票,OTHER:其他,FLIGHT_CHANGE:航变变更,FLIGHT_CANCEL:航变取消,CANCELLATION_DUE_TO_ILLNESS:因病退票,CANCELLATION_DUE_TO_DEATH:死亡退票,DUPLICATE_RESERVATION:重复预订,COMPENSATION_REFUND:补退,BOARDING_DENIED:到场无票,CUSTOMER_REFUND:客户退票
refundNote	`string`	⬜	退款的备注
refundStatus	`string`	✅	退款单状态：PENDING_QUOTE:待报价、PENDING:待退票、WITHDRAWN:已撤销
isDocumentationRequired	`int`	⬜️	是否需要资料：1 不需要提供、3 已提供
documentation	`array/documentation Element`	⬜	可获取到证明文件的url，如：证件照片、医院证明等
refundFee	`float`	✅	AeroHub支付给供应商的退票服务费
passengers	`array/passengers Element`	✅	乘机人信息
segments	`array/segments Element`	✅	行程信息

array/passengers Element

参数名称	类型	必填	说明
passengerNo	`int`	✅	乘客的序号，从0开始
name	`string`	✅	乘客姓名，姓和名之间用/隔开，LastName/FirstName MiddleName
birthday	`string`	✅	出生日期，格式：YYYYMMDD
cardNo	`string`	✅	证件号码，最大 15 个字符

array/segments Element

参数名称	类型	必填	说明
segmentNo	`int`	✅	航程顺序，1 去程、2 回程
sequence	`int`	✅	航段顺序，从1开始，注意：若是往返，去程和回程都是从1开始
flightNumber	`string`	✅	航班号，如：CA123
depAirport	`string`	✅	出发机场代码，采用 IATA 三字代码做为标准
arrAirport	`string`	✅	到达机场代码，采用 IATA 三字代码做为标准

array/documentation Element

参数名称	类型	必填	说明
url	`string`	⬜	可获取到证明文件的url，如：证件照片、医院证明等

请求示例


{
    "requestId": "PcrNq8964iFUkE0CyVV4bhgXXX",
    "refundOrderNo": "FBRF2403112526",
    "isRefundConfirm": 0,
    "purchaseOrderNo": "F1745527321051406356",
    "refundType": 1,
    "refundReason": "VOLUNTARY_CANCELLATION",
    "refundNote": "Passenger decided to cancel the trip.",
    "refundStatus": "PENDING_QUOTE",
    "isDocumentationRequired": 1,
    "documentation":[
          {
            "url": "https://cdn.aerohub.com/upload/2024031218/998a7d64775f9bfe6ffdf7c3583b26aa1.png"
        },
        {
            "url": "https://cdn.aerohub.com/upload/2024031218/5f43518a76129749e8830960379ed2716.pdf"
        }],
    "refundFee": 50.00,
    "passengers": [
        {
        "passengerNo": 0,
        "name": "Doe/John",
        "birthday": "19900101",
        "cardNo": "ABC123456789"
        },
        {
        "passengerNo": 1,
        "name": "Doe/Jane",
        "birthday": "19910101",
        "cardNo": "XYZ987654321"
        }
        ],
    "segments": [
        {
        "segmentNo": 1,
        "sequence": 1,
        "flightNumber": "CA123",
        "depAirport": "PEK",
      "arrAirport": "SFO"
      }
    ]
}

返回参数

参数名称	类型	必填	说明
marketErrorCode	`int`	✅	供应商系统错误码，用于协助AeroHub与供应商排查问题，请如实返回真实错误
marketErrorMsg	`string`	✅	供应商系统错误描述，请如实返回真实错误原因，长度小于 300

返回示例

Success-Response:

{
    "marketErrorCode": 200,
    "marketErrorMsg": "Successful"
}

Author：AeroHub Create time：2024-03-13 11:34
Last editor：AeroHub Update time：2025-10-28 15:50