Documentação da API - Certificando.PRO

🚀 Introdução

A API de Webhooks do Certificando.PRO permite que você receba participantes automaticamente de plataformas de vendas como Hotmart, Kiwify, Ticto, Eduzz, Monetizze e outras.

Quando um cliente faz uma compra na plataforma de vendas, o webhook envia os dados para nossa API, que automaticamente cria uma Lista de Presença (se não existir) e adiciona o participante.

💡 Como funciona:
1. Configure o webhook na plataforma de vendas apontando para nosso endpoint
2. A cada venda aprovada, os dados são enviados automaticamente
3. Criamos a lista e adicionamos o participante
4. Você recebe um email quando uma nova lista é criada

🔐 Autenticação

Todas as requisições devem incluir seu token de API para autenticação. O token pode ser obtido na página de Integrações do seu painel.

Header Authorization (Recomendado)

Authorization: Bearer seu_token_aqui

Query String (Alternativo)

https://app.certificando.pro/api/v1/webhook/generic?token=seu_token_aqui

⚠️ Segurança: Mantenha seu token em segredo. Nunca compartilhe publicamente ou inclua em código client-side.

📍 Endpoints

Temos endpoints específicos para cada plataforma que traduzem automaticamente o formato dos dados.

Endpoint Genérico

POST https://app.certificando.pro/api/v1/webhook/generic

Endpoints por Plataforma

🟠 Hotmart

/api/v1/webhook/hotmart

🟣 Kiwify

/api/v1/webhook/kiwify

🔵 Ticto

/api/v1/webhook/ticto

🟢 Eduzz

/api/v1/webhook/eduzz

🔴 Monetizze

/api/v1/webhook/monetizze

📦 Payload

Envie os dados em formato JSON no corpo da requisição.

Campos do Payload (Endpoint Genérico)

Campo	Tipo	Obrigatório	Descrição
`external_id`	string	Sim	Identificador único do evento/produto
`event_name`	string	Sim	Nome do evento/produto
`participant_name`	string	Sim	Nome completo do participante
`participant_email`	string	Sim	Email do participante
`participant_phone`	string	Não	Telefone/WhatsApp
`participant_document`	string	Não	CPF ou documento
`transaction_id`	string	Não	ID da transação

Exemplo de Payload

{
  "external_id": "CURSO-PHP-2025",
  "event_name": "Curso Completo de PHP",
  "participant_name": "João Silva",
  "participant_email": "[email protected]",
  "participant_phone": "11999999999"
}

🔗 Configuração por Plataforma

Hotmart

1. Acesse Ferramentas → Webhooks no painel da Hotmart

2. Clique em Novo Webhook

3. Configure a URL: https://app.certificando.pro/api/v1/webhook/hotmart?token=SEU_TOKEN

4. Selecione os eventos: PURCHASE_APPROVED e PURCHASE_COMPLETE

Kiwify

1. Acesse Configurações → Webhooks

2. URL: https://app.certificando.pro/api/v1/webhook/kiwify?token=SEU_TOKEN

3. Evento: Compra aprovada

✅ Respostas

Sucesso (200 OK)

{
  "success": true,
  "message": "Participante adicionado com sucesso",
  "data": {
    "list_id": 123,
    "list_name": "Curso Completo de PHP",
    "participant_id": 456,
    "is_new_list": false,
    "is_new_participant": true
  }
}

❌ Códigos de Erro

Código	Significado	Solução
`400`	Dados inválidos	Verifique campos obrigatórios
`401`	Não autenticado	Verifique o token
`403`	Sem permissão	Requer plano Premium
`429`	Rate limit	Aguarde um minuto (100 req/min)
`500`	Erro interno	Contate o suporte

💻 Exemplos de Código

cURL

curl -X POST https://app.certificando.pro/api/v1/webhook/generic \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"CURSO-PHP","event_name":"Curso PHP","participant_name":"João","participant_email":"[email protected]"}'

PHP

$ch = curl_init('https://app.certificando.pro/api/v1/webhook/generic');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode([
        'external_id' => 'CURSO-PHP',
        'event_name' => 'Curso PHP',
        'participant_name' => 'João',
        'participant_email' => '[email protected]'
    ]),
    CURLOPT_HTTPHEADER => ['Authorization: Bearer seu_token', 'Content-Type: application/json'],
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
print_r(json_decode($response, true));

🆘 Suporte

Precisa de ajuda? Entre em contato:

• Email: [email protected]