Get the contract terms

With this, you can retrieve the clauses that the user must accept in order to generate a signature certificate. The call will return a list of clauses that the user will have to see and expressly accept. You will then need to send us the user's response (that is, acceptance) in the next call.

Request

Endpoint

Sandbox: https://api.sandbox.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/terms-and-conditions
Production: https://api.soisy.it/api/shops/{shopId}/requests/{fiscalCode}/terms-and-conditions

Accepted methods

GET

Authentication

This API requires authentication via shopId and headerX-Auth-Token.

Prerequisites

To access this endpoint it is necessary to have the customer's completed data.

Response

The API returns a JSON object.

HTTP Error codes

Code Description
200 Request completed successfully
400 Syntax or domain error
403 The request could not be authenticated
500 System error

Valid response

{
    "clauses": {
      "termAndCondition": "The undersigned, aware of the penalties provided for ...",
      "misleadingClaims": "The undersigned, pursuant to and for the effects of articles 1341 and 1342 of the Italian Civil Code, declares...",
    },
    "links": [
      {"url": "https://docs.namirialtsp.com/documents/Mod.NAMCA01D_ENG.pdf", "name": "General Terms and Conditions (Mod.NAMCA01D_ENG)"},
      {"url": "https://docs.namirialtsp.com/documents/Mod.NAM_CA22D.pdf", "name": "Request Form (Mod.NAM_CA22D)"},
    ]
}

Error response

The JSON object returned in the event of an error varies depending on the HTTP response code. The description of the message error will change depending on the error generated by the Certification Authority.

 {
     "errors": {
         "domain": [
             {message}
         ]
      }
 }