Assinatura eletrônica pela API

curl -X POST "https://convertaja.com.br/v1/esign/envelopes" \
  -H "Authorization: Bearer $CONVERTAJA_KEY" \
  -F "file=@contrato.pdf" \
  -F 'data={
    "name": "Contrato de prestação de serviços",
    "message": "Olá! Segue o contrato para assinatura.",
    "signers": [
      { "name": "Ana Souza", "email": "ana@cliente.com.br" },
      { "name": "Bruno Lima", "email": "bruno@empresa.com.br", "role": "witness" }
    ],
    "fields": [
      { "signer": 0, "type": "signature", "page": 0, "x": 0.1, "y": 0.75, "w": 0.3, "h": 0.07 },
      { "signer": 1, "type": "signature", "page": 0, "x": 0.55, "y": 0.75, "w": 0.3, "h": 0.07 }
    ],
    "webhook_url": "https://seusite.com.br/webhooks/convertaja"
  }'

// enviar-contrato.mjs: sobe o PDF, cadastra quem assina e envia os convites
import { openAsBlob } from 'node:fs';

const form = new FormData();
form.append('file', await openAsBlob('contrato.pdf'), 'contrato.pdf');
form.append('data', JSON.stringify({
  name: 'Contrato de prestação de serviços',
  message: 'Olá! Segue o contrato para assinatura.',
  signers: [
    { name: 'Ana Souza', email: 'ana@cliente.com.br' },
    { name: 'Bruno Lima', email: 'bruno@empresa.com.br', role: 'witness' },
  ],
  fields: [ // onde cada pessoa assina (frações da página, a partir do canto superior esquerdo)
    { signer: 0, type: 'signature', page: 0, x: 0.1, y: 0.75, w: 0.3, h: 0.07 },
    { signer: 1, type: 'signature', page: 0, x: 0.55, y: 0.75, w: 0.3, h: 0.07 },
  ],
  webhook_url: 'https://seusite.com.br/webhooks/convertaja',
}));

