BookingRefund

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

请求参数

参数名称 类型 必填 说明
requestId string ✅ 请求ID，出票环节每个次调用是唯一的，长度32位
refundOrderNo string ✅ AeroHub的退款单号
pricingMode int ⬜ 报价模式，当refundStatus=PENDING_QUOTE， 需要接受此参数，默认为人工报价：1.人工报价，无需实时返回 2.自动报价，实时确认报价单价格
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:死亡退票
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",
    "pricingMode": 2,
    "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
data array/data Element ⬜ 报价数据，当自动报价模式时返回此项

array/data Element

参数名称 类型 必填 说明
refundMethod float ✅ 退款方式：cash:退现金 voucher:退券
amount int ✅ 退款总额
currency string ✅ USD
passengers passengers Element ⬜️ 乘客退款明细
array/passengers Element
参数名称 类型 必填 说明
passengerNo float ✅ 乘客序号，与订单详情中乘客序号相同
name int ✅ 乘客姓名，与订单中乘客姓名相同
birthday string ⬜️ 乘客出生日期，与订单中相同
cardNo string ⬜️ 证件号，与订单中相同
amount string ✅ 此乘客的退款审核的报价金额

返回示例

人工报价Success-Response:

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

自动报价Success-Response:

{
  "marketErrorCode": 200,
  "marketErrorMsg": "Successful",
  "data": {
    "refundMethod": "cash",
    "amount": 201,
    "currency": "USD",
    "passengers": [
      {
        "passengerNo": 0,
        "name": "Doe/John",
        "birthday": "19900101",
        "cardNo": "ABC123456789",
        "amount": 100.5
      },
      {
        "passengerNo": 1,
        "name": "Smith",
        "birthday": "19910101",
        "cardNo": "XYZ987654321",
        "amount": 100.5
      }
    ]
  }
}

实时报价失败Error-Response

{
    "marketErrorCode": 300,
    "marketErrorMsg": "The final refund amount will be confirmed after manual verification."
}
marketErrorCode marketErrorMsg
300 The final refund amount will be confirmed after manual verification.
301 The ticket is not refundable.
Author：AeroHub  Create time：2024-03-13 11:34
Last editor：AeroHub  Update time：2026-07-02 18:17