Recusar Documento

Permite que um signatario recuse assinar o documento. O envelope passara para o status DECLINED e todos os outros signatarios serao notificados.

Este e um endpoint publico -- nao requer autenticacao. O token na URL identifica o signatario.

Endpoint

POST /v1/signing/{token}/decline

Endpoint publico

Este endpoint nao exige o header Authorization. O token na URL ja identifica o signatario de forma segura.

Parametros de URL

Parametro	Tipo	Obrigatorio	Descricao
token	string	Sim	Token unico do signatario

Body

Campo	Tipo	Obrigatorio	Descricao
reason	string	Nao	Motivo da recusa (exibido para o proprietario do envelope)

Exemplo de Requisicao

curl -X POST https://api.tapsign.com.br/v1/signing/abc123def456/decline \
  -H "Content-Type: application/json" \
  -d '{
    "reason": "Os termos do contrato nao estao de acordo com o combinado."
  }'

Resposta de Sucesso

Status: 200 OK

{
  "signer": {
    "id": "f7e6d5c4-b3a2-1098-7654-321fedcba098",
    "name": "Joao da Silva",
    "email": "joao@empresa.com.br",
    "status": "DECLINED",
    "declinedAt": "2026-03-29T14:30:00Z",
    "declineReason": "Os termos do contrato nao estao de acordo com o combinado."
  },
  "envelope": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "DECLINED"
  }
}

Campos da Resposta

Campo	Tipo	Descricao
signer.status	string	Sempre DECLINED apos a recusa
signer.declinedAt	string (ISO 8601)	Data e hora da recusa
signer.declineReason	string ou null	Motivo informado pelo signatario
envelope.status	string	Status atualizado do envelope (DECLINED)

Erros

Codigo	Descricao
404	Token invalido ou signatario nao encontrado
409	Signatario ja assinou ou ja recusou este documento
410	Envelope expirado ou cancelado

Acao irreversivel

A recusa de um signatario encerra o fluxo de assinatura do envelope inteiro. Todos os signatarios pendentes serao notificados de que o documento foi recusado. Esta acao nao pode ser desfeita.

Notificacoes automaticas

Ao recusar, o TapSign envia automaticamente:

• Email para o proprietario do envelope com o motivo da recusa
• Webhook envelope.declined (se configurado)
• Notificacao para signatarios que ja assinaram