Crea una richiesta di pagamento sulla piattaforma Soisy.
Sandbox: https://api.sandbox.soisy.it/api/shops/{shopId}/requests
Produzione: https://api.soisy.it/api/shops/{shopId}/requests
POST
shopId
e header X-Auth-Token
.Parametro | Obbligatorio | Tipo | Formato | Descrizione |
---|---|---|---|---|
amount | Sì | Intero | Totale da richiedere, in centesimi di € | |
instalments | Sì | Intero | Numero di rate, da 3 a 60 | |
privacy | Sì | Booleano | Approvazione dell’informativa privacy da parte dell’utente | |
marketing | No | Booleano | Approvazione della policy marketing da parte dell’utente | |
fiscalCode | Sì | Stringa | 16 caratteri | Codice fiscale |
jobDescription | Sì | Stringa | Tipologia di lavoro. Valori consentiti: student , retired , unemployed , inheritance , entrepreneur , self_employed , seasonal_worker , freelance_professional , employee_open_ended_contract , employee_fixed_term_contract . | |
actualJobEndingDate | No* | Stringa | MM/YYYY | Data fine lavoro. Obbligatorio se jobDescription è employee_fixed_term_contract |
vatId | No* | Stringa | 11 caratteri | Partita IVA. Obbligatoria se jobDescription è entrepreneur |
vatCountry | No* | Stringa | 2 caratteri maiuscoli | Paese partita IVA. Obbligatorio se jobDescription è entrepreneur |
zeroInterestRate | No | Booleano | Abilita il tasso zero. (#) Se omesso, verrà utilizzato l’impostazione del Canale di Vendita. |
Codice | Descrizione |
---|---|
201 | Risorsa creata |
400 | Errore di sintassi o di dominio |
403 | Impossibile autenticare la richiesta |
404 | Risorsa non trovata |
500 | Errore di sistema |
{
"apr": ,
"fiscalCode": ,
"totalRepayment": ,
"instalmentAmount": ,
"zeroInterestRate":
"additionalDataNeeded":
}
Parametro | Tipo | Descrizione |
---|---|---|
apr | Intero | TAEG, in centesimi di € |
fiscalCode | Stringa | Codice fiscale |
totalRepayment | Intero | Totale da ripagare, in centesimi di € |
instalmentAmount | Intero | rata da pagare, in centesimi di € |
zeroInterestRate | Booleano | Indica se è attivo il tasso zero |
additionalDataNeeded | Booleano | Indica se sono richieste ulteriori informazioni nelle chiamate di Richiesta approvazione e Invio documenti |
{
"errors": {
{parametro}: [
{messaggio}
]
}
}
Parametro | Messaggio |
---|---|
amount | Questo valore dovrebbe essere compreso tra 5000 e 1500000 |
privacy | Questo valore dovrebbe essere uguale a “true”. |
jobDescription | Questo valore non dovrebbe essere vuoto |
actualJobEndingDate | Formato data non valido. Il corretto formato è il seguente: MM/YYYY |
vatId | La P.IVA deve essere una stringa |
Il codice paese della P.IVA deve essere una stringa | |
Il codice paese della P.IVA non è valido | |
La P.IVA non è valida per il paese | |
fiscalCode | Codice fiscale non valido |
instalments | Il numero di rate deve essere compreso fra 3 e 60 |
X-Auth-Token
. Trovi maggiori info sulle credenziali nel paragrafo dell’autenticazione.
{
"errors": "Authentication Failed"
}
La richiesta inviata non può essere completata. Maggiori informazioni sono contenuti nel messaggio d’errore.
{
"errors": "messaggio"
}
Le risposte con questo codice HTTP indicano che si è verificato un errore di sistema.
{
"errors": "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!