Skip to main content

Content Services for Rail - Exchange Estimate

Rail
Ticketing
REST API
Travel Agency
Try Now

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

  1. Send a request with exchangeCriteria, including an offerId, to the rail vendor system to obtain a list of exchangeContractOptions.

  2. The method returns detailed cost and status information in the form of ‘exchangeContractOptions’. exchangeContractOption has the same structure as refundContractOption, including the following information:

    • transactionContractId to be used in the following exchange confirmation request
    • transactionContractStatus
    • 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.