Skip to main content
POST
Callback unificado do step de assinatura
Use POST /onboarding/api/v1/steps/signer/{requestId}/values para informar ao onboarding, em tempo de execução do step de assinatura, qual documento deve ser apresentado ao usuário. A requisição requer o requestId como parâmetro de caminho e espera receber os valores que preenchem um template previamente configurado ou as URLs públicas dos documentos a serem assinados. Esse endpoint é o retorno do callback unificado: quando o usuário atinge a etapa de assinatura, o onboarding aciona a API externa configurada no projeto e aguarda essa chamada para carregar o documento. Os modelos de integração da etapa de assinatura estão descritos em Fluxo de assinatura no onboarding. Requisito: é necessário enviar o header de autenticação, mais informações aqui

Path Parameters

string
required
O ID único da requisição de processo em execução, no formato UUID. Corresponde ao id recebido na chamada que o onboarding faz para a API externa.Exemplo: 05be75cc-8f8a-414a-891f-434aa9b4e7a5

Request Body

Envie templateId e values para preencher dinamicamente um template configurado, ou urls para apontar documentos já gerados por um sistema externo. As duas formas são mutuamente exclusivas e não devem ser combinadas na mesma chamada.
string
Identificador do template de documento configurado para o projeto, no formato UUID.Exemplo: 05be75cc-8f8a-414a-891f-434aa9b4e7a5
object
Pares de chave e valor que preenchem os campos (placeholders) do template informado em templateId. Os campos aceitos são definidos junto ao time de Suporte na configuração do template.Exemplo: { "nome": "João Silva", "cpf": "12345678900" }
string[]
Lista de URLs públicas dos documentos a serem apresentados e assinados pelo usuário.Exemplo: ["https://cliente.example.com/doc1.pdf"]
string
Identificador externo do processo, definido pelo integrador.Exemplo: cliente-123

Exemplo de requisição

Response

Em caso de sucesso, a API retorna o status 200 OK sem corpo de resposta.

Respostas de Erro

A API pode retornar os status 403, 422 e 500 (Internal server error). Todo erro tem o mesmo corpo: code, message e, nos erros de validação, details. Um requestId que não existe, ou de um processo já encerrado, não gera erro: a API responde 200 e ignora os valores.
string
required
Código do erro. Valores: FORBIDDEN, VALIDATION_ERROR, INTERNAL_SERVER_ERROR.
string
required
Mensagem do erro.
object[]
Um item por campo inválido. Vem nos erros 422.