Integrace API

Registrace nového obchodníka

Než může obchodník používat SDK, musí být zaregistrován v systému Tapaya. Obvykle se to provádí ve chvíli, kdy se uživatel zaregistruje do vaší služby. Obchodníka stačí zaregistrovat jednou. Registraci lze provést v Tapaya Platform UI nebo pomocí API.

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"
    }'

Parametry:

Odpovědi:

Tělo odpovědi:

{
    "merchantToken": "unique_merchant_id_from_your_db"
}

Vygenerování přihlašovacího tokenu

Aby mobilní zařízení mohlo inicializovat SDK pro konkrétního obchodníka, musíte vygenerovat krátkodobý přihlašovací token. Vaše mobilní aplikace si jej vyžádá od vašeho backendu a váš backend si jej vyžádá od Tapaya. Nový token potřebujete při každé inicializaci SDK.

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"
    }'

Parametry:

Odpovědi:

Tělo odpovědi:

{
    "token": "EesrFq4PUK1WxHUj93hkrKASDFp8GxJ0"
}

Předejte tento token své mobilní aplikaci, aby mohla SDK inicializovat. Do mobilní aplikace jej přeneste bezpečně a ihned po použití jej smažte. Token je vázán na obchodníka identifikovaného pomocí merchantToken.