Skip to content

    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.

    Connection to the API

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

    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.

    The response should look like following:

    curl response

    {
        elements: []
        totalpages: 1
    }

    Since it is the first request there are no customers whom could 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.