Fastify Adaptor

Checkout Handler

अपने Fastify ऐप में Dodo Payments checkout को इंटीग्रेट करें।

Customer Portal

ग्राहकों को subscriptions और विवरण मैनेज करने दें।

Webhooks

Dodo Payments webhook events प्राप्त और प्रोसेस करें।

Installation

Install the package

अपने project root में निम्न command चलाएँ:

npm install @dodopayments/fastify

Set up environment variables

अपने project root में .env फ़ाइल बनाएँ:

DODO_PAYMENTS_API_KEY=your-api-key
DODO_PAYMENTS_RETURN_URL=https://yourapp.com/success
DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
DODO_PAYMENTS_ENVIRONMENT="test_mode" or "live_mode""

अपनी .env फ़ाइल या secrets को version control में कभी commit न करें।

Route Handler Examples

सभी examples में माना गया है कि आप Fastify App Router का उपयोग कर रहे हैं।

Checkout Handler
Customer Portal Handler
Webhook Handler

इस handler का उपयोग अपने Fastify ऐप में Dodo Payments checkout को इंटीग्रेट करने के लिए करें। यह static (GET), dynamic (POST) और session (POST) payment flows को सपोर्ट करता है।

  // route.ts
  import { Checkout } from '@dodopayments/fastify';
  import Fastify from 'fastify'

  const fastify = Fastify({})
  const checkoutGet = Checkout({
      bearerToken: process.env.DODO_PAYMENTS_API_KEY,
      environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
      returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
      type: 'static'
  });

  const checkoutPost = Checkout({
      bearerToken: process.env.DODO_PAYMENTS_API_KEY,
      environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
      returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
      type: 'dynamic'
  });

  const checkoutSession = Checkout({
      bearerToken: process.env.DODO_PAYMENTS_API_KEY,
      environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
      returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
      type: 'session'
  });

  fastify.get('/api/checkout', checkoutGet.getHandler);
  fastify.post('/api/checkout', checkoutPost.postHandler);
  fastify.post('/api/checkout-session', checkoutSession.postHandler);

curl --request GET \
--url 'https://example.com/api/checkout?productId=pdt_fqJhl7pxKWiLhwQR042rh' \
--header 'User-Agent: insomnia/11.2.0' \
--cookie mode=test

curl --request POST \
--url https://example.com/api/checkout \
--header 'Content-Type: application/json' \
--header 'User-Agent: insomnia/11.2.0' \
--cookie mode=test \
--data '{
"billing": {
  "city": "Texas",
  "country": "US",
  "state": "Texas",
  "street": "56, hhh",
  "zipcode": "560000"
},
"customer": {
  "email": "test@example.com",
  	"name": "test"
},
"metadata": {},
"payment_link": true,
  "product_id": "pdt_QMDuvLkbVzCRWRQjLNcs",
  "quantity": 1,
  "billing_currency": "USD",
  "discount_codes": ["IKHZ23M9GQ"],
  "return_url": "https://example.com",
  "trial_period_days": 10
}'

curl --request POST \
--url https://example.com/api/checkout-session \
--header 'Content-Type: application/json' \
--header 'User-Agent: insomnia/11.2.0' \
--cookie mode=test \
--data '{
"product_cart": [
  {
    "product_id": "pdt_QMDuvLkbVzCRWRQjLNcs",
    "quantity": 1
  }
],
"customer": {
  "email": "test@example.com",
  "name": "test"
},
"return_url": "https://example.com/success"
}'

इस handler का उपयोग ग्राहकों को Dodo Payments customer portal के माध्यम से अपनी subscriptions और विवरण मैनेज करने देने के लिए करें।

// route.ts
import { CustomerPortal } from "@dodopayments/fastify";
import Fastify from 'fastify'

const fastify = Fastify({})
const customerPortalHandler = CustomerPortal({
    bearerToken: process.env.DODO_PAYMENTS_API_KEY,
    environment: process.env.DODO_PAYMENTS_ENVIRONMENT
});
fastify.get('/api/customer-portal', customerPortalHandler);

