Revenue API

A Revenue API recebe webhooks dos seus gateways de pagamento (Stripe, Kiwify, Hotmart, Eduzz, Braip, PagSeguro, Mercado Pago, custom) e normaliza tudo num formato único. A partir daí, o Mytrics calcula automaticamente MRR, ARR, Churn, Receita Líquida e Ticket Médio.

A atribuição de receita funciona em conjunto com o tracking de página: o Mytrics correlaciona o visitorId da sessão com o evento de receita via first-touch attribution, mostrando qual canal (Google, direto, Instagram) trouxe clientes que mais gastaram.

Toda requisição envia sua chave no header Authorization como Bearer Token:

Você gera API keys em Configurações → API Keys no painel. A chave é mostrada UMA VEZ na criação — guarde em variáveis de ambiente de backend.

Endpoint unificado para enviar eventos de receita:

curl -X POST https://analytics.mytrics.com.br/api/v1/revenue/events \
  -H "Authorization: Bearer mytrics_sk_live_SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "subscription.created",
    "provider": "stripe",
    "site_id": "SEU_SITE_ID",
    "customer": {
      "email": "cliente@exemplo.com",
      "name": "Maria Silva"
    },
    "subscription": {
      "id": "sub_abc123",
      "status": "active",
      "amount": 4990,
      "interval": "month"
    }
  }'

Tipos de eventos

Campos obrigatórios

Campos opcionais

Resposta

{
  "success": true,
  "eventId": "rev_abc123",
  "enriched": {
    "source": "google",
    "plan": "pro",
    "amount": 4990
  }
}

A Revenue API implementa idempotência automática via event_id. Caso seu webhook reenvie o mesmo evento (retry do gateway), a API responde com 200 e flag duplicated=true.

Códigos de retorno