Inngest

Introdução

Execute funções do Inngest e tarefas em segundo plano quando ocorrerem eventos de pagamento. O Dodo Payments envia cada evento para o Inngest, onde suas funções podem enviar notificações, atualizar bancos de dados e executar fluxos de trabalho com várias etapas usando as tentativas e o tratamento de erros do Inngest.

Você precisa de uma URL de webhook do Inngest. Crie-a no dashboard do Inngest, em Manage → Webhooks.

Começando

Open the Webhook Section

No dashboard do Dodo Payments, acesse Developer → Webhooks e clique em Add endpoint.

Caixa de diálogo Add endpoint com Inngest selecionado no menu suspenso Integration

Select Inngest

Em Integration, selecione Inngest. Em Subscribed events, selecione os eventos que devem acionar suas funções.

Create an Inngest Webhook

No dashboard do Inngest, abra a aba Manage e selecione Webhooks. Crie um webhook e copie a URL. O Inngest executa a função de transformação do webhook em cada solicitação, portanto verifique se ela mantém os campos name e data que suas funções esperam.

Paste Webhook URL

Cole a URL do webhook do Inngest em Endpoint URL.

Configure Transformation

Em Transformation code, edite o código para formatar os eventos para suas funções do Inngest. Consulte os exemplos abaixo.

Test & Create

Em Test this code, selecione um tipo de evento e clique em Simulate para executar a transformação em um payload de exemplo. Em seguida, clique em Create endpoint para ativar a integração.

Done

Os eventos do Dodo Payments agora acionam suas funções do Inngest.

Exemplos de Código de Transformação

Cada exemplo reescreve webhook.payload em um evento do Inngest. name é o evento que aciona sua função, data contém os detalhes do evento, user contém o cliente e ts é o horário do evento em milissegundos, exigido pelo formato de eventos do Inngest.

Payload de evento básico

basic_event.js

function handler(webhook) {
  if (webhook.eventType === "payment.succeeded") {
    const p = webhook.payload.data;
    webhook.payload = {
      name: "payment.succeeded",
      data: {
        payment_id: p.payment_id,
        amount: (p.total_amount / 100).toFixed(2),
        currency: p.currency || "USD",
        customer_email: p.customer.email,
        customer_name: p.customer.name,
        payment_method: p.payment_method || "unknown"
      },
      user: {
        email: p.customer.email
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

Manipulador de eventos de assinatura

subscription_event.js

function handler(webhook) {
  const s = webhook.payload.data;
  switch (webhook.eventType) {
    case "subscription.active":
      webhook.payload = {
        name: "subscription.started",
        data: {
          subscription_id: s.subscription_id,
          customer_email: s.customer.email,
          customer_name: s.customer.name,
          product_id: s.product_id,
          amount: (s.recurring_pre_tax_amount / 100).toFixed(2),
          frequency: s.payment_frequency_interval,
          next_billing: s.next_billing_date
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
    case "subscription.cancelled":
      webhook.payload = {
        name: "subscription.cancelled",
        data: {
          subscription_id: s.subscription_id,
          customer_email: s.customer.email,
          cancelled_at: s.cancelled_at,
          cancel_at_next_billing: s.cancel_at_next_billing_date
        },
        user: {
          email: s.customer.email
        },
        ts: new Date(webhook.payload.timestamp).getTime()
      };
      break;
  }
  return webhook;
}

Manipulador de eventos de disputa

Esse manipulador encaminha cada evento dispute.* e marca dispute.opened como urgente. Os payloads de disputa não incluem detalhes do cliente, portanto não enviam nenhum objeto user.

dispute_event.js

function handler(webhook) {
  if (webhook.eventType.startsWith("dispute.")) {
    const d = webhook.payload.data;
    webhook.payload = {
      name: webhook.eventType,
      data: {
        dispute_id: d.dispute_id,
        payment_id: d.payment_id,
        amount: (d.amount / 100).toFixed(2),
        status: d.dispute_status,
        stage: d.dispute_stage,
        remarks: d.remarks || "",
        urgent: webhook.eventType === "dispute.opened"
      },
      ts: new Date(webhook.payload.timestamp).getTime()
    };
  }
  return webhook;
}

Casos de uso comuns do Inngest

Payment Processing

Enviar e-mails de confirmação
Atualizar registros de clientes
Processar reembolsos
Gerar faturas
Atualizar o inventário

Subscription Management

Dar boas-vindas a novos assinantes
Processar cancelamentos
Enviar lembretes de renovação
Atualizar ciclos de cobrança
Processar pagamentos com falha

Analytics & Reporting

Atualizar métricas de receita
Acompanhar o comportamento dos clientes
Gerar relatórios
Sincronizar dados com plataformas de análise
Calcular taxas de churn

Dicas

Use nomes de eventos descritivos. O Inngest recomenda prefixá-los com a origem, como dodo/payment.succeeded.
Coloque os detalhes do cliente em user, que o Inngest criptografa em repouso.
Defina ts a partir de timestamp do webhook, em milissegundos, para que os eventos mantenham sua ordem e seu horário originais.
Use a mesma estrutura de dados em todos os eventos.
Use os recursos de novas tentativas e tratamento de erros do Inngest.

Solução de problemas

Functions not triggering

Verifique se a URL do endpoint corresponde à URL do webhook do Inngest e se o webhook está ativo.
Verifique se sua função do Inngest está implantada e ativa.
Verifique se os nomes dos eventos correspondem aos acionadores da sua função.
Consulte os logs da função do Inngest em busca de erros.

Data not received correctly

Verifique se a estrutura do payload corresponde ao formato de eventos do Inngest.
Verifique se os nomes dos eventos estão formatados corretamente.
Verifique se a função de transformação do webhook do Inngest mantém os campos definidos pela transformação do Dodo Payments.
Verifique se todos os campos obrigatórios estão incluídos.
Teste com a ferramenta de testes de webhook do Inngest.

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

Introdução

Começando

Exemplos de Código de Transformação

Payload de evento básico

Manipulador de eventos de assinatura

Manipulador de eventos de disputa

Casos de uso comuns do Inngest

Dicas

Solução de problemas

​Introdução

​Começando

​Exemplos de Código de Transformação

​Payload de evento básico

​Manipulador de eventos de assinatura

​Manipulador de eventos de disputa

​Casos de uso comuns do Inngest

​Dicas

​Solução de problemas

Introdução

Começando

Exemplos de Código de Transformação

Payload de evento básico

Manipulador de eventos de assinatura

Manipulador de eventos de disputa

Casos de uso comuns do Inngest

Dicas

Solução de problemas