Inngest

परिचय

Payment events होने पर Inngest functions और background jobs चलाएँ। Dodo Payments हर event को Inngest को भेजता है, जहाँ आपकी functions notifications भेज सकती हैं, databases अपडेट कर सकती हैं और Inngest के retries और error handling के साथ multi-step workflows चला सकती हैं।

आपको Inngest webhook URL चाहिए। इसे Inngest dashboard में Manage → Webhooks के अंतर्गत बनाएँ।

प्रारंभ करना

Open the Webhook Section

Dodo Payments डैशबोर्ड में, Developer → Webhooks पर जाएँ और Add endpoint पर क्लिक करें।

Add endpoint dialog with Inngest selected in the Integration dropdown

Select Inngest

Integration में Inngest चुनें। Subscribed events के अंतर्गत वे events चुनें जिन्हें आपकी functions को ट्रिगर करना चाहिए।

Create an Inngest Webhook

Inngest dashboard में Manage tab खोलें और Webhooks चुनें। एक webhook बनाएँ और उसका URL कॉपी करें। Inngest हर request पर webhook का transform function चलाता है, इसलिए जाँचें कि इसमें वे name और data fields बनी रहें जिनकी आपकी functions अपेक्षा करती हैं।

Paste Webhook URL

Inngest webhook URL को Endpoint URL में पेस्ट करें।

Configure Transformation

Transformation code में code को edit करके events को अपनी Inngest functions के लिए format करें। नीचे दिए गए examples देखें।

Test & Create

Test this code के अंतर्गत कोई event type चुनें और sample payload पर transformation चलाने के लिए Simulate पर क्लिक करें। फिर integration को activate करने के लिए Create endpoint पर क्लिक करें।

Done

Dodo Payments events अब आपकी Inngest functions को ट्रिगर करते हैं।

रूपांतरण कोड उदाहरण

हर example webhook.payload को Inngest event में फिर से लिखता है। name वह event है जिस पर आपकी function ट्रिगर होती है, data में event का विवरण होता है, user में customer होता है और ts milliseconds में event time होता है, जिसकी Inngest के event format को आवश्यकता होती है।

Basic Event Payload

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;
}

Subscription Event Handler

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;
}

Dispute Event Handler

यह handler हर dispute.* event को forward करता है और dispute.opened को urgent के रूप में चिह्नित करता है। Dispute payloads में customer details शामिल नहीं होतीं, इसलिए यह कोई user object नहीं भेजता।

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;
}

सामान्य Inngest उपयोग के मामले

Payment Processing

Confirmation emails भेजें
Customer records अपडेट करें
Refunds process करें
Invoices generate करें
Inventory अपडेट करें

Subscription Management

नए subscribers का स्वागत करें
Cancellations process करें
Renewal reminders भेजें
Billing cycles अपडेट करें
Failed payments संभालें

Analytics & Reporting

Revenue metrics अपडेट करें
Customer behavior track करें
Reports generate करें
Analytics platforms के साथ data sync करें
Churn rates calculate करें

सुझाव

Descriptive event names का उपयोग करें। Inngest उन्हें source के prefix के साथ रखने की सलाह देता है, जैसे dodo/payment.succeeded।
Customer details को user में रखें, जिसे Inngest at rest encrypt करता है।
Webhook के timestamp से, milliseconds में, ts सेट करें, ताकि events अपना original order और time बनाए रखें।
सभी events में एक ही data structure का उपयोग करें।
Inngest की retry और error handling सुविधाओं का उपयोग करें।

समस्या निवारण

Functions not triggering

जाँचें कि endpoint URL आपके Inngest webhook URL से मेल खाता है और webhook active है।
जाँचें कि आपकी Inngest function deployed और active है।
जाँचें कि event names आपकी function triggers से मेल खाते हैं।
Errors के लिए Inngest function logs की समीक्षा करें।

Data not received correctly

जाँचें कि payload structure Inngest event format से मेल खाता है।
जाँचें कि event names सही ढंग से formatted हैं।
जाँचें कि Inngest webhook का transform function वे fields बनाए रखता है जिन्हें Dodo Payments transformation सेट करता है।
जाँचें कि सभी required fields शामिल हैं।
Inngest के webhook testing tool से test करें।

External Integrations

Messaging

Workflow Automation

CRM

Email

Analytics

Pricing

परिचय

प्रारंभ करना

रूपांतरण कोड उदाहरण

Basic Event Payload

Subscription Event Handler

Dispute Event Handler

सामान्य Inngest उपयोग के मामले

सुझाव

समस्या निवारण

​परिचय

​प्रारंभ करना

​रूपांतरण कोड उदाहरण

​Basic Event Payload

​Subscription Event Handler

​Dispute Event Handler

​सामान्य Inngest उपयोग के मामले

​सुझाव

​समस्या निवारण

परिचय

प्रारंभ करना

रूपांतरण कोड उदाहरण

Basic Event Payload

Subscription Event Handler

Dispute Event Handler

सामान्य Inngest उपयोग के मामले

सुझाव

समस्या निवारण