Inngest - Dodo Payments Documentation

Introdução

Execute funções serverless e jobs em segundo plano automaticamente quando eventos de pagamento ocorrerem. Processar pagamentos, enviar notificações, atualizar bancos de dados e executar fluxos de trabalho complexos com a plataforma confiável de execução de funções do Inngest.

Esta integração requer a URL de webhook do Inngest a partir da configuração da sua função.

Começando

Open the Webhook Section

No painel do Dodo Payments, navegue até Webhooks → + Adicionar Endpoint e expanda o menu suspenso de integrações.

Select Inngest

Escolha o cartão de integração Inngest.

Create Inngest Function

No Inngest, crie uma nova função e copie a URL de webhook da configuração da função.

Paste Webhook URL

Cole a URL de webhook do Inngest na configuração do endpoint.

Configure Transformation

Edite o código de transformação para formatar os eventos para sua função do Inngest.

Test & Create

Teste com payloads de exemplo e clique em Create para ativar a integração.

Done!

🎉 Os eventos de pagamento agora acionarão suas funções do Inngest automaticamente.

Exemplos de Código de Transformação

Carga Útil de Evento Básica

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: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
    };
  }
  return webhook;
}

Manipulador de Evento 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: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
      };
      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: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
      };
      break;
  }
  return webhook;
}

Manipulador de Evento de Disputa

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"
      },
      user: {
        email: d.customer?.email || "unknown"
      },
      ts: Math.floor(new Date(webhook.payload.timestamp).getTime() / 1000)
    };
  }
  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 estoque

Subscription Management

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

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 para melhor organização das funções
Inclua contexto do usuário para a execução da função
Defina timestamps adequados para a ordenação de eventos
Estruture os dados de forma consistente entre os eventos
Utilize os recursos de retry e tratamento de erros do Inngest

Solução de Problemas

Functions not triggering

Verificar se a URL do webhook está correta e ativa
Verificar se a função do Inngest está implantada e ativa
Garantir que os nomes de eventos correspondam aos gatilhos da função
Revisar os logs da função do Inngest em busca de erros

Data not received correctly

Verificar se a estrutura do payload corresponde às expectativas do Inngest
Verificar se os nomes de eventos estão formatados corretamente
Garantir que todos os campos obrigatórios estejam incluídos
Testar com a ferramenta de teste de webhook do Inngest

​Introdução

​Começando

​Exemplos de Código de Transformação

​Carga Útil de Evento Básica

​Manipulador de Evento de Assinatura

​Manipulador de Evento de Disputa

​Casos de Uso Comuns do Inngest

​Dicas

​Solução de Problemas

Introdução

Começando

Exemplos de Código de Transformação

Carga Útil de Evento Básica

Manipulador de Evento de Assinatura

Manipulador de Evento de Disputa

Casos de Uso Comuns do Inngest

Dicas

Solução de Problemas