Autenticazione

In questa sezione viene illustrato come autenticarsi alla piattaforma GEL Proximity con un utenza Merchant per usufruire delle funzionalità messe a disposizione.

Per autenticarsi alla piattaforma GEL Proximity è necessario essere in possesso delle chiavi di accesso generate in automatico dal sistema a seguito della creazione di un account.

Nel caso non si sia in possesso di un account è necessario completare il processo di onboarding o contattare il supporto di GEL Proximity. Per maggiori informazioni consultare la sezione Introduzione Merchant.

Per effettuare qualsiasi richiesta alla piattaforma di GEL Proximity è necessario richiedere un Access Token effettuando una chiamata API all’endpoint indicato.

Parametri

Endpoint gel-api-server/api/merchant/autenticate
Metodo POST

Request

Nome Tipo Obbl. Default Descrizione
merchantCode string Si – Codice univoco del Merchant
apiKey string Si – Secret Key del Merchant 
{
  "merchantCode": "MER_PW2E5I",
  "apiKey": "27at1waz-1r77-112e-945c-466zwq09kl67",
}

Response

Nome Tipo Descrizione
success boolean Esito della richiesta
message string Messaggio di risposta
data AccessToken Dati restituiti

AccessToken

Nome Tipo Descrizione
accessToken string Token di accesso
tokenType string Tipologia di token
expiresIn number Tempo di scadenza del token in secondi 
{
  "success": true,
  "message": "Operazione completata",
  "data": {
    "accessToken": "a8yRu.q8up0vYR6h35Yaq.0PGbT",
    "tokenType": "Bearer",
    "expiresIn": 3600
  }
}

Una volta ottenuto l’Access Token è necessario inserirlo nell’header di ogni richiesta che verrà effettuata alla piattaforma di GEL Proximity.

Il token di accesso ha una scadenza indicata dal parametro expiryDate restituito dall’API di generazione del token stesso. Una volta che l’Access Token è scaduto sarà necessario richiederne un’altro con le stesse modalità.

{
  "Header": {
    "Authorization": "Bearer a8yRu.q8up0vYR6h35Yaq.0PGbT",
    ...
  }
}