退款
Atlas API 退款端点参考，用于获取退款报价、提交退款请求并跟踪退款处理状态。
常见问题
何时应使用退款而不是作废？
提交退款前应确认什么？
退款流程中应保留哪些标识符？
相关指南
application/jsonapplication/jsongzipExample: gzip<YOUR_CLIENT_ID>Example: <YOUR_CLIENT_ID><YOUR_CLIENT_SECRET>Example: <YOUR_CLIENT_SECRET>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.
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.
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.
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.
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.
Fast confirmation depends on whether the airline supports auto fulfillment. 0 for False, 1 for True.
Expected date of getting airline refund confirmation. The format is yyyyMMdd.
20241217Expected date of getting refund. The format is yyyyMMdd.
Type of refund quote:
- AccurateQuote：quotation based on the calculated amount.
- CannotQuote: quotation is unknown and will be according to the airline's rates
Refund offer id for this quotation which can be used for the coming refund call.
Refund method: CashBackToOriginalPayment or Voucher.
- CashBackToOriginalPayment: Refund cash back to the original form of payment.
- Voucher: Refund in the form of a voucher.
Original order number
True : Refundable False: Non-Refundable true or false
application/jsonapplication/jsongzipExample: gzip<YOUR_CLIENT_ID>Example: <YOUR_CLIENT_ID><YOUR_CLIENT_SECRET>Example: <YOUR_CLIENT_SECRET>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.
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.
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.
The alternative currency in which the fare and taxes amount needs to be displayed. The 3-letter currency code should be entered.
Get this from the refund quotation response. You can request with refundOfferId or refundRequestList. If you use refundRequestList, the field refundOfferId is null.
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.
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.
The alternative currency in which the fare and taxes amount needs to be displayed. The 3-letter currency code should be entered.
Fast confirmation depends on whether the airline supports auto fulfillment. 0 for False, 1 for True.
Expected date of getting airline refund confirmation. The format is yyyyMMdd.
20241217Expected date of getting refund. The format is yyyyMMdd.
Type of refund quote:
- AccurateQuote：quotation based on the calculated amount.
- CannotQuote: quotation is unknown and will be according to the airline's rates
Refund offer id for this quotation which can be used for the coming refund call.
Refund method: CashBackToOriginalPayment or Voucher.
- CashBackToOriginalPayment: Refund cash back to the original form of payment.
- Voucher: Refund in the form of a voucher.
Original order number
True : Refundable False: Non-Refundable true or false
The present status of the refund. The options are: 0: Atlas Processing 1: Airline Processing (Submitted to airline by Atlas) 2: Refunded 3: Airline Refunding 4: Rejected 5: Fullfillment Done 6: Withdrew If the ticket is paid by deposit: the status can be 0,1,2,3,4 If the ticket is paid by VCC pass through: the status can be 0,1,4,5,6 Withdrew is only in the refund claim
Refund order number generated for this refund request
The reason why the refund was cancelled. The refund reasons are: Does not match airline policy There is no schedule change from the airline side. Please refer the ticket Fare Rules available in ATRIP flight deck for cancellation charges. Voluntary Cancellation - Non-Refundable As per airline policy, only voucher refund is available for the ticket Refund request cancelled by the user Travel has been completed by the passenger Refund not yet received from the airline. Please try again later.
Refund reason 0: Involuntary 1: Voluntary 4: Void
application/jsonapplication/jsongzipExample: gzip<YOUR_CLIENT_ID>Example: <YOUR_CLIENT_ID><YOUR_CLIENT_SECRET>Example: <YOUR_CLIENT_SECRET>The code of the refund transaction received in the refund.do response.
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.
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.
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.
The alternative currency in which the fare and taxes amount needs to be displayed. The 3-letter currency code should be entered.
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.
Error message
Last updated
Was this helpful?