Issuing API (v4) Migration Guide

When migrating your Issuing client application from v3 to v4 of the Issuing API the following changes should be considered:

Products

When requesting product information, a new property pricingEngine in the response will show the pricing engine that is used to perform the fare calculation with /v4/journey/price. The pricingEngine will not be present in the response for a product with no pricing engine.

Journeys

• /v4/journey/price is a new endpoint available on (v4). The endpoint can be used to perform fare calculation on a planned route. The endpoint can only be used on products with a definition that are of type station-to-station and pricing engine Accept Institute. A property validUntil in the response will indicate the expiry time of the price for the given journey.
• /v4/journey/create is a new endpoint available on (v4). The endpoint can be used to create a ticket from a priced journey. The response from endpoint /v4/journey/price is used as request to this endpoint. The authenticity of the request will be validated against the signature value. The issued ticket will be valid for a full day on the planned day of travel, including extended business hours.