Conexa ↔ Fidelimax | Monitor de Integração

Detalhes do Evento

Webhook Endpoint

Endpoint Principal

POST /webhook/conexa-fidelize

Este é o endpoint que recebe os webhooks do sistema Conexa

Exemplo de Payload

{ "body": { "amount": 120.50, "paidAmount": 120.50, "paymentDate": "2025-01-15", "chargeId": "CHG-123456", "sales": [{"product": "Mensalidade Academia"}], "customer": { "id": 5001, "name": "João Silva", "cpf": "12345678901", "cellNumber": "11999999999", "emailsFinancialMessages": ["joao@email.com"] } } }

Configuração no Conexa

Configure este endpoint no sistema Conexa para receber webhooks automáticos de vendas e cadastros.

Documentação da API

APIs Administrativas

GET /health Health Check

Verifica o status do sistema

{"status": "ok", "timestamp": "2025-01-15T19:30:00Z", "dryRun": true}

GET /admin/stats Estatísticas

Retorna métricas de processamento

{"total_events": 150, "success_events": 140, "error_events": 10}

GET /admin/events Eventos

Lista histórico de eventos processados

Parâmetros: ?limit=50&offset=0&status=done

GET /admin/events/{id} Detalhes

Detalhes completos de um evento específico

Fluxo de Integração

Conexa envia webhook para /webhook/conexa-fidelize
Sistema analisa tipo de evento (COMPRA ou CADASTRO)
Dados são normalizados para formato Fidelimax
Consulta se consumidor existe no Fidelimax
Cadastra/atualiza consumidor conforme necessário
Se for compra, credita pontos no Fidelimax
Resultado é persistido no banco de dados

Status dos Eventos

done

Processamento concluído com sucesso

error

Erro durante o processamento

processing

Processamento em andamento

queued

Aguardando processamento

Histórico de Processamentos