Get the contract certificate

The user agrees to all the clauses specified in the previous call and registers to the certification authority to obtain a digital signature certificate.

Request

Endpoint

Sandbox: http://api.sandbox.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/request-signature-certificate
Production: https://api.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/request-signature-certificate

Accepted Methods

POST

Authentication

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

Parameters

Parameter Mandatory Type Format Description
clauses Yes Object Clauses accepted by user (see example)

The request must pass all the clauses returned by the terms-and-conditions call with the value set to true:

{
    "clauses": {
        "termAndCondition": true,
        "misleadingClaims": true,
    }
}

Response

This API returns a JSON object containing a list of contracts to be signed. Each contract contains a list of clauses which the user must accept. The clauses returned by this call must be explicitly sent with a value of true in the request-signature-certificate call

HTTP Response codes

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

Valid response

{
    "contracts": [
        {
             "contractId": "ABC-1234-DEF",
             "type": "soisy",
             "version": "v4",
             "clauses": {
                 "termsAndConditions": "Termini e condizioni",
                 "privacyPolicy": "Informativa privacy",
                 "sddStatement": "Modulo SDD",
             }
        }
    ]
}

Error response

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