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
Expert Back Office : for example testpassword_HDBz5YpANEajG4DwYSmkQDNM9lzGiuvrhY9f6G9HEm5do.
The username and password are available in the
| 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
- Create a string presented as username:password
69876357:testpassword_DEMOPRIVATEKEY23G4475zXZQ2UA5x7M - Encode the obtained chain in base64
Njk4NzYzNTc6dGVzdHBhc3N3b3JkX0RFTU9QUklWQVRFS0VZMjNHNDQ3NXpYWlEyVUE1eDdN - 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:
{
"value": "my testing value"
}
Useful links
For more details on implementation in different languages, see the following Gitub gists .
