Entur Developer
Sales v2

New sales integration

This page is for partners building a sales integration with Entur for the first time. It explains how a sale moves through Sales v2 and which guides to follow.

Before you start, make sure you meet the access requirements for Sales v2.

Payment

Payment is optional. Take payment through Entur with the Payment API, or use your own PSP.

If you choose to use your own PSP, you will need to be authorized to import payments into the Entur sales platform. Read more in the Payment API documentation.

Sales lifecycle

A Sales v2 sale moves through these phases.

  1. Search for offers.
  2. Prepare a package for purchase. Use purchase-offers for a shortcut from offer -> purchasable package, or use select-offers, customise the draft, and finish with purchase-package.
  3. Take payment outside Sales v2, then call confirm-package.
  4. Retrieve the travel documents for the confirmed package with travel-documents.
  5. Handle later changes with cancellation, validity updates, or refunds.

Assets and ancillary products are normally assigned while the package is a draft. A mobility operator may also allow some changes after purchase.

No

Yes

search-offers

Customise the package?

purchase-offers

select-offers

assets or ancillaries

purchase-package

Take payment

confirm-package

travel-documents

Changes, cancellation, refunds

Guides

Step 1

Search offers
Model who is travelling and get your first offers.

Step 2

Make your first purchase
Prepare, pay for, and confirm a package.

Next steps

API reference

Sales v2 API reference
The full list of processes and collections.

Documentation

Authentication
Set up OAuth 2.0 client credentials for partner APIs.
Last modified on
Did you find what you were looking for?