Questo endpoint serve a completare la richiesta aggiungendo ulteriori dati del cliente scritti nei propri documenti personali.
Sandbox: https://api.sandbox.soisy.it/api/shops/{shopId}/requests/{fiscalCode}
Produzione: https://api.soisy.it/api/shops/{shopId}/requests/{fiscalCode}
PATCH
shopId
e header X-Auth-Token
.Parametro | Obbligatorio | Tipo | Formato | Descrizione |
---|---|---|---|---|
documentOfType | Sì | Stringa | Tipo di documento. Valori consentiti: identity_card , driving_license , passport | |
documentCode | Sì | Stringa | Numero del documento | |
documentCity | Sì | Stringa | Città in cui il documento è stato emesso | |
documentIssueDate | Sì | Stringa | YYYY-MM-DD | Data di emissione del documento |
documentExpirationDate | Sì | Stringa | YYYY-MM-DD | Data di scadenza del documento |
iban | Sì | Stringa | Iban | |
politicallyExposed | Sì | Booleano | Specifica se l’utente è una Persona Politicamente Esposta (PPE) | |
usPerson | Sì | Booleano | Specifica se l’utente è un cittadino statunitense | |
marketing | Sì | Booleano | Specifica se l’utente gradisce ricevere informazioni su offerte commerciali e novità da parte di Soisy | |
profession | No | Stringa | Professione dell’utente |
Codice | Descrizione |
---|---|
200 | Richiesta completata con successo |
400 | Errore di sintassi o di dominio |
403 | Impossibile autenticare la richiesta |
500 | Errore di sistema |
{
"documentOfType": "identity_card",
"documentCode": "AR123456",
"documentCity": "Milano",
"documentIssueDate": "2010-04-23",
"documentExpirationDate": "2020-04-22",
"iban": "IT60X0542811101000000123456",
"politicallyExposed": false,
"usPerson": false,
"marketing": true,
"profession": "carpenter",
"paymentDayOfMonth": 15,
}
L’oggetto JSON restituito in caso di errore varia a seconda del codice HTTP di risposta.
Le risposte con questo codice HTTP indicano un errore lato client. La richiesta inviata conteneva un parametro formalmente errato.
{
"errors": {
{parametro}: [
{messaggio}
]
}
}
Parametro | Messaggio |
---|---|
documentOfType | Questo valore non dovrebbe essere vuoto. |
documentCode | Questo valore non dovrebbe essere vuoto. |
documentCity | Questo valore non dovrebbe essere vuoto. |
documentIssueDate | Questo valore non è una data valida. |
documentExpirationDate | Questo valore non è una data valida. |
iban | Questo valore non è un IBAN (International Bank Account Number) valido. |
politicallyExposed | Questo valore non dovrebbe essere nullo. |
usPerson | Questo valore non dovrebbe essere nullo. |
marketing | Questo valore non dovrebbe essere nullo. |
X-Auth-Token
. Trovi maggiori info sulle credenziali nel paragrafo dell’autenticazione.
{
"error": "Access denied"
}
Le risposte con questo codice HTTP indicano che si è verificato un errore di sistema.
{
"errors": {
"system": [
"System error"
]
}
}
Copyright 2023 SOISY S.p.A. - Sede Legale: Piazzale Libia, 1 - 20135 Milano
Indirizzo di posta elettronica certificata: postmaster@pec.soisy.eu - sito internet: www.soisy.it
Capitale sociale euro 391.620 i.v.
Codice Fiscale, Partita IVA e Numero di Iscrizione nel Registro delle Imprese di Milano-Monza-Brianza-Lodi: 08946260968
Istituto di Pagamento sottoposto al controllo ed alla vigilanza di Banca d’Italia e iscritto all’Albo IP ex art. 114 septies TUB: numero di iscrizione albo 78 e codice meccanografico 36060
Società appartenente al Gruppo Bancario Mediobanca iscritto all’Albo dei Gruppi Bancari
Socio unico: Compass Banca S.p.A.
Direzione e coordinamento: Mediobanca S.p.A.
Ciao!
Siamo on line dal lunedì al venerdì dalle 9.30 alle 12.30 e dalle 14.30 alle 17.30
Scrivici in questi orari, grazie!