API complete the documents

This endpoint is used to complete the request by adding additional customer data written in their personal documents.


					Sandbox: https://api.sandbox.soisy.it/api/shops/{shopId}/requests/{fiscalCode}
Produzione: https://api.soisy.it/api/shops/{shopId}/requests/{fiscalCode}

This API requires authentication viashopId and headerX-Auth-Token . To access this endpoint, you must have successfully submitted customer documents.
documentOfTypeYesStringType of document. Allowed values:identity_card ,driving_license , passport
documentCodeYesStringDocument number
documentCityYesStringCity where the document was issued
documentIssueDateYesStringYYYY-MM-DDDocument issue date
documentExpirationDate YesStringYYYY-MM-DDExpiry date of the document
politicallyExposedYesBooleanSpecifies if the user is a Politically Exposed Person (EPP)
usPersonYesBooleanSpecifies whether the user is a US citizen
marketingYesBooleanSpecifies whether the user would like to receive information on commercial offers and news from Soisy
professionNoStringUser profession
The API returns a JSON object containing the newly entered values.
200Request completed successfully
400Syntax or domain error
403Failed to authenticate the request
500System error
    "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,

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.

     "errors": {
         {parametro}: [
Possible errors are listed below:
documentOfTypeThis value should not be empty.
documentCodeThis value should not be empty.
documentCityThis value should not be empty.
documentIssueDateThis value is not a valid date.
documentExpirationDate This value is not a valid date.
ibanThis value is not a valid International Bank Account Number (IBAN).
politicallyExposedThis value should not be null.
usPersonThis value should not be null.
marketingThis value should not be null.
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"


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!