API PARA ASSINATURA DIGITAL COM PHP
API de automação para assinatura digital da plataforma CLICKSIGN usando PHP API básica, para mais funcionalidades deve acessar a documentação oficial para implementações adicionais API com endpoints direcionado ao SANDBOX, plataforma de testes da clicksign Para usar a API em produção deverá apontar a url do endpoint para: https://app.clicksign.com/ Para usar a API em produção deverá apontar a url do endpoint para: https://sandbox.clicksign.com/
Documentação oficial: https://developers.clicksign.com/docs
Passos para utilização da API
1º Passo: Acessar a plataforma da clicksign e criar uma conta.
2º Passo: Ir ate as configurações, acessar a aba "API" e gerar seu token para uso da API, no botão "Gerar Acess Token".
3º Passo: após o token gerado poderá testar o mesmo usando o postman, insonia ou outra plataforma da sua preferência com a URL: https://sandbox.clicksign.com/api/v1/accounts?access_token={{access_token}} substituindo {{access_token}} pelo seu access_token.
4º Passo: Para gerar um documento através de um modelo, você deverá realizar o upload de um modelo de sua preferência na plataforma da clicksign, o qual deve conter as variáveis de sua necessidade, a declaração de variavel e feita da seguinte forma, exemplo: Eu {{ NOME }} solicito a assinatura de {{ NOME_CLIENTE }}, essas variaveis irão receber os valores através de um JSON eviado pelo seu sistema.
Criando Signtário
Endpoint: https://sandbox.clicksign.com/api/v1/signers?access_token={{access_token}}
Dados: Exemplo de dados que deverão ser enviados para requisação fazer a criação do signatário. para mais informações acessar a documentação https://developers.clicksign.com/docs/criar-signatario
{
"signer": {
"email": "[email protected]",
"phone_number": "11999999999",
"auths": [ "email" ],
"name": "Marcos Zumba",
"documentation": "123.321.123-40",
"birthday": "1983-03-31",
"has_documentation": true,
"selfie_enabled": false,
"handwritten_enabled": false,
"official_document_enabled": false,
"liveness_enabled": false,
"facial_biometrics_enabled": false
}
}
Criando Documento via modelo
Endpoint: https://sandbox.clicksign.com/api/v1/templates/:key/documents?access_token={{access_token}}
Dados: Exemplo de dados que deverão ser enviados para requisação fazer a criação do documento. para mais informações acessar a documentação https://developers.clicksign.com/docs/criar-documento-via-modelos
Os campos dentro de data deverão ser os mesmos campos que foi adicionado as variaveis dentro do documento upado nos modelos da clicksign.
{
"document": {
"path": "/Modelos/Teste-123.docx",
"template": {
"data": {
"Company Name":
"Clicksign Gestão de Documentos S.A.",
"Address": "R. Teodoro Sampaio 2767, 10° andar",
"Phone": "(11) 3145-2570",
"Website": "https://www.clicksign.com"
}
}
}
}
Adicionando o signatário ao documento
Endpoint: https://sandbox.clicksign.com/api/v1/lists?access_token={{access_token}}
Dados: Dentro de list deverá ser adicionado o document_key que se encontra localizado dentro da plataforma da clicksign, aonde foi colocado o modelo do documento, basta pegar a CHAVE que se encontra no modelo criado.
A signer_key será gerada após a criação do signatário, o qual conterá a mesma.
Para mais exemplos: https://developers.clicksign.com/docs/adicionar-signatario-a-documento
{
"list": {
"document_key": "27b02527-a576-46ee-b01c-bb4e694036c4",
"signer_key": "79301388-9567-4320-90ce-9e6f60e70d28",
"sign_as": "sign",
"refusable": true,
"group": 1,
"message": "Prezado João,\nPor favor assine o documento.\n\nQualquer dúvida estou à disposição.\n\nAtenciosamente,\nGuilherme Alvez"
}
}
Enviando a documentação ao cliente
Endpoint: https://sandbox.clicksign.com/api/v1/notifications?access_token={{access_token}}
Dados: Este passo juntará informações de todos os passos anteriores, e enviará ao cliente um email com link para assinatura do documento.
Para mais exemplos: https://developers.clicksign.com/docs/solicitar-assinatura-por-email
request_signature_key: será gerada após o signatário ser adicionado ao documento mensagem: será definida de acordo o solicitado url: será gerada após o signatário ser adicionado ao documento
{
"request_signature_key": "0d5a9615-2bb8-3a23-6584-33ff436bb990",
"message": "Prezado João,\nPor favor assine o documento.\n\nQualquer dúvida estou à disposição.\n\nAtenciosamente,\nGuilherme Alvez",
"url": "https://www.example.com/abc"
}