Richiedi i termini del contratto

Con questo puoi recuperare le clausole che l'utente deve accettare al fine di generare un certificato di firma. La chiamata restituirà un elenco di clausole che l'utente dovrà vedere e accettare espressamente. Dovrai poi inviarci la risposta dell'utente (cioè l'accettazione) nella successiva chiamata.

Richiesta

Endpoint

Sandbox: https://api.sandbox.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/terms-and-conditions
Produzione: https://api.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/terms-and-conditions

Metodi accettati

GET

Autenticazione

Questa API richiede l'autenticazione tramite shopId e header X-Auth-Token.

Prerequisiti

Per accedere a questo endpoint è necessario aver completato i dati del cliente.

Risposta

L'API restituisce un oggetto JSON.

Codici HTTP di risposta

Codice Descrizione
200 Richiesta completata con successo
400 Errore di sintassi o di dominio
403 Impossibile autenticare la richiesta
500 Errore di sistema

Risposta valida

{
    "clauses": {
      "termAndCondition": "Il/La sottoscritto/a, consapevole delle sanzioni penali previste...",
      "misleadingClaims": "Il/La sottoscritto/a, ai sensi e per gli effetti degli artt. 1341 e 1342 c.c, dichiara...",
    },
    "links": [
      {"url": "https://docs.namirialtsp.com/documents/Mod.NAMCA01D_ITA.pdf", "name": "Condizioni generali di contratto (Mod.NAMCA01D_ITA)"},
      {"url": "https://docs.namirialtsp.com/documents/Mod.NAM_CA22D.pdf", "name": "Modulo di richiesta (Mod.NAM_CA22D)"},
    ]
}

Risposta di errore

L'oggetto JSON restituito in caso di errore varia a seconda del codice HTTP di risposta. La descrizione dell'errore messaggio cambierà a seconda dell'errore generato dalla Certification Authority.

 {
     "errors": {
         "domain": [
             {messaggio}
         ]
      }
 }