const res = await fetch('https://convertaja.com.br/v1/esign/envelopes', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.CONVERTAJA_KEY}` },
  body: form,
});
const envelope = await res.json();
if (!res.ok) throw new Error(`${envelope.error.code}: ${envelope.error.message}`);
console.log(`Envelope ${envelope.id}: ${envelope.status_label} (${envelope.credits_charged} créditos)`);

# enviar_contrato.py: sobe o PDF, cadastra quem assina e envia os convites
import json
import os
import requests

dados = {
    "name": "Contrato de prestação de serviços",
    "message": "Olá! Segue o contrato para assinatura.",
    "signers": [
        {"name": "Ana Souza", "email": "ana@cliente.com.br"},
        {"name": "Bruno Lima", "email": "bruno@empresa.com.br", "role": "witness"},
    ],
    "fields": [  # onde cada pessoa assina (frações da página, a partir do canto superior esquerdo)
        {"signer": 0, "type": "signature", "page": 0, "x": 0.1, "y": 0.75, "w": 0.3, "h": 0.07},
        {"signer": 1, "type": "signature", "page": 0, "x": 0.55, "y": 0.75, "w": 0.3, "h": 0.07},
    ],
    "webhook_url": "https://seusite.com.br/webhooks/convertaja",
}

with open("contrato.pdf", "rb") as f:
    res = requests.post(
        "https://convertaja.com.br/v1/esign/envelopes",
        headers={"Authorization": f"Bearer {os.environ['CONVERTAJA_KEY']}"},
        files={"file": ("contrato.pdf", f, "application/pdf")},
        data={"data": json.dumps(dados)},
        timeout=60,
    )
envelope = res.json()
if not res.ok:
    raise SystemExit(f"{envelope['error']['code']}: {envelope['error']['message']}")
print(f"Envelope {envelope['id']}: {envelope['status_label']} ({envelope['credits_charged']} créditos)")

<?php
// enviar-contrato.php: sobe o PDF, cadastra quem assina e envia os convites
$dados = [
  'name' => 'Contrato de prestação de serviços',
  'message' => 'Olá! Segue o contrato para assinatura.',
  'signers' => [
    ['name' => 'Ana Souza', 'email' => 'ana@cliente.com.br'],
    ['name' => 'Bruno Lima', 'email' => 'bruno@empresa.com.br', 'role' => 'witness'],
  ],
  'fields' => [ // onde cada pessoa assina (frações da página, a partir do canto superior esquerdo)
    ['signer' => 0, 'type' => 'signature', 'page' => 0, 'x' => 0.1, 'y' => 0.75, 'w' => 0.3, 'h' => 0.07],
    ['signer' => 1, 'type' => 'signature', 'page' => 0, 'x' => 0.55, 'y' => 0.75, 'w' => 0.3, 'h' => 0.07],
  ],
  'webhook_url' => 'https://seusite.com.br/webhooks/convertaja',
];

$ch = curl_init('https://convertaja.com.br/v1/esign/envelopes');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('CONVERTAJA_KEY')],
  CURLOPT_POSTFIELDS => [
    'file' => new CURLFile('contrato.pdf', 'application/pdf'),
    'data' => json_encode($dados),
  ],
]);
$envelope = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_HTTP_CODE) !== 201) {
  exit("{$envelope['error']['code']}: {$envelope['error']['message']}\n");
}
echo "Envelope {$envelope['id']}: {$envelope['status_label']} ({$envelope['credits_charged']} créditos)\n";

curl "https://convertaja.com.br/v1/esign/envelopes/JCGM-BEMM-8SYT-2JFL" \
  -H "Authorization: Bearer $CONVERTAJA_KEY"

# Com a trilha de auditoria (quem abriu, confirmou o código, assinou; IP, porta e dispositivo)
curl "https://convertaja.com.br/v1/esign/envelopes/JCGM-BEMM-8SYT-2JFL?events=true" \
  -H "Authorization: Bearer $CONVERTAJA_KEY"

# PDF assinado
curl -f -o contrato-assinado.pdf "https://convertaja.com.br/v1/esign/envelopes/JCGM-BEMM-8SYT-2JFL/files/final" \
  -H "Authorization: Bearer $CONVERTAJA_KEY"

# Relatório de assinaturas (evidências)
curl -f -o contrato-relatorio.pdf "https://convertaja.com.br/v1/esign/envelopes/JCGM-BEMM-8SYT-2JFL/files/audit" \
  -H "Authorization: Bearer $CONVERTAJA_KEY"

import { writeFile } from 'node:fs/promises';

const BASE = 'https://convertaja.com.br/v1';
const headers = { Authorization: `Bearer ${process.env.CONVERTAJA_KEY}` };
const id = process.argv[2]; // ex.: JCGM-BEMM-8SYT-2JFL

const envelope = await (await fetch(`${BASE}/esign/envelopes/${id}`, { headers })).json();
if (envelope.status !== 'completed') {
  console.log(`Ainda não: ${envelope.status_label} (${envelope.signed_count} de ${envelope.signer_count} assinaram)`);
  process.exit(0);
}
for (const [tipo, url] of Object.entries(envelope.files)) { // { final, audit }
  const res = await fetch(url, { headers });
  await writeFile(`${id}-${tipo}.pdf`, Buffer.from(await res.arrayBuffer()));
  console.log(`Salvo: ${id}-${tipo}.pdf`);
}
console.log(`Hash do PDF final: ${envelope.final_sha256} · conferência pública: ${envelope.verify_url}`);

import os
import sys
import requests

BASE = "https://convertaja.com.br/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['CONVERTAJA_KEY']}"}
env_id = sys.argv[1]  # ex.: JCGM-BEMM-8SYT-2JFL

envelope = requests.get(f"{BASE}/esign/envelopes/{env_id}", headers=HEADERS, timeout=30).json()
if envelope["status"] != "completed":
    raise SystemExit(f"Ainda não: {envelope['status_label']} ({envelope['signed_count']} de {envelope['signer_count']} assinaram)")
for tipo, url in envelope["files"].items():  # final e audit
    res = requests.get(url, headers=HEADERS, timeout=60)
    res.raise_for_status()
    with open(f"{env_id}-{tipo}.pdf", "wb") as f:
        f.write(res.content)
    print(f"Salvo: {env_id}-{tipo}.pdf")
print(f"Hash do PDF final: {envelope['final_sha256']} · conferência pública: {envelope['verify_url']}")

<?php
const BASE = 'https://convertaja.com.br/v1';
$id = $argv[1]; // ex.: JCGM-BEMM-8SYT-2JFL
$auth = ['Authorization: Bearer ' . getenv('CONVERTAJA_KEY')];

$ch = curl_init(BASE . "/esign/envelopes/$id");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $auth]);
$envelope = json_decode(curl_exec($ch), true);
if ($envelope['status'] !== 'completed') {
  exit("Ainda não: {$envelope['status_label']} ({$envelope['signed_count']} de {$envelope['signer_count']} assinaram)\n");
}
foreach ($envelope['files'] as $tipo => $url) { // final e audit
  $fp = fopen("$id-$tipo.pdf", 'wb');
  $ch = curl_init($url);
  curl_setopt_array($ch, [CURLOPT_FILE => $fp, CURLOPT_HTTPHEADER => $auth]);
  curl_exec($ch);
  fclose($fp);
  echo "Salvo: $id-$tipo.pdf\n";
}