Send user IDs

Create client documents.

Request

Endpoint

Sandbox: http://api.sandbox.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/documents
Production: https://api.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/documents

Accepted Methods

POST

Authentication

This API requires authorization with shopId and X-Auth-Token header .

Prerequisites

A call to POST /api/shops/{shopId}/requests/{fiscalCode} is required.

Parameters

Parameter Mandatory Type Format Description
identityFrontFile Yes Immagine Jpg, Png, Pdf IMage of identity document front page
identityBackFile Yes Immagine Jpg, Png, Pdf IMage of identity document back page
fiscalCodeFrontFile Yes Immagine Jpg, Png, Pdf IMage of fiscal code or health insurance card - front side
fiscalCodeBackFile Yes Immagine Jpg, Png, Pdf IMage of fiscal code or health insurance card - back side
selfieFile Yes Immagine Jpg, Png, Pdf USer selfie photo with identity document
incomeDeclarationFile No* Immagine Jpg, Png, Pdf USer income declaration - Mandatory if additionalDataNeeded is true
residencePermitFile No* Immagine Jpg, Png, Pdf USer residence permit - Mandatory for foreigners (not UE)

Response

This API returns a JSON object.

Response codes

Code Description
201 Resource has been created
400 A domain error occurred
403 Forbidden
500 System error

Valid response

[
    {"fileName: "identityFrontFile", "id": <UUID>},
    {"fileName: "identityBackFile", "id": <UUID>},
    {"fileName: "fiscalCodeFrontFile", "id": <UUID>},
    {"fileName: "fiscalCodeBackFile", "id": <UUID>},
    {"fileName: "selfieFile", "id": <UUID>},
    {"fileName: "incomeDeclarationFile", "id": <UUID>},
    {"fileName: "residencePermitFile", "id": <UUID>},
]

Error response

{
 "errors": {
     "domain": [
         0: "Invalid fiscalCode."
         ]
     }
}

Validation error sample response:

{
    "errors": {
        "identityFrontFile": [
            "Questo valore non dovrebbe essere vuoto."
        ]
    }
}