Authentication

HTTP basic access authentication

Authorization of requests is done via HTTP basic access authentication.

TWVyY2hhbnRJRDpBUElLZXk= is the base64 encoded version of "MerchantID:APIKey".

A merchant Id could look like Merchant-00000000-0000-0000-0000-00000000, and an API key could look like xXxXxXxXxXxXxXxX.

The merchant Id and the API Key can be found in the Payengine Merchant Center under "My Account".

First connection

Now that we know how to authenticate we will try our first connection.

Following examples are using curl to establish a connection. We will now establish the first connection to the API.

curl --user MerchantID:APIKey https://apitest.payengine.de/v1/customers

The response should look like following:

{
    elements: []
    totalpages: 1
}

Since it is the first request, no customer data can be returned.

https://apitest.payengine.de/v1 is the test system which should always be used for development purposes.

The live api endpoint would be https://api.payengine.de/v1.