{ "data": { "refunds": { "searchRefundRequests": [ // Scenario 1: Request in process, poll for new status or use webhook { "ticketNum": "0452651082102", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-18", "totalFare": 642414.00, "totalFareAmount": { "amount": 642414.00, "currencyCode": "CLP" }, "cancellationFee": null, "waiver": null, "operatorNotes": null, "refundType": null, "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": null, "refundableTotal": null, "note": null, "requestedBy": "Agent_name", "eitherRefundStatus": { "left": "RequestInProcess", "right": null }, "refundRoute": null, "miscFee": { "amount": 0, "currencyCode": "CLP" }, "metadata": null, "toolNote": null }, // Scenario 2: Error processing request, flow ends here { "ticketNum": "0063583195264", "pnr": null, "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-18", "totalFare": 1172.21, "totalFareAmount": { "amount": 1172.21, "currencyCode": "USD" }, "cancellationFee": null, "waiver": null, "operatorNotes": null, "refundType": null, "freeText": null, "passengerName": null, "refundableFare": null, "refundableTotal": null, "note": null, "requestedBy": "Dev", "eitherRefundStatus": { "left": "Error", "right": null }, "refundRoute": null, "miscFee": { "amount": 0, "currencyCode": "USD" }, "metadata": null, "toolNote": null }, // Scenario 3: Request with credential/access error, flow ends here { "ticketNum": "0017219022174", "pnr": null, "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-13", "totalFare": 501.41, "totalFareAmount": { "amount": 501.41, "currencyCode": "USD" }, "cancellationFee": null, "waiver": null, "operatorNotes": null, "refundType": null, "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": null, "refundableTotal": null, "note": "DEAL ENGINE HAS NO ACCESS TO THE IATA/GDS: AMADEUS/{IATA_CODE}", "requestedBy": "Agent_name", "eitherRefundStatus": { "left": "Error", "right": null }, "refundRoute": null, "miscFee": { "amount": 0, "currencyCode": "USD" }, "metadata": null, "toolNote": "DEAL ENGINE HAS NO ACCESS TO THE IATA/GDS: AMADEUS/{IATA_CODE}" }, // Scenario 4: Request has created a Refund Quote classified as SKIP due to no open flight segments { "ticketNum": "6053503106565", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-12", "totalFare": 86.29, "totalFareAmount": { "amount": 86.29, "currencyCode": "USD" }, "cancellationFee": null, "waiver": null, "operatorNotes": null, "refundType": null, "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": null, "refundableTotal": { "amount": 0.00, "currencyCode": "USD" }, "note": "NO OPEN FARE SEGMENT", "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "SKIP" }, "refundRoute": "BSP", "miscFee": { "amount": 0.00, "currencyCode": "USD" }, "metadata": null, "toolNote": "NO OPEN FARE SEGMENT" }, // Scenario 5: Request has created a Refund Quote with an involuntary waiver, pending agent review or robot query to getRefundCandidate { "ticketNum": "6056097732421", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-12", "totalFare": 76.83, "totalFareAmount": { "amount": 76.83, "currencyCode": "USD" }, "cancellationFee": null, "waiver": "INV REQ WAIVER", "operatorNotes": null, "refundType": "Full", "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": null, "refundableTotal": { "amount": 17.83, "currencyCode": "USD" }, "note": null, "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "REVIEW" }, "refundRoute": "BSP", "miscFee": { "amount": 0.00, "currencyCode": "USD" }, "metadata": null, "toolNote": null }, // Scenario 6: Request has created a Refund Quote, status has been changed to READY using updateRefundCandidate mutation // and is ready to be processed to the GDS (check refundRoute) using the processRefundNow mutation { "ticketNum": "1343047389204", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-11", "totalFare": 646.05, "totalFareAmount": { "amount": 646.05, "currencyCode": "USD" }, "cancellationFee": { "amount": 0.00, "currencyCode": "USD" }, "waiver": null, "operatorNotes": "GASTOS AD USD 20.00 + IGV", "refundType": "Full", "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": { "amount": 542.00, "currencyCode": "USD" }, "refundableTotal": { "amount": 646.05, "currencyCode": "USD" }, "note": null, "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "READY" }, "refundRoute": "GDS", "miscFee": { "amount": 0.00, "currencyCode": "USD" }, "metadata": null, "toolNote": null }, // Scenario 7: Refund Quote was enqueued to be fulfilled using the processRefundNow mutation, but failed to refund through BSP, flow ends here { "ticketNum": "0451705908797", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2023-10-31", "totalFare": 2642.00, "totalFareAmount": { "amount": 2642.00, "currencyCode": "MXN" }, "cancellationFee": null, "waiver": null, "operatorNotes": "Refund per fare rules", "refundType": "Full", "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": null, "refundableTotal": { "amount": 2443.00, "currencyCode": "MXN" }, "note": "BSP ERROR - APPLY MANUALLY", "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "ERROR" }, "refundRoute": "BSP", "miscFee": { "amount": 0.00, "currencyCode": "MXN" }, "metadata": null, "toolNote": "BSP ERROR - APPLY MANUALLY" }, // Scenario 8: Refund Quote was enqueued to be fulfilled using the processRefundNow mutation, but failed to refund through GDS // because a Worldspan printer is missing, flow ends here { "ticketNum": "0741613752194", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2023-11-01", "totalFare": 2231200.00, "totalFareAmount": { "amount": 2231200.00, "currencyCode": "COP" }, "cancellationFee": null, "waiver": null, "operatorNotes": null, "refundType": "Tax", "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": null, "refundableTotal": { "amount": 393600, "currencyCode": "COP" }, "note": "To issue the refund you need to assign a Worldspan printer, please contact support", "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "ERROR" }, "refundRoute": "GDS", "miscFee": { "amount": 0.00, "currencyCode": "COP" }, "metadata": null, "toolNote": "To issue the refund you need to assign a Worldspan printer, please contact support" }, // Scenario 9: Refund Quote was fulfilled in BSPLink and is pending authorization by the airline (full refund) { "ticketNum": "5443047368988", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-13", "totalFare": 235.69, "totalFareAmount": { "amount": 235.69, "currencyCode": "USD" }, "cancellationFee": { "amount": 0.00, "currencyCode": "USD" }, "waiver": null, "operatorNotes": null, "refundType": "Full", "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": { "amount": 158.00, "currencyCode": "USD" }, "refundableTotal": { "amount": 209.69, "currencyCode": "USD" }, "note": "BSP#: 1900643463 - Pending authorization", "requestedBy": "Agent_Name", "eitherRefundStatus": { "left": null, "right": "REFUNDED" }, "refundRoute": "BSP", "miscFee": { "amount": 0.00, "currencyCode": "USD" }, "metadata": null, "toolNote": "BSP#: 1900643463 - Pending authorization" }, // Scenario 10: Refund Quote was fulfilled in BSPLink and is pending authorization by the airline (tax refund) { "ticketNum": "5442218958647", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": "XXXXX", "requestDate": "2025-02-12", "totalFare": 228.35, "totalFareAmount": { "amount": 228.35, "currencyCode": "USD" }, "cancellationFee": null, "waiver": null, "operatorNotes": null, "refundType": "Tax", "freeText": null, "passengerName": "XXXXX", "refundableFare": null, "refundableTotal": { "amount": 45.35, "currencyCode": "USD" }, "note": "BSP#: 1900643302 - Pending authorization", "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "REFUNDED" }, "refundRoute": "BSP", "miscFee": { "amount": 0.00, "currencyCode": "USD" }, "metadata": null, "toolNote": "BSP#: 1900643302 - Pending authorization" }, // Scenario 11: Refund Quote was fulfilled in BSPLink and was authorised by the airline { "ticketNum": "6056097736778", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-10", "totalFare": 79.71, "totalFareAmount": { "amount": 79.71, "currencyCode": "USD" }, "cancellationFee": { "amount": 0.00, "currencyCode": "USD" }, "waiver": "w05", "operatorNotes": null, "refundType": "Full", "freeText": "W05", "passengerName": "XXXXX/XXXXX", "refundableFare": { "amount": 57.00, "currencyCode": "USD" }, "refundableTotal": { "amount": 79.71, "currencyCode": "USD" }, "note": "BSP#: 1900641911 - Authorised", "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "REFUNDED" }, "refundRoute": "BSP", "miscFee": { "amount": 0, "currencyCode": "USD" }, "metadata": null, "toolNote": "BSP#: 1900641911 - Authorised" }, // Scenario 12: Refund Quote was fulfilled in BSPLink and was rejected by the airline { "ticketNum": "5446097645328", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-02-06", "totalFare": 0.12, "totalFareAmount": { "amount": 0.12, "currencyCode": "USD" }, "cancellationFee": { "amount": 0, "currencyCode": "USD" }, "waiver": null, "operatorNotes": null, "refundType": "ReissuePartial", "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": { "amount": 259.00, "currencyCode": "USD" }, "refundableTotal": { "amount": 576.94, "currencyCode": "USD" }, "note": "BSP#: 1900641060 - Rejected", "requestedBy": "Agent_name", "eitherRefundStatus": { "left": null, "right": "REFUNDED" }, "refundRoute": "BSP", "miscFee": { "amount": 0.00, "currencyCode": "USD" }, "metadata": null, "toolNote": "BSP#: 1900641060 - Rejected" }, // Scenario 13: Refund Quote was fulfilled through the GDS (Sabre) { "ticketNum": "0443503102460", "pnr": "XXXXXX", "iataCode": "XXXXXXXX", "ndcOrderId": null, "requestDate": "2025-01-28", "totalFare": 0.00, "totalFareAmount": { "amount": 0.00, "currencyCode": "USD" }, "cancellationFee": { "amount": 313.50, "currencyCode": "USD" }, "waiver": null, "operatorNotes": null, "refundType": "Full", "freeText": null, "passengerName": "XXXXX/XXXXX", "refundableFare": { "amount": 1254.00, "currencyCode": "USD" }, "refundableTotal": { "amount": 1068.97, "currencyCode": "USD" }, "note": "Authorized via Sabre", "requestedBy": "Agent_Name", "eitherRefundStatus": { "left": null, "right": "REFUNDED" }, "refundRoute": "GDS", "miscFee": { "amount": 23.60, "currencyCode": "USD" }, "metadata": null, "toolNote": "Authorized via Sabre" } ] } } }