API-Integration

Neuen Händler registrieren

Bevor ein Händler das SDK nutzen kann, muss er im Tapaya-System registriert sein. Das geschieht in der Regel, wenn sich ein Nutzer für Ihren Dienst registriert. Sie müssen den Händler nur einmal registrieren. Die Registrierung ist in der Tapaya Platform UI oder über die API möglich.

Endpoint: POST /merchant/auth/register

curl -X 'POST' 'https://api.tapaya.com/merchant/auth/register' \
-H 'Content-Type: application/json' \
-H 'Authorization: REPLACE_ME' \
-d '{
        "merchantToken": "unique_merchant_id_from_your_db",
        "merchantName": "Acme Corp",
        "email": "admin@acme.com"
    }'

Parameter:

Antworten:

Antwort-Body:

{
    "merchantToken": "unique_merchant_id_from_your_db"
}

Login-Token erzeugen

Damit ein Mobilgerät das SDK für einen bestimmten Händler initialisieren kann, müssen Sie ein kurzlebiges Login-Token erzeugen. Ihre mobile App fordert es bei Ihrem Backend an, und Ihr Backend fordert es bei Tapaya an. Bei jeder Initialisierung des SDK benötigen Sie ein neues Token.

Endpoint: POST /merchant/auth/login

curl -X 'POST' 'https://api.tapaya.com/merchant/auth/login' \
-H 'Content-Type: application/json' \
-H 'Authorization: REPLACE_ME' \
-d '{
        "merchantToken": "unique_merchant_id_from_your_db",
        "allowOnboarding": true,
        "employeeEmail": "john@acme.com"
    }'

Parameter:

Antworten:

Antwort-Body:

{
    "token": "EesrFq4PUK1WxHUj93hkrKASDFp8GxJ0"
}

Übergeben Sie dieses token an Ihre mobile App, um das SDK zu initialisieren. Übertragen Sie es sicher an die mobile App und löschen Sie es unmittelbar nach der Verwendung. Das Token ist an den Händler gebunden, der durch merchantToken identifiziert wird.