Skip to content

    API

    Only when you automise certain processes related to your Nets Easy Paylink or One-Page-Shop, you will need to create an API signature to use the API.

    Coding: Some (Backend)

    Find the API Secret Key of your instance.

    This and the following steps are only relevant for you, if you want to automate your Paylink or One-Page-Shop payment processes by using the API. For most cases, the functionality provided through your Nets Easy Paylink account is sufficient.

    You find your API Key in your Nets Easy Paylink account after clicking "API & Plugins" on the left hand navigation column.

    Create your API signature

    Get your API Signature

    echo -n "HTTP-QUERY-STRING" | openssl dgst -sha256 -hmac "API-SECRET" -binary | openssl enc -base64

    Encoding of HTTP-Query String
    The query string has to be RFC1738 encoded. That means, you have to replace spaces by "+".

    For security reasons, when using the API, we want you to pass an API signature calculated with the API Secret of your instance.

    The API signature is HMAC encoded RFC 2104: spaces need to be represented as "+".

    The parameter name of this API signature should be ApiSignature. You can calculate the signature using all parameters except the instance parameter.

    • Build query string (e.g. model=Page&id=17)
    • Calculate binary hmac hash using your Nets Easy Paylink account's API Secret as key
    • Encode it with base64

    API base address

    The Nets Easy Paylink REST APIs are collected under the following base address:

    Requests

    The payload data has to be RFC 3986 URL encoded and spaces will be percent encoded "%20".

    Please not that the payload data and API signature must be encoded differently: The API signature is HMAC encoded RFC2104: spaces must be represented as "+".

    ParameterValue
    objectPaylink, Transaction
    idOnly used for request types GET, PUT and DELETE where only one entity gets modified.
    instanceThe Paylink instance name.

    For POST requests all query parameters except the instance have to be in the body.

    Please find a comprehensive list of endpoints and functionality in our API reference.

    HTTP CodeStatusMessage
    200OKEverything worked successfully!
    403ForbiddenThe API Signature is wrong
    404Not FoundThe requested endpoint does not exist

    All errors will return a JSON in the following format:

    JSON

    {
      status: "error",
      message: "An error occurred: Human readable message goes here"
    }