curl --request GET \
--url 'https://example.com/api/customer-portal?customer_id=cus_9VuW4K7O3GHwasENg31m&send_email=true' \
--header 'User-Agent: insomnia/11.2.0' \
--cookie mode=test

इस handler का उपयोग अपने Fastify ऐप में Dodo Payments webhook events को सुरक्षित रूप से प्राप्त और प्रोसेस करने के लिए करें।

// route.ts
import Fastify from 'fastify'
import { Webhooks } from '@dodopayments/fastify'

const fastify = Fastify({})
fastify.addContentTypeParser('application/json', { parseAs: 'string' }, function (req, body, done) {
    done(null, body)
})

fastify.post('/api/webhooks', Webhooks({
webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
onPayload: async (payload) => {
    // Handle Payload Here
    console.log(payload)
}
}));

Checkout Route Handler

Dodo Payments आपकी website में payments इंटीग्रेट करने के लिए तीन प्रकार के payment flows सपोर्ट करता है; यह adaptor सभी प्रकार के payment flows को सपोर्ट करता है।

Static Payment Links: तेज़, no-code payment collection के लिए तुरंत share किए जा सकने वाले URLs।
Dynamic Payment Links: API या SDKs का उपयोग करके custom details के साथ programmatically payment links जनरेट करें।
Checkout Sessions: pre-configured product carts और customer details के साथ सुरक्षित, customizable checkout experiences बनाएँ।

Static Checkout (GET)

Supported Query Parameters

string

आवश्यक

Product identifier (जैसे, ?productId=pdt_nZuwz45WAs64n3l07zpQR)।

integer

Product की quantity।

string

Customer का पूरा नाम।

string

Customer का पहला नाम।

string

Customer का अंतिम नाम।

string

Customer का email address।

string

Customer का country।

string

Customer की address line।

string

Customer का city।

string

Customer का state/province।

string

Customer का zip/postal code।

boolean

Full name field को disable करें।

boolean

First name field को disable करें।

boolean

Last name field को disable करें।

boolean

Email field को disable करें।

boolean

Country field को disable करें।

boolean

Address line field को disable करें।

boolean

City field को disable करें।

boolean

State field को disable करें।

boolean

Zip code field को disable करें।

string

Payment currency निर्दिष्ट करें (जैसे, USD)।

boolean

Currency selector दिखाएँ।

integer

Payment amount निर्दिष्ट करें (जैसे, $10.00 के लिए 1000)।

boolean

Discount fields दिखाएँ।

string

metadata_ से शुरू होने वाला कोई भी query parameter metadata के रूप में पास किया जाएगा।

यदि productId मौजूद नहीं है, तो handler 400 response लौटाता है। Invalid query parameters भी 400 response देते हैं।

Response Format

Static checkout checkout URL के साथ JSON response लौटाता है:

{
  "checkout_url": "https://checkout.dodopayments.com/..."
}

Dynamic Checkout (POST)

Parameters को POST request में JSON body के रूप में भेजें।
One-time और recurring दोनों payments को सपोर्ट करता है।
Supported POST body fields की पूरी सूची के लिए देखें:
- One Time Payment Product के लिए Request body
- Subscription Product के लिए Request body

Response Format

Dynamic checkout checkout URL के साथ JSON response लौटाता है:

{
  "checkout_url": "https://checkout.dodopayments.com/..."
}

Checkout Sessions (POST)

Checkout sessions अधिक सुरक्षित, hosted checkout experiences प्रदान करते हैं, जो full customization control के साथ one-time purchases और subscriptions दोनों के लिए complete payment flow संभालते हैं।अधिक विवरण और supported fields की पूरी सूची के लिए Checkout Sessions Integration Guide देखें।

Response Format

Checkout sessions checkout URL के साथ JSON response लौटाते हैं:

{
  "checkout_url": "https://checkout.dodopayments.com/session/..."
}

Customer Portal Route Handler

Customer Portal Route Handler आपको अपने Fastify application में Dodo Payments customer portal को सहजता से इंटीग्रेट करने देता है।

Query Parameters

string

आवश्यक

Portal session के लिए customer ID (जैसे, ?customer_id=cus_123)।

boolean

यदि इसे true पर सेट किया गया है, तो customer को portal link वाला email भेजा जाता है।

यदि customer_id मौजूद नहीं है, तो 400 लौटाता है।

Webhook Route Handler

Method: केवल POST requests supported हैं। अन्य methods 405 लौटाते हैं।
Signature Verification: webhookKey का उपयोग करके webhook signature verify करता है। Verification विफल होने पर 401 लौटाता है।
Payload Validation: Zod से validate किया जाता है। Invalid payloads के लिए 400 लौटाता है।
Error Handling:
- 401: Invalid signature
- 400: Invalid payload
- 500: Verification के दौरान internal error
Event Routing: Payload type के आधार पर उपयुक्त event handler को call करता है।

Supported Webhook Event Handlers

onPayload?: (payload: WebhookPayload) => Promise<void>;
onPaymentSucceeded?: (payload: WebhookPayload) => Promise<void>;
onPaymentFailed?: (payload: WebhookPayload) => Promise<void>;
onPaymentProcessing?: (payload: WebhookPayload) => Promise<void>;
onPaymentCancelled?: (payload: WebhookPayload) => Promise<void>;
onRefundSucceeded?: (payload: WebhookPayload) => Promise<void>;
onRefundFailed?: (payload: WebhookPayload) => Promise<void>;
onDisputeOpened?: (payload: WebhookPayload) => Promise<void>;
onDisputeExpired?: (payload: WebhookPayload) => Promise<void>;
onDisputeAccepted?: (payload: WebhookPayload) => Promise<void>;
onDisputeCancelled?: (payload: WebhookPayload) => Promise<void>;
onDisputeChallenged?: (payload: WebhookPayload) => Promise<void>;
onDisputeWon?: (payload: WebhookPayload) => Promise<void>;
onDisputeLost?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionActive?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionOnHold?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionRenewed?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionPlanChanged?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionCancelled?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionFailed?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionExpired?: (payload: WebhookPayload) => Promise<void>;
onSubscriptionUpdated?: (payload: WebhookPayload) => Promise<void>;
onLicenseKeyCreated?: (payload: WebhookPayload) => Promise<void>;
onAbandonedCheckoutDetected?: (payload: WebhookPayload) => Promise<void>;
onAbandonedCheckoutRecovered?: (payload: WebhookPayload) => Promise<void>;
onDunningStarted?: (payload: WebhookPayload) => Promise<void>;
onDunningRecovered?: (payload: WebhookPayload) => Promise<void>;
onCreditAdded?: (payload: WebhookPayload) => Promise<void>;
onCreditDeducted?: (payload: WebhookPayload) => Promise<void>;
onCreditExpired?: (payload: WebhookPayload) => Promise<void>;
onCreditRolledOver?: (payload: WebhookPayload) => Promise<void>;
onCreditRolloverForfeited?: (payload: WebhookPayload) => Promise<void>;
onCreditOverageCharged?: (payload: WebhookPayload) => Promise<void>;
onCreditManualAdjustment?: (payload: WebhookPayload) => Promise<void>;
onCreditBalanceLow?: (payload: WebhookPayload) => Promise<void>;

Prompt for LLM

आप एक expert Fastify developer assistant हैं। आपका कार्य user को उनके मौजूदा Fastify project में @dodopayments/fastify adapter इंटीग्रेट करने में मार्गदर्शन देना है।

@dodopayments/fastify adapter Dodo Payments' Checkout, Customer Portal और Webhook functionalities के लिए route handlers प्रदान करता है, जिन्हें सीधे Fastify app में जोड़ा जा सकता है।

सबसे पहले, आवश्यक package install करें। User के project के लिए उपयुक्त package manager (npm, yarn या bun) का उपयोग करें:

npm install @dodopayments/fastify

---

अपना response इस प्रकार structure करें:

1. User से पूछें कि वे कौन-सी functionalities इंटीग्रेट करना चाहते हैं।

"आप @dodopayments/fastify adapter के किन हिस्सों को अपने project में इंटीग्रेट करना चाहेंगे? आप निम्न में से एक या अधिक चुन सकते हैं:

- Checkout Route Handler (product checkouts संभालने के लिए)
- Customer Portal Route Handler (customer subscriptions/details मैनेज करने के लिए)
- Webhook Route Handler (Dodo Payments webhook events प्राप्त करने के लिए)
- All (तीनों को इंटीग्रेट करें)"

---

2. User के selection के आधार पर, चुनी गई प्रत्येक functionality के लिए विस्तृत integration steps प्रदान करें।

---

**यदि Checkout Route Handler चुना गया है:**

**उद्देश्य**: यह handler users को Dodo Payments checkout page पर redirect करता है।

**Integration**:
अपने Fastify app में दो routes बनाएँ — एक static (GET) और एक dynamic (POST) checkout के लिए।

import { Checkout } from '@dodopayments/fastify';
import Fastify from 'fastify'

const fastify = Fastify({})
const checkoutGet = Checkout({
    bearerToken: process.env.DODO_PAYMENTS_API_KEY,
    environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
    returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
    type: 'static'
});

const checkoutPost = Checkout({
    bearerToken: process.env.DODO_PAYMENTS_API_KEY,
    environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
    returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
    type: 'dynamic'
});

const checkoutSession = Checkout({
    bearerToken: process.env.DODO_PAYMENTS_API_KEY,
    environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
    returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
    type: 'session'
});

fastify.get('/api/checkout', checkoutGet.getHandler);
fastify.post('/api/checkout', checkoutPost.postHandler);
fastify.post('/api/checkout-session', checkoutSession.postHandler);

Config Options:

    bearerToken: आपकी Dodo Payments API key (इसे DODO_PAYMENTS_API_KEY env variable में store करने की सलाह दी जाती है)।

    returnUrl (optional): सफल checkout के बाद user को redirect करने के लिए URL।

    environment: "test_mode" या "live_mode"

    type: "static" (GET), "dynamic" (POST), या "session" (POST)

GET (static checkout) query parameters की अपेक्षा करता है:

    productId (required)

    quantity, customer fields (fullName, email, आदि) और metadata (metadata_*) optional हैं।

    Returns: {"checkout_url": "https://checkout.dodopayments.com/..."}

POST (dynamic checkout) payment details (one-time या subscription) वाली JSON body की अपेक्षा करता है। Returns: {"checkout_url": "https://checkout.dodopayments.com/..."}। पूर्ण POST schema के लिए docs देखें:

    One-time payments: https://docs.dodopayments.com/api-reference/payments/post-payments

    Subscriptions: https://docs.dodopayments.com/api-reference/subscriptions/post-subscriptions

POST (checkout sessions) - (Recommended) अधिक customizable checkout experience। checkout_url के साथ JSON लौटाता है: Parameters JSON body के रूप में भेजे जाते हैं। One-time और recurring दोनों payments को सपोर्ट करता है। Returns: {"checkout_url": "https://checkout.dodopayments.com/session/..."}। Supported fields की पूरी सूची के लिए देखें:

    Checkout Sessions Integration Guide: https://docs.dodopayments.com/developer-resources/checkout-session

यदि Customer Portal Route Handler चुना गया है:

उद्देश्य: यह route customers को Dodo Payments portal के माध्यम से अपनी subscriptions मैनेज करने देता है।

Integration:

import { CustomerPortal } from "@dodopayments/fastify";
import Fastify from 'fastify'

const fastify = Fastify({})
const customerPortalHandler = CustomerPortal({
    bearerToken: process.env.DODO_PAYMENTS_API_KEY,
    environment: process.env.DODO_PAYMENTS_ENVIRONMENT
});
fastify.get('/api/customer-portal', customerPortalHandler);

Query Parameters:

    customer_id (required): जैसे, ?customer_id=cus_123

    send_email (optional): यदि true है, तो customer को portal link वाला email भेजा जाता है

यदि customer_id मौजूद नहीं है, तो 400 लौटाता है।

यदि Webhook Route Handler चुना गया है:

उद्देश्य: Dodo Payments से आने वाले webhook events को प्रोसेस करके आपके app में events trigger करता है।

Integration:

import Fastify from 'fastify'
import { Webhooks } from '@dodopayments/fastify'

const fastify = Fastify({})
fastify.addContentTypeParser('application/json', { parseAs: 'string' }, function (req, body, done) {
    done(null, body)
})

fastify.post('/api/webhooks', Webhooks({
  webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
  onPayload: async (payload) => {
    // Handle Payload Here
    console.log(payload)
  }
}));

Features:

    केवल POST method की अनुमति है — अन्य methods 405 लौटाते हैं

    Signature verification webhookKey का उपयोग करके की जाती है। Invalid होने पर 401 लौटाता है।

    Zod-based payload validation। Invalid schema होने पर 400 लौटाता है।

    सभी handlers async functions हैं।

Supported Webhook Event Handlers:

आप निम्न में से कोई भी handler पास कर सकते हैं:

    onPayload

    onPaymentSucceeded

    onPaymentFailed

    onPaymentProcessing

    onPaymentCancelled

    onRefundSucceeded

    onRefundFailed

    onDisputeOpened, onDisputeExpired, onDisputeAccepted, onDisputeCancelled, onDisputeChallenged, onDisputeWon, onDisputeLost

    onSubscriptionActive, onSubscriptionOnHold, onSubscriptionRenewed, onSubscriptionPlanChanged, onSubscriptionCancelled, onSubscriptionFailed, onSubscriptionExpired, onSubscriptionUpdated

    onLicenseKeyCreated

    onAbandonedCheckoutDetected, onAbandonedCheckoutRecovered

    onDunningStarted, onDunningRecovered

    onCreditAdded, onCreditDeducted, onCreditExpired, onCreditRolledOver, onCreditRolloverForfeited, onCreditOverageCharged, onCreditManualAdjustment, onCreditBalanceLow

Environment Variable Setup:

अपने project में इन environment variables को define करना सुनिश्चित करें:

DODO_PAYMENTS_API_KEY=your-api-key
DODO_PAYMENTS_RETURN_URL=https://yourapp.com/success
DODO_PAYMENTS_WEBHOOK_KEY=your-webhook-secret
DODO_PAYMENTS_ENVIRONMENT="test_mode" or "live_mode"

अपने code में इनका उपयोग इस प्रकार करें:

process.env.DODO_PAYMENTS_API_KEY
process.env.DODO_PAYMENTS_WEBHOOK_KEY

Security Note: Secrets को version control में commit न करें। Locally .env files और deployment environments में secrets managers (जैसे, AWS, Vercel, Heroku आदि) का उपयोग करें।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Checkout Handler

Customer Portal

Webhooks

Installation

Route Handler Examples

Checkout Route Handler

Supported Query Parameters

Response Format

Response Format

Response Format

Customer Portal Route Handler

Query Parameters

Webhook Route Handler

Supported Webhook Event Handlers

Prompt for LLM

Checkout Handler

Customer Portal

Webhooks

​Installation

​Route Handler Examples

​Checkout Route Handler

​Supported Query Parameters

​Response Format

​Response Format

​Response Format

​Customer Portal Route Handler

​Query Parameters

​Webhook Route Handler

​Supported Webhook Event Handlers

​Prompt for LLM

Installation

Route Handler Examples

Checkout Route Handler

Supported Query Parameters

Response Format

Response Format

Response Format

Customer Portal Route Handler

Query Parameters

Webhook Route Handler

Supported Webhook Event Handlers

Prompt for LLM