Description

Get list of supported discount cards by type or carrier ID

This endpoint allows you to retrieve all the discount cards, vouchers, loyalty cards and others supported in booking/reservation flows.

Requests to this endpoint can include filters to fetch selected types of cards, cards supported by particular set of marketing carriers, or to fetch one particular card by its name.

How it Works

Particularly in rail transport, it is common for carriers to offer discounts in the form of loyalty cards, vouchers or other mechanisms. Distribusion supports retrieving and booking these reduced fares through the API.

Types of supported discounts

Distribusion supports several types of discounts/special offers:

• Discount cards: with fixed discount value or percentage e.g. Eurostar/SNCF Corporate and Negotiated Fares. Deutsche Bahn’s Bahncard 50, Trenitalia’s Carta Verde, or PKP’s Big Family Card. This type of discount may require the input of proof and/or an association with a particular passenger type, e.g. a student discount might require the input of a student ID number and Adult as a passenger type.
• Loyalty programs: E.g. Amtrak Guest Rewards
• One-time vouchers, promo codes: E.g. summer campaign voucher

Detailed information about the discounts supported by a specific carrier can be fetched via /cards endpoint. Information retreived from this endpoint is useful to generate descriptions and input fields to be displayed in the user interface.

Parameters characterising discounts

• card_type: Type of an offer: discount_card, loyalty, other
• name: Unique name-id of the card
• marketing_name: Localized text name of the discount card that can include spaces or special characters
• supported_carriers_fares[]: List of marketing codes of carriers and fare classes, for filtering compatible offers
• requires_code: Boolean - if a card number/code needs to be validated during ordering to successfully add the card
• requires_presenting_card: Boolean - if passenger is required to keep and present the card along with the ticket for it to be valid
• context: Specifies the entity to which the card will be bound to provide its resulting advantage. Available options: Pax, Segment, Booking
• description: Localized text description of given discount/promo

API Workflow

Discounts can be leveraged through the API by filling the optional parameters at each step of the search and book workflow:

1. Fetch supported discount card types from the /cards endpoint
2. Search for a trip with /connections/find and specify the precise passenger types and cards. The price returned will include the corresponding discount.
3. When confirming the availability with the /connections/vacancy, again specify the applied discount cards.
4. Create the reservation with the /reservations/create endpoint while specifying the applied discount cards.

Note

Please note that this is an enterprise API feature - reach out to your Partnership Manager for more information about unlocking this and other advanced features.

More Info

• Full API integration
  • Basic workflow
• Key Concepts
  • Discount cards
    • Types of supported discounts
    • Parameters characterising discounts
    • API workflow
  • Currencies and locales
• Endpoints
  • GET /retailers/v4/cards