Authentication

Basic access authorization

Basic Access Authentication authenticates an application. It can be used by applications that keep the secret on the server side. The secret should never be exposed to the public. Do not use Basic Authorization if your frontend/client-side application communicates directly with the Shopping Service API.

Our system defines a set of permissions for your application based on its purpose.

Include the following request header in your Shopping Service API calls:

Authorization: Basic <app>:<secret>

To obtain credentials for your application, please contact your Client Success Manager.

Bearer token

A bearer token can be used safely in frontend applications that communicate directly with the Shopping Service API. Applications using this token will have limited privileges in our system. We use a JSON Web Token (JWT) as the bearer token. This token is created and signed by Paylogic.

Our system defines a minimal set of permissions for your application that allows retrieving all required information to display event and product details, creating orders for this event, and retrieving details of these orders.

Include the following request header in your Shopping Service API calls:

Authorization: Bearer <jwt token>

To obtain a JWT token for your application, please contact your Client Success Manager.

Cognito token

A Cognito Token represents a logged in user. The token allows access to all orders created by the user represented by the Access Token. This token can be acquired by authenticating a user in the Auth Service.

Include the following request header in your Shopping Service API calls:

Cognito-Token: <cognito access token>

Personalization request token

A Personalization request token allows you to personalize one or more tickets and it allows you to manage the Personalization request itself. You can obtain this token by creating a personalization request or by receiving a personalization request by email. This token is included in emails sent to a user to claim a ticket.

Include the following request header in your Shopping Service API calls:

Personalization-Request-Token: <personalization request token>

Order token

An Order token allows access to an order and its tickets. This token can currently not be obtained using the Shopping Service API. This token is included in emails sent to the user to view or manage an order.

Include the following request header in your Shopping Service API calls:

Order-Token: <order token>