Prerequisites

Merchant server

For security reasons related to payments and in order to avoid fraudulent operations, the embedded form relies on a merchant server that must be provided by you.

This server responds to several needs:

• Ensure that the transactions to be transmitted to the payment gateway correspond to purchases on your merchant website and that the amounts and currencies match.
• Securely store your communication keys with the payment gateway.
• Receive instant notifications from the payment gateway upon each payment event (accepted, rejected, etc.).

Authentication keys

Three keys are needed for authenticating your exchanges with the payment gateway:

Sign in to the Merchant Back Office

The keys are available in the Merchant Back Office. To access them, you must first connect to the Merchant Back Office. Users are identified with a login and password.

Finding the keys

You can retrieve your API keys and connection identifiers from the Merchant Back Office.

In the Settings > Shop menu, select your shop and go to the REST API keys tab.

The tab contains all the information required for authentication:

Keep production password

As soon as the first payment is made with a real card, the production password is hidden for security reasons. We strongly advise you to keep this password in a safe place (encrypted file, database etc.). In case of loss, the merchant will have the option to generate a new one from his Merchant Back Office. As a reminder, the production password is visible in the Merchant Back Office from the Settings > Store > REST API Keys tab.

Keys of server to server calls

The REST payment Web Services use Basic HTTP authentication for securing the calls between the merchant server and the payment gateway servers (see Authentication phase for more information). In order to proceed to authentication, you need a login and a password.

They can be retrieved in the REST API Keys tab of the Merchant Back Office:

For more information on the implementation, see Implementation using different programming languages.

The IPN signature is performed with the password. For more information, go here Use of IPN (notification URL).

I do not have an active account

If you do not yet have access to the Merchant Back Office, you can use demo key sets:

These keys are 100% functional. However, it is not possible to access the Merchant Back Office without having a personal account.