• France
lyra.com
Search
Categories
Tags
docs.
France
Spain
Europe (English)
India
Home
Implementation
Embedded form (cards)
REST payment API
REST PCI-DSS payment API
REST SEPA API
Hosted payment
Data collection form
File exchange
Mobile payment
Snippets
Plugins
Marketplace
Back Office
Merchant Back Office
Expert Back Office
Guides
Help
FAQ
Video tutorials
Support

Authentication

Identification is performed by means of an HTTP header.

The used method is HTTP Basic Authentication.

In each HTTP request, the header must contain information allowing the merchant to authenticate via the SEPA Web Service.

Description of HTTP headers:

Table 1. Description of HTTP headers
Header Description Create a mandate View mandate details Download a mandate Update a mandate
Accept Determines the format of the content that will be returned by the server.

REST architecture that allows to perform data exchange in JSON format

'Accept:application/ json' 'Accept:application/ json'

'Accept:application/octet-stream'

Note:

In response to the http request, a binary response (pdf) is expected

'Accept:application/ json'
Authorization

Contains the user authentication token.

It is composed of:

  • Site_id; Shop ID (target point of sales).
  • Certificate: Value of the TEST or PRODUCTION key.

This information is encoded in Base64.

Note:

The Site_id and Certificate values are available in your Back Office.

  • Site_id: Settings > Shop > Configuration tab.
  • Certificate: Settings > Shop > Keys tab.
The key value determines a test or production request.

Example of an authentication token encoded in Base64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Example of an authentication token encoded in Base64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Example of an authentication token encoded in Base64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Example of an authentication token encoded in Base64:

"Basic MTIzNDU2Nzg6OTk

5OTk5OTk5OTk5O

Tk5OQ==

Content-type Determines the format of the content sent to the server.

'content-type:application/json'

'content-type:application/json'

'content-type:application/json'

'content-type:application/json'

Here are the steps for building a header:

  1. Use the Basic Authentication method.
  2. Specify the used method in the Authorization header: Basic followed by the Base64 representation of the Site_id and Certificate values separated by the “:” character.
  3. Encode the obtained result in Base64.
  4. Add the result to the chain in “Basic”.

    Note:
    Make sure to use a space character after Basic.
Recruitment

Head Office :

LYRA NETWORK
109, rue de l’innovation
31670 Labège
FRANCE

2.8.1-doc-1.8