What is it?
The exchange process consists of 3 steps:
1. Exchange offers search
2. Exchange estimate
3. Exchange confirm
This method is the second step in the exchange process. Based on the criteria provided, the Exchange Estimate API returns estimated costs for the exchange operation, in the form of exchangeContractOptions
Why use it?
Use this method to estimate costs related to the exchange operation.
How it works
-
Send a request with
exchangeCriteria
, including anofferId
, to the rail vendor system to obtain a list ofexchangeContractOptions
. -
The method returns detailed cost and status information in the form of
exchangeContractOptions
.exchangeContractOption
has the same structure asrefundContractOption
, including the following information:transactionContractId
to be used in the following exchange confirmation requesttransactionContractStatus
refundedTicketsBalance
newTicketsBalance
charges
paymentBalances
Notes:
- Requests can be sent at any time to get new exchange contracts.
- Only orders that have
exchangeOptions
assigned may be exchanged. To review the current status of an order, refer to theGET /v1/rail/orders/{marketingCarrierCode}/{orderId}
method. - Each exchange contract expires within 15 minutes in the rail system.
Caution: Consuming this API and its content requires special permission. Before requesting access, please make sure you have all the necessary agreements in place with the rail vendor(s) you would like to sell using Content Services for Rail. For more information on accessing Sabre Rail content and rail supplier contacts, please visit the respective product page on Sabre Central.
Vendor | Code | Payment via API | Notes |
---|---|---|---|
SNCF | 2C | No | “On account” only. Direct settlement with agency. No individual or corporate credit cards. |
How to use
Method
POST /v2/rail/orders/{marketingCarrierCode}/{orderId}/exchangeContracts
Request
Provide one exchangeCriteria
element containing:
exchangeOfferCriteria
element, the same as in the preceding exchange offers request- Selected offer from the exchange offers response by its
offerId
- Delivery method
Response
Returns a new exchangeContractOptions
with exchange cost estimation details and a unique transactionContractId
to be used in the exchange confirmation process.