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 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
Note:
- Requests can be sent at any time to get new exchange contracts.
- Only orders which have assigned any
exchangeOptions
might be exchanged. To review the current status of an order, refer to the GET /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 /v1/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 deatils and a unique transactionContractId
to be used in the exchange confirmation process.