Sign in
latestOpenAPI 3.0.12026-08-102668257.3 KB

8e9a8f8010ab

Refund

Refund Quotation

Dependency No preceding function needs to be carried out.

Introduction

The Refund section includes a series of steps required for refunds, including requesting a refund quote, submitting the refund, and returning the refund status and results. This service supports the submission of requests for cancellation that require Atlas to process or for refunds that need to be executed by Atlas. It also allows a variety of cancellation and refund types, including voluntary, involuntary and void, etc.

Features

  • Refund reason: Voluntary, Involuntary, Void
  • Service Level: ◦ Our refund quotations fall into three scenarios: a. We can obtain an accurate quotation from the airline and will quote it directly to you; b. We cannot obtain an accurate quotation through the airline. You can still submit the refund request, then we will process the refund, but the refund amount will be based on the actual amount refunded by the airline; c. Unrefundable ◦ Our refund service includes the below steps, a. Atlas submits the refund request to the airline: We provide a service time guarantee; b. Airline processes the refund request and responds with the result, and airline executes the refund. The duration for 2 steps depends on the airline's processing speed, and we will provide an estimated reference time based on our experience in handling such cases.

Please note the below while initiating a refund transaction.

  1. Refund of either inbound or outbound sector: The full ticket needs to be refunded. Only outbound OR inbound sector cannot be refunded. Please contact the airline for the same.
  2. Refund for a partially used itinerary: Partially used itinerary cannot be refunded. Please contact the airline for the same.
  3. Refund for a specific passenger: We support the refund of a specific passenger in an itinerary. For example, if there are 3 passengers and only one of them is to be refunded, please send us your refund request.
  4. Apart from voluntary, involuntary and void, we currently do not support other types of refunds, such as medical or death refunds. Please contact customer service for manual assistance.
  5. The customer is responsible to check whether the traveler has already made ancillary purchase in the transaction.
  6. No email notifications will be sent for refunds rejected by Atlas.

Endpoint: https://sandbox.atriptech.com/refundQuotation.do

post/refundQuotation.do

Headers

Acceptstring required
Content-Typestring required
Accept-Encodingstring required
x-atlas-client-idstring required
x-atlas-client-secretstring required

Request body

orderNostring nullable required

Atlas original order number. You can choose to request either orderNo or both airlinePNR and carrier. If you use orderNo, the airlinePNR and carrier fields may be null.

airlinePNRstring nullable required

The record locator of the airline. You can choose to request either orderNo or both airlinePNR and carrier. If you use airlinePNR and carrier, the orderNo field may be null.

carrierstring nullable required

2 character IATA airline code. you can choose to request either orderNo or both airlinePNR and carrier. If you use airlinePNR and carrier, the orderNo field may be null.

Response

status0 | 2 required

Status code. 0 : Success 801：Order not found for refund. Check the original main ticket order number. 802：Child cannot travel alone on this booking. Contact airline directly for resolution. 803：Refund already submitted for this passenger or segment. Query refund status instead. 804：All segments of the same PNR must be submitted together. Include all segments and retry. 8041：Segment not found in this order. Verify segment details match the original booking. 805：refundOfferId expired. Call refundOffer.do again for a fresh ID, then resubmit. 806：Please submit Self Refund instead. 807：Passenger not found in this order. Verify passenger details match the original booking. 808：This ticket is non-refundable per airline policy. 809：Order not yet ticketed. Wait until orderQuery.do returns order_status=2 before refunding. 810：Invalid request parameters 811：Incomplete itinerary: all legs/segments required. Resubmit with full round-trip or connection. 812：Refund passenger details are inconsistent with the original booking 813：Illegal refund offer state 814：Refund submission already in progress. Wait before retrying. 815：Ticket not found. Verify ticket number and order number. 816：Refund already submitted for this order. Query refund status instead of resubmitting. 817：Refund already submitted for this order. Query refund status instead of resubmitting. 818：Refund already submitted for this order. Query refund status instead of resubmitting. 819：Refund claim not supported for this payment method. Use an alternative refund method. 820：Ticket already used — cannot refund a flown segment. 821：Refund deadline exceeded. This ticket is no longer eligible for refund. 822：Refund deadline exceeded. This ticket can no longer be refunded. 823：Refund must apply to all passengers — partial refund not allowed. Include all pax and retry. 824：Wrong orderNumber: use the main ticket order, not the ancillary order number. 825：For voluntary refunds after departure, submit a refund booking through the Flight Deck. 826：Unable to confirm airline tax refund status. Refund request cannot be processed. 840：Client cancellation criteria not met. Check account cancellation policy. 841：Refund not support the payment method. Please contact the airline directly for resolution. 842：Atlas does not currently support REFUND service for the airline or route of this booking. 843：Atlas does not currently support refund service for the airline or route of this booking.

msgstring nullable

Error message The ‘msg’ element is for description of the results. Please do not use this field to check the success or failure of the request. Only use the ‘status’ code to check the result.

fastConfirmation0 | 1 required

Fast confirmation depends on whether the airline supports auto fulfillment. 0 for False, 1 for True.

expectedConfirmationDatestring required

Expected date of getting airline refund confirmation. The format is yyyyMMdd.

expectedRefundDatestring required

Expected date of getting refund. The format is yyyyMMdd.

refundQuoteType'AccurateQuote' | 'CannotQuote' required

Type of refund quote:

  • AccurateQuote：quotation based on the calculated amount.
  • CannotQuote: quotation is unknown and will be according to the airline's rates
refundOfferIdstring required

Refund offer id for this quotation which can be used for the coming refund call.

refundMethod'CashBackToOriginalPayment' | 'Voucher' required

Refund method: CashBackToOriginalPayment or Voucher.

  • CashBackToOriginalPayment: Refund cash back to the original form of payment.
  • Voucher: Refund in the form of a voucher.
orderNostring required

Original order number

isRefundableboolean required

True : Refundable False: Non-Refundable true or false