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-乘客已自行改期
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 ⬜️ 券说明，如有效期和使用规则等，未退款时可不返回本字段

array/refundFeePricing Element

参数名称 类型 必填 说明
amount float ⬜️ 总应退金额
isRefundVoucher int ✅ 是否退券，0 是，1否
voucherCurrency string ⬜️ 优惠券的币种，应与航司退回给供应商的币种一致，如果isRefundVoucher返回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.",
  "refundAmount": [
    {
      "refundCost": 250.00,
      "refundVoucher": 50.00,
      "voucherCurrency": "USD",
      "voucherNote": "Expired on January 31, 2025, for personal use only."
    }
  ],
  "refundFeePricing": [
    {
      "amount": 300.00,
      "isRefundVoucher": 0,
      "voucherCurrency": "USD"
    }
  ]
}

返回参数

参数名称 类型 必填 说明
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：2025-10-28 15:50