Menu
API - firma contratto
API - firma 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.
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}
]
}
}
