UpdateRefund

  • 用途：用于供应商将退款进度通知给AeroHub，包括退票中、已退票待退款、退款完成、无法退款等
  • 请求方式：POST
  • 接口加密：否
  • FareMarket地址：/supplier/v1/api/update_refund

请求参数

参数名称 类型 必填 说明
apiKey string ✅ 每个供应商有自己唯一的apiKey，用于表示供应商身份，AeroHub在接口测试前提供给供应商
requestId string ✅ 请求ID，出票环节每个次调用是唯一的，长度32位
refundOrderNo string ✅ AeroHub的退款单号
purchaseOrderNo string ✅ AeroHub的订单号
refundStatus string ✅ 退票询价单状态：QUOTE_COMPLETED:已报价、QUOTE_REJECTED:报价拒绝; 退票状态：PROCESSING:退票中（第一步先锁定这个状态，无法撤销）、REFUNDED_PENDING（第二步）:已退票待退款、REFUNDED（第三步）:退款完成、CLOSED（任何一步都可以拒绝）:已关闭（拒绝退款）
rejectReason int ⬜️ 退票拒单时需要回传原因：20-不可退票不可退税, 21-退票罚金大于机票金额，订单不可退, 22-航变时间较短，不符和非自愿退票，可尝试自愿退票, 23-航变时间较短，不符和非自愿退票，也不能自愿退, 24-超过退票提交时限, 25-航班正常，不符合非自愿退票, 26-客票换开，不符合非自愿退票, 27-当前不可退，未到退款提交时限, 28-提交类型错误, 29-退款需要护照，没有在规定时间内反馈, 30-乘客已乘坐或使用备选航班, 31-客票已退, 32-航司拒绝退票, 33-供应报价错误, 34-渠道拦截退票, 35-乘客已自行改期, 0-其他,1-等待航司退票窗口，到指定日期自动提交(在refundDate传值)
rejectReasonNote string ⬜️ 退票拒单原因为rejectReason=0 时需要备注此原因具体说明
refundDate string ⬜️ 退票到期重新提交航司日期。当rejectReason=1时必须传入，格式：YYYY-MM-DD，例如2023-03-10 表示 2023年3月10日
isDocumentation int ⬜️ 是否需要资料：1 不需要、2 需要-未提供
refundAmount array/refundAmount Element ⬜️ 退款金额，退款状态为：REFUNDED 退款完成时此项必须返回
refundFeePricing array/refundPolicyDetail ⬜️ 退票核价信息，退款状态为：QUOTE_COMPLETED:已报价 已核价时此项必须返回
refundDate string ⬜️ 退票完成的时间，采用 ISO 8601 格式

array/refundAmount Element

参数名称 类型 必填 说明
refundCost float ⬜️ 供应商退回给AeroHub的金额，注意：这个金额的币种应与供应商和AeroHub结算的币种一致，未退款时可不返回本字段
refundVoucher float ⬜️ 供应商退回给AeroHub的优惠券金额，应与航司退回给供应商的金额一致，未退款时可不返回本字段
voucherCurrency string ⬜️ 优惠券的币种，应与航司退回给供应商的币种一致，未退款时可不返回本字段
voucherNote string ⬜️ 券说明，如有效期和使用规则等，未退款时可不返回本字段
passengers array/passengers refund Element ⬜️ 各乘客退款信息
array/passengers refund Element
参数名称 类型 必填 说明
passengerNo float ✅ 与订单详情中乘客序号相同
name int ✅ 乘客姓名，与订单中乘客姓名相同
birthday string ⬜️ 乘客出生日期，与订单中相同
cardNo string ⬜️ 证件号，与订单中相同
refundCost string ✅ 此乘客供应商退回给AeroHub的金额
refundVoucher string ✅ 此乘客供应商退回给AeroHub的优惠券金额

array/refundFeePricing Element

参数名称 类型 必填 说明
amount float ✅ 总应退金额
isRefundVoucher int ✅ 是否退券，0 是，1否
voucherCurrency string ⬜️ 优惠券的币种，应与航司退回给供应商的币种一致，如果isRefundVoucher返回0，此项为必填
passengers array/passengers FeePricing Element ⬜️ 各乘客报价信息
array/passengers FeePricing Element
参数名称 类型 必填 说明
passengerNo float ✅ 乘客序号，与订单详情中乘客序号相同
name int ✅ 乘客姓名，与订单中乘客姓名相同
birthday string ⬜️ 乘客出生日期，与订单中相同
cardNo string ⬜️ 证件号，与订单中相同
amount string ✅ 此乘客的退款审核的报价金额

请求示例

退款成功


{
  "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
  "requestId": "B2B171eAv8YTQ",
  "refundOrderNo": "FBRF2403112526",
  "purchaseOrderNo": "F1745553257834618888",
  "refundStatus": "REFUNDED",
  "rejectReason": null,
  "refundDate": "2024-04-15T12:00:00Z",
  "refundableAmount": null,
  "flightNumber": null,
  "isDocumentation": 1,
  "documentationNote": "Please provide necessary documentation.",
  "refundAmount": [
    {
      "refundCost": 250,
      "refundVoucher": 50,
      "voucherCurrency": "USD",
      "voucherNote": "Expired on January 31, 2025, for personal use only.",
      "passengers": [
        {
          "passengerNo": 0,
          "name": "Doe/John",
          "birthday": "19900101",
          "cardNo": "ABC123456789",
          "refundCost": 150,
          "refundVoucher": 0
        },
        {
          "passengerNo": 1,
          "name": "Smith",
          "birthday": "19910101",
          "cardNo": "XYZ987654321",
          "refundCost": 100,
          "refundVoucher": 0
        }
      ]
    }
  ]
}

报价成功


{
  "apiKey": "PcrNq8964iFUkE0CyVV4bhgXXX",
  "requestId": "B2B171eAv8YTQ",
  "refundOrderNo": "FBRF2403112526",
  "purchaseOrderNo": "F1745553257834618888",
  "refundStatus": "REFUNDED",
  "rejectReason": null,
  "refundDate": "2024-04-15T12:00:00Z",
  "refundableAmount": null,
  "flightNumber": null,
  "isDocumentation": 1,
  "documentationNote": "Please provide necessary documentation.",
  "refundFeePricing": [
    {
      "amount": 300,
      "isRefundVoucher": 0,
      "voucherCurrency": "USD",
      "passengers": [
        {
          "passengerNo": 0,
          "name": "Doe/John",
          "birthday": "19900101",
          "cardNo": "ABC123456789",
          "amount": 150
        },
        {
          "passengerNo": 1,
          "name": "Smith",
          "birthday": "19910101",
          "cardNo": "XYZ987654321",
          "amount": 100
        }
      ]
    }
  ]
}

返回参数

参数名称 类型 必填 说明
code int ✅ AeroHub的状态码，参考通用说明中的Market Errors
msg string ✅ AeroHub的错误说明，参考通用说明中的Market Errors

返回示例

Success-Response:

{
    "code": 200,
    "msg": "Successful"
}

Error-Response

{
    "code": 400,
    "msg": "Failed"
}
Author：AeroHub  Create time：2024-03-13 11:34
Last editor：AeroHub  Update time：2026-07-02 18:17