This endpoint is for uploading customer documents. Our application will store the documents and respond with a success code in case everything went well or with a code and an error message if not.
Sandbox: https://api.sandbox.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/documents
Produzione: https://api.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/documents
POST
shopId
and headerX-Auth-Token
.Parameter | Obligatory | Guy | Format | Description |
---|---|---|---|---|
identityFrontFile | Yup | Image | Jpg, Png, Pdf | Front image of the ID card |
identityBackFile | Yup | Image | Jpg, Png, Pdf | Image of the back of the ID card |
fiscalCodeFrontFile | Yup | Image | Jpg, Png, Pdf | Front image of the tax code |
fiscalCodeBackFile | Yup | Image | Jpg, Png, Pdf | Image of the back of the tax code |
selfieFile | Yup | Image | Jpg, Png, Pdf | User selfie |
incomeDeclarationFile | No* | Image | Jpg, Png, Pdf | A user income document. Required ifadditionalDataNeeded istrue . The pay slip, the CUD, the 730 or the Unico model are valid |
residencePermitFile | No* | Image | Jpg, Png, Pdf | Residency permit. Mandatory for users outside the European Community. |
Code | Description |
---|---|
201 | Resource created |
400 | Syntax or domain error |
403 | Failed to authenticate the request |
500 | System error |
[
{"fileName: "identityFrontFile", "id": },
{"fileName: "identityBackFile", "id": },
{"fileName: "fiscalCodeFrontFile", "id": },
{"fileName: "fiscalCodeBackFile", "id": },
{"fileName: "selfieFile", "id": },
{"fileName: "incomeDeclarationFile", "id": },
{"fileName: "residencePermitFile", "id": },
]
The JSON object returned in the event of an error varies depending on the HTTP response code.
Responses with this HTTP code indicate a client-side error. The submitted request contained a formally incorrect parameter.
The following errors are possible for each parameter :
Failure to send the parameter
{
"errors": {
{parametro}: [
"Questo valore non dovrebbe essere vuoto."
]
}
}
{
"errors": {
"file": [
"Un file vuoto non è consentito."
]
}
}
{
"errors": {
"file": [
"Il file è troppo grande ({size} MB). La dimensione massima consentita è 15 MB."
]
}
}
application/pdf
,application/x-pdf
,image/jpeg
,image/pjpeg
orimage/png
{
"errors": {
"file": [
"Puoi caricare solo file pdf, immagini jpg o png"
]
}
}
The sent request contains invalid credentials. Check the shopId and headerX-Auth-Token
. Find more info on credentials in the authentication paragraph.
{
"error": "Access denied"
}
Responses with this HTTP code indicate that a system error has occurred.
{
"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!