Environments and Testing

Environments

Test Environment

The test environment is available at https://api-tiqt-test.steq.it/v2/. API users are free to create orders in this environment. The same usage restrictions as in production regarding rate limiting and caching as described below apply. Also for the test environment, an API key must be provided by your account manager.

Vouchers obtained through this API are for tests only.

Production Environment

The production environment is available at https://api.tiqets.com/v2/. A separate API key will be issued for this environment after the product demo and contracts are validated. The key used to sign the purchases should be different from that in the test environment.

Orders created and confirmed in this environment are final! Please carefully review the rate limits and caching practices.

Testing

Products

The API test environment runs independently from our production environment. In the test environment, we maintain availability for a small number of products that are configured specifically for testing Availability & Pricing API and Booking API.

The following products can be used in the test environment:

• Product ID 1006356 The Museum of Cognitive Dissonance can be used to test products with common scenario and variant grouping:

  • Variant 38100 will always result in a successful order

  • Variant 38102 will always result in an order that remains pending

  • Variant 38104 is an add-on and will always available for order

  • Variant 38285 will always have 11 minutes ticket delivery delay

• Product ID 974282 can be used to test orders with grouped variants in different languages and an addon that is available for all variants

• Product ID 1006518 Office vs. Officer can be used to test products with timeslots:

  • Variant 38270 will always result in a successful order

  • Variant 38271 will always result in an order that remains pending

• Product ID 1010393 can be used to test orders with a product that uses different variant IDs for weekdays (Monday - Friday) and weekends (Saturday - Sunday)

• Product ID 1006521 Planet Earth: Apocalypse Tour + Transport can be used to test orders with full_name visitor details:

  • Variant 38280 will always result in a successful order

  • Variant 38281 will only valid for orders with variant 17864

  • Variant 38282 is an add on and will always available for order

  • Variant 38283 will have seasonal price changes on the first of March, June, September, and December

• Product ID 929249 can be used to test orders with full_name & date_of_birth visitor details

• Product ID 975244 can be used to test orders with full name & passport_ids visitor details

• Product ID 975854 can be used to test orders with pickup_location

• Product ID 974522 can be used to test orders with full_name, passport_id, passport_ids, date_of_birth, nationality, address, zipcode, pickup_location, dropoff_location, flight_number, email, phone

• Product ID 1006523 Institute of Dynamic Happiness can be used to test orders with dynamic_pricing:

  • Variant 38286 will always result in a successful order

  • Variant 38287 will always have 11 minutes ticket delivery delay

• Product ID 1006524 Dream Simulator can be used to test orders with dynamic_pricing and timeslots:

  • Variant 38288 will always result in a successful order

• Product ID 1006522 Amsterdam's Mountain Phew: VR Experience will never be available, this product is meant to simulate out of season products

• Product ID 1006525 Half-Day Boat & Snorkeling Tour from Amalfi to Positano can be used to test orders with with failing fulfilment:

  • Variant 38289 will stay pending upon confirmation for 5 seconds and then will switch to failed

Use cases

We recommend testing the following common use cases; the actual use cases might vary depending on your individual implementation.

Content API:

• Retrieve content using all search filters applicable for your implementation

Availability & Pricing API:

• Retrieve availability and pricing for the next three months and cache the data

  • for a product without timeslots

  • for a product with timeslots

  • for a product with dynamic pricing

  • for a product without availability

Booking API:

• Create an order

  • for a product that does not require additional checkout fields

  • for a product that does require additional checkout fields

  • for a product that uses dynamic pricing

  • for a product variant that is only valid in combination with another variant

  • for a product variant that remains pending (and therefore cannot be confirmed)

• Confirm an order

• Retrieve tickets

  • for a product variant that has instant ticket delivery

  • for a product variant with a ticket delivery delay

• Cancel a confirmed order

• Retrieve order information for one order

• Retrieve order information for a list of orders

• If you support creating orders without customer data:

  • Create an order without customer data

  • Add customer data

  • Confirm order

Live test

All test scenarios should be tested in the test environment. In case a test is needed in the production environment, we provide test product 1006356 The Museum of Cognitive Dissonance to test a successful order.

If you want to do a test order for a live product in the production environment, please check with your account manager first. If agreed, please note the following:

• Do not create more than one test order for a given product.

• Choose a product that allows cancellations.

• Choose a date that is as far in the future as possible and gives you a comfortable window to perform the cancellation through API.

• Any fulfilled order for a live product results in valid tickets. It is your responsibility to cancel the order within 24 hours after creation. If the order is not cancelled, you will be invoiced for it.