• France
payzen.eu
Search
Categories
Tags
Europe (English)
France
Germany
Brazil
LATAM
Spain
Europe (English)
Implementation
Embedded form (cards)
REST payment API
REST PCI-DSS payment API
REST SEPA API
Hosted payment
File exchange
Mobile payment
Snippets
Plugins
Back office
Guides
Help
FAQ
Video tutorials
Support

Authentication phase

Each call requires an authentication based on the HTTP Basic Authentication method.

This method uses the Authorization HTTP header consisting of the word Basic followed by a string encoded in base64 containing a username and a password separated by a colon (:).

  • The username is the shop identifier, for example: 28478261
  • The password is defined in the Merchant Back Office : for example testpassword_HDBz5YpANEajG4DwYSmkQDNM9lzGiuvrhY9f6G9HEm5do.

The username and password are available in the Merchant Back Office, Settings > Shop menu, REST API keys tab.

PARAMETER DESCRIPTION
User Username for building the header Authorization string.
Test password Password allowing to build the Authorization header string for test transactions (with test cards).
Production password Password allowing to build the Authorization header string for production transactions (with real cards).

How to build the "Authorization" HTTP header

  1. Create a string presented as username:password
    69876357:testpassword_DEMOPRIVATEKEY23G4475zXZQ2UA5x7M
  2. Encode the obtained chain in base64
    Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN
  3. Add the "Authorization" header to your request containing the word "Basic" followed by the string encoded in base64:
    Authorization: Basic Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN

In PHP, the Authorization header will be calculated as follows:

$header = "Authorization: Basic " . base64_encode($username . ':' . $password);

The full HTTP request will look like this:

/en-EN/rest/V4.0/api/kb/authentication.html
https://github.com/lyra/rest-php-examples/blob/master/www/SDKTest.php#L16-L26
https://api.payzen.eu/api-payment/V4/Charge/SDKTest
{
    "value": "my testing value"
}

Useful links

For more details on implementation in different languages, see the following Gitub gists.

Head Office :

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

Our SERVICES

Lyra
Recruitment
PayZen
© 2023 | All rights reserved to PayZen
2.9.0-doc-1.8