Integrazione API

Registrare un nuovo esercente

Prima di poter usare l'SDK, un esercente deve essere registrato nel sistema Tapaya. Di solito ciò avviene quando un utente si registra al Suo servizio. È sufficiente registrare l'esercente una sola volta. La registrazione può essere effettuata nella Tapaya Platform UI oppure tramite l'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"
    }'

Parametri:

Risposte:

Corpo della risposta:

{
    "merchantToken": "unique_merchant_id_from_your_db"
}

Generare il token di accesso

Per consentire a un dispositivo mobile di inizializzare l'SDK per un determinato esercente, deve generare un token di accesso di breve durata. La Sua app mobile lo richiede al Suo backend, e il Suo backend lo richiede a Tapaya. Serve un token nuovo ogni volta che l'SDK viene inizializzato.

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

Parametri:

Risposte:

Corpo della risposta:

{
    "token": "EesrFq4PUK1WxHUj93hkrKASDFp8GxJ0"
}

Passi questo token alla Sua app mobile per inizializzare l'SDK. Lo trasferisca all'app mobile in modo sicuro e lo elimini subito dopo l'uso. Il token è vincolato all'esercente identificato da merchantToken.