Reject a signing request

Latest update: October 31st, 2019

The following use case is assumed:

  • Owner of the request: API
  • The request identifier (messageCode) is available
Description
SERVICE MESSAGE REJECT
URL /api/v3/messages/reject/{messageCode}
SECURITY YES
METHOD PUT
CONTENT/APPLICATION Application/x-www-form-urlencoded
PARAMS messageCode: code returned by Viafirma linked to the request you wish to reject. The API that consumes it must be the owner of the request.
comment: string with the reason for rejection.
RESPONSE 200: HTTP status code 200/OK – Request received.

Response content type: application/json where you will find the MESSAGE code.

Message{…}

Alternative responses in case of error: HTTP status codes other than 200/OK will be returned. In this case a JSON describing the problem will always be returned:

    {
      "code": "string",
      "type": "string",
      "message": "string",
      "trace" : "string"
    }

Example:

    // E.g. the document hasn't been signed yet, current status "WAITING".
    {
      "code": 243,
      "type": "Error",
      "message": "El estado de la solicitud no es válido."
    }
    // E.g. the API that consumes it does not own the request.
    {
      "code": 91,
      "type": "Error",
      "message": "Sorry, this application is not allowed."
    }
    // E.g. Document removed
    {
      "code": 313,
      "type": "Error",
      "message": "Documento no encontrado."
    }

results matching ""

    No results matching ""