> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Hono अडैप्टर
> अपने Hono App Router प्रोजेक्ट में Dodo Payments को एकीकृत करने के लिए हमारे NextJS अडैप्टर का उपयोग करना सीखें। चेकआउट, ग्राहक पोर्टल, वेबहुक और सुरक्षित वातावरण सेटअप को कवर करता है।
अपने Hono ऐप में Dodo Payments चेकआउट को एकीकृत करें।
ग्राहकों को सब्सक्रिप्शन और विवरण प्रबंधित करने की अनुमति दें।
Dodo Payments वेबहुक इवेंट्स प्राप्त करें और प्रोसेस करें।
## स्थापना
अपने प्रोजेक्ट रूट में निम्न कमांड चलाएं:
```bash theme={null}
npm install @dodopayments/hono
```
अपने प्रोजेक्ट रूट में .env फ़ाइल बनाएं:
```env expandable theme={null}
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 फ़ाइल या सीक्रेट्स को वर्शन कंट्रोल में कभी कमिट न करें।
## रूट हैंडलर उदाहरण
सभी उदाहरण मानते हैं कि आप Hono App Router का उपयोग कर रहे हैं।
इस हैंडलर का उपयोग अपने Hono ऐप में Dodo Payments चेकआउट को एकीकृत करने के लिए करें। यह स्थिर (GET), गतिशील (POST), और सेशन (POST) फ्लो का समर्थन करता है।
```typescript Hono Route Handler expandable theme={null}
// route.ts
import { Checkout } from '@dodopayments/hono';
import Hono from 'hono'
const app = new Hono()
app.get(
"/api/checkout",
Checkout({
bearerToken: process.env.DODO_PAYMENTS_API_KEY,
environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
type: 'static'
})
);
app.post(
"/api/checkout",
Checkout({
bearerToken: process.env.DODO_PAYMENTS_API_KEY,
environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
type: 'dynamic'
})
);
app.post(
"/api/checkout",
Checkout({
bearerToken: process.env.DODO_PAYMENTS_API_KEY,
environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
type: 'session'
})
);
```
```curl Static Checkout Curl example expandable theme={null}
curl --request GET \
--url 'https://example.com/api/checkout?productId=pdt_fqJhl7pxKWiLhwQR042rh' \
--header 'User-Agent: insomnia/11.2.0' \
--cookie mode=test
```
```curl Dynamic Checkout Curl example expandable theme={null}
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 Checkout Session Curl example expandable theme={null}
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 '{
"product_cart": [
{
"product_id": "pdt_QMDuvLkbVzCRWRQjLNcs",
"quantity": 1
}
],
"customer": {
"email": "test@example.com",
"name": "test"
},
"return_url": "https://example.com/success"
}'
```
ग्राहकों को Dodo Payments ग्राहक पोर्टल के माध्यम से उनके सब्सक्रिप्शन और विवरण प्रबंधित करने की अनुमति देने के लिए इस हैंडलर का उपयोग करें।
```typescript Hono Route Handler expandable theme={null}
// route.ts
import { Checkout } from '@dodopayments/hono';
import Hono from 'hono'
const app = new Hono()
app.get(
"/api/customer-portal",
CustomerPortal({
bearerToken: process.env.DODO_PAYMENTS_API_KEY,
environment: process.env.DODO_PAYMENTS_ENVIRONMENT
})
);
```
```curl Customer Portal Curl example expandable theme={null}
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
```
इस हैंडलर का उपयोग अपने Hono ऐप में Dodo Payments वेबहुक इवेंट्स को सुरक्षित रूप से प्राप्त करने और प्रोसेस करने के लिए करें।
```typescript Hono Route Handler expandable theme={null}
// route.ts
import Hono from 'hono'
import { Webhooks } from '@dodopayments/hono'
const app = new Hono()
app.post(
"/api/webhooks",
Webhooks({
webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
onPayload: async (payload) => {
// Handle Payload Here
console.log(payload)
}
})
);
```
## चेकआउट रूट हैंडलर
Dodo Payments आपके वेबसाइट में भुगतान एकीकरण के लिए तीन प्रकार के भुगतान फ्लो का समर्थन करता है, यह एडेप्टर सभी प्रकार के भुगतान फ्लो का समर्थन करता है।
* **स्थिर भुगतान लिंक:** त्वरित, बिना कोड के भुगतान संग्रह के लिए तुरंत साझा करने योग्य URL।
* **गतिशील भुगतान लिंक:** API या SDKs का उपयोग करके कस्टम विवरण के साथ भुगतान लिंक प्रोग्रामेटिक रूप से उत्पन्न करें।
* **चेकआउट सत्र:** पूर्व-निर्धारित उत्पाद कार्ट और ग्राहक विवरण के साथ सुरक्षित, अनुकूलन योग्य चेकआउट अनुभव बनाएं।
### समर्थित क्वेरी पैरामीटर
उत्पाद पहचानकर्ता (उदा., ?productId=pdt\_nZuwz45WAs64n3l07zpQR)।
उत्पाद की मात्रा।
ग्राहक का पूरा नाम।
ग्राहक का पहला नाम।
ग्राहक का अंतिम नाम।
ग्राहक का ईमेल पता।
ग्राहक का देश।
ग्राहक का पता पंक्ति।
ग्राहक का शहर।
ग्राहक का राज्य/प्रांत।
ग्राहक का ज़िप/पोस्टल कोड।
पूरा नाम फ़ील्ड अक्षम करें।
पहला नाम फ़ील्ड अक्षम करें।
अंतिम नाम फ़ील्ड अक्षम करें।
ईमेल फ़ील्ड अक्षम करें।
देश फ़ील्ड अक्षम करें।
पता पंक्ति फ़ील्ड अक्षम करें।
शहर फ़ील्ड अक्षम करें।
राज्य फ़ील्ड अक्षम करें।
ज़िप कोड फ़ील्ड अक्षम करें।
भुगतान मुद्रा निर्दिष्ट करें (उदा., USD)।
मुद्रा चयनकर्ता दिखाएँ।
भुगतान राशि निर्दिष्ट करें (उदा., \$10.00 के लिए 1000)।
छूट फ़ील्ड दिखाएँ।
कोई भी क्वेरी पैरामीटर जो metadata\_ से शुरू होता है, उसे मेटाडेटा के रूप में पास किया जाएगा।
यदि productId गायब है, तो हैंडलर 400 प्रतिक्रिया लौटाता है। अमान्य क्वेरी पैरामीटर भी 400 प्रतिक्रिया देते हैं।
### प्रतिक्रिया प्रारूप
स्थिर चेकआउट एक JSON प्रतिक्रिया लौटाता है जिसमें चेकआउट URL होता है:
```json theme={null}
{
"checkout_url": "https://checkout.dodopayments.com/..."
}
```
* POST अनुरोध में पैरामीटर को JSON बॉडी के रूप में भेजें।
* एक-बार और आवर्ती भुगतान दोनों का समर्थन करता है।
* समर्थित POST बॉडी फ़ील्ड की पूर्ण सूची के लिए देखें:
* [एक समय भुगतान उत्पाद के लिए अनुरोध बॉडी](https://docs.dodopayments.com/api-reference/payments/post-payments)
* [एक सदस्यता उत्पाद के लिए अनुरोध बॉडी](https://docs.dodopayments.com/api-reference/subscriptions/post-subscriptions)
### प्रतिक्रिया प्रारूप
गतिशील चेकआउट एक JSON प्रतिक्रिया लौटाता है जिसमें चेकआउट URL होता है:
```json theme={null}
{
"checkout_url": "https://checkout.dodopayments.com/..."
}
```
चेकआउट सत्र अधिक सुरक्षित, होस्टेड चेकआउट अनुभव प्रदान करते हैं जो एक-बार की खरीद और सदस्यताओं दोनों के लिए पूर्ण भुगतान फ्लो को संभालते हैं, साथ ही पूर्ण अनुकूलन नियंत्रण भी देते हैं।
अधिक विवरण और समर्थित फ़ील्ड की पूरी सूची के लिए [चेकआउट सत्र एकीकरण गाइड](https://docs.dodopayments.com/developer-resources/checkout-session) देखें।
### प्रतिक्रिया प्रारूप
चेकआउट सत्र एक JSON प्रतिक्रिया लौटाते हैं जिसमें चेकआउट URL होता है:
```json theme={null}
{
"checkout_url": "https://checkout.dodopayments.com/session/..."
}
```
## ग्राहक पोर्टल रूट हैंडलर
ग्राहक पोर्टल रूट हैंडलर आपको अपने Hono एप्लिकेशन में Dodo Payments ग्राहक पोर्टल को सहजता से एकीकृत करने की अनुमति देता है।
### क्वेरी पैरामीटर
ग्राहक आईडी पोर्टल सत्र के लिए (उदा., ?customer\_id=cus\_123)।
यदि इसे true पर सेट किया गया है, तो ग्राहक को पोर्टल लिंक के साथ ईमेल भेजता है।
यदि customer\_id गायब है, तो 400 लौटाता है।
## वेबहुक रूट हैंडलर
* **विधि:** केवल POST अनुरोधों का समर्थन किया जाता है। अन्य विधियाँ 405 लौटाती हैं।
* **हस्ताक्षर सत्यापन:** webhookKey का उपयोग करके वेबहुक हस्ताक्षर की पुष्टि करता है। यदि सत्यापन विफल होता है तो 401 लौटाता है।
* **पेलोड मान्यता:** Zod के साथ मान्य किया गया। अमान्य पेलोड के लिए 400 लौटाता है।
* **त्रुटि प्रबंधन:**
* 401: अमान्य हस्ताक्षर
* 400: अमान्य पेलोड
* 500: सत्यापन के दौरान आंतरिक त्रुटि
* **घटना रूटिंग:** पेलोड प्रकार के आधार पर उपयुक्त घटना हैंडलर को कॉल करता है।
### समर्थित वेबहुक इवेंट हैंडलर
```typescript Typescript expandable theme={null}
onPayload?: (payload: WebhookPayload) => Promise;
onPaymentSucceeded?: (payload: WebhookPayload) => Promise;
onPaymentFailed?: (payload: WebhookPayload) => Promise;
onPaymentProcessing?: (payload: WebhookPayload) => Promise;
onPaymentCancelled?: (payload: WebhookPayload) => Promise;
onRefundSucceeded?: (payload: WebhookPayload) => Promise;
onRefundFailed?: (payload: WebhookPayload) => Promise;
onDisputeOpened?: (payload: WebhookPayload) => Promise;
onDisputeExpired?: (payload: WebhookPayload) => Promise;
onDisputeAccepted?: (payload: WebhookPayload) => Promise;
onDisputeCancelled?: (payload: WebhookPayload) => Promise;
onDisputeChallenged?: (payload: WebhookPayload) => Promise;
onDisputeWon?: (payload: WebhookPayload) => Promise;
onDisputeLost?: (payload: WebhookPayload) => Promise;
onSubscriptionActive?: (payload: WebhookPayload) => Promise;
onSubscriptionOnHold?: (payload: WebhookPayload) => Promise;
onSubscriptionRenewed?: (payload: WebhookPayload) => Promise;
onSubscriptionPlanChanged?: (payload: WebhookPayload) => Promise;
onSubscriptionCancelled?: (payload: WebhookPayload) => Promise;
onSubscriptionFailed?: (payload: WebhookPayload) => Promise;
onSubscriptionExpired?: (payload: WebhookPayload) => Promise;
onSubscriptionUpdated?: (payload: WebhookPayload) => Promise;
onLicenseKeyCreated?: (payload: WebhookPayload) => Promise;
onAbandonedCheckoutDetected?: (payload: WebhookPayload) => Promise;
onAbandonedCheckoutRecovered?: (payload: WebhookPayload) => Promise;
onDunningStarted?: (payload: WebhookPayload) => Promise;
onDunningRecovered?: (payload: WebhookPayload) => Promise;
onCreditAdded?: (payload: WebhookPayload) => Promise;
onCreditDeducted?: (payload: WebhookPayload) => Promise;
onCreditExpired?: (payload: WebhookPayload) => Promise;
onCreditRolledOver?: (payload: WebhookPayload) => Promise;
onCreditRolloverForfeited?: (payload: WebhookPayload) => Promise;
onCreditOverageCharged?: (payload: WebhookPayload) => Promise;
onCreditManualAdjustment?: (payload: WebhookPayload) => Promise;
onCreditBalanceLow?: (payload: WebhookPayload) => Promise;
```
***
## LLM के लिए प्रॉम्प्ट
```
आप एक विशेषज्ञ Hono डेवलपर सहायक हैं। आपका कार्य उपयोगकर्ता को @dodopayments/hono अडैप्टर को उनके मौजूदा Hono प्रोजेक्ट में एकीकृत करने के लिए मार्गदर्शन करना है।
@dodopayments/hono अडैप्टर Dodo Payments के चेकआउट, ग्राहक पोर्टल, और वेबहुक कार्यक्षमताओं के लिए रूट हैंडलर प्रदान करता है, जिसे सीधे Hono ऐप में प्लग करने के लिए डिज़ाइन किया गया है।
पहले, आवश्यक पैकेज स्थापित करें। उपयोगकर्ता के प्रोजेक्ट के लिए उपयुक्त पैकेज प्रबंधक (npm, yarn, या bun) का उपयोग करें:
npm install @dodopayments/hono
---
यहाँ बताया गया है कि आपको अपनी प्रतिक्रिया को कैसे संरचना करनी चाहिए:
1. उपयोगकर्ता से पूछें कि वे कौन सी कार्यक्षमताएँ एकीकृत करना चाहते हैं।
"@dodopayments/hono अडैप्टर के कौन से भागों को आप अपने प्रोजेक्ट में एकीकृत करना चाहेंगे? आप निम्नलिखित में से एक या अधिक चुन सकते हैं:
- चेकआउट रूट हैंडलर (उत्पाद चेकआउट को संभालने के लिए)
- ग्राहक पोर्टल रूट हैंडलर (ग्राहक सदस्यताओं/विवरणों का प्रबंधन करने के लिए)
- वेबहुक रूट हैंडलर (Dodo Payments वेबहुक घटनाओं को प्राप्त करने के लिए)
- सभी (तीनों को एकीकृत करें)"
---
2. उपयोगकर्ता के चयन के आधार पर, प्रत्येक चुनी गई कार्यक्षमता के लिए विस्तृत एकीकरण चरण प्रदान करें।
---
**यदि चेकआउट रूट हैंडलर चुना गया है:**
**उद्देश्य**: यह हैंडलर उपयोगकर्ताओं को Dodo Payments चेकआउट पृष्ठ पर पुनर्निर्देशित करता है।
**एकीकरण**:
अपने Hono ऐप में दो रूट बनाएं - एक स्थिर (GET) और एक गतिशील (POST) चेकआउट के लिए।
import { Checkout } from '@dodopayments/hono';
import Hono from 'hono'
const app = new Hono()
app.get(
"/api/checkout",
Checkout({
bearerToken: process.env.DODO_PAYMENTS_API_KEY,
environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
type: 'static'
})
);
app.post(
"/api/checkout",
Checkout({
bearerToken: process.env.DODO_PAYMENTS_API_KEY,
environment: process.env.DODO_PAYMENTS_ENVIRONMENT,
returnUrl: process.env.DODO_PAYMENTS_RETURN_URL,
type: 'session' // या गतिशील लिंक के लिए 'dynamic'
})
);
कॉन्फ़िग विकल्प:
bearerToken: आपका Dodo Payments API कुंजी (सिफारिश की जाती है कि इसे DODO_PAYMENTS_API_KEY env चर में संग्रहीत किया जाए)।
returnUrl (वैकल्पिक): सफल चेकआउट के बाद उपयोगकर्ता को पुनर्निर्देशित करने के लिए URL।
environment: "test_mode" या "live_mode"
type: "static" (GET) या "dynamic" (POST) या "session" (POST)
GET (स्थिर चेकआउट) क्वेरी पैरामीटर की अपेक्षा करता है:
productId (आवश्यक)
quantity, ग्राहक फ़ील्ड (fullName, email, आदि), और मेटाडेटा (metadata_*) वैकल्पिक हैं।
POST (गतिशील चेकआउट) भुगतान विवरण (एक बार या सदस्यता) के साथ JSON बॉडी की अपेक्षा करता है। पूर्ण POST स्कीमा के लिए दस्तावेज़ देखें:
एक बार के भुगतान: https://docs.dodopayments.com/api-reference/payments/post-payments
सदस्यताएँ: https://docs.dodopayments.com/api-reference/subscriptions/post-subscriptions
POST (चेकआउट सत्र) - (सिफारिश की गई) एक अधिक अनुकूलन योग्य चेकआउट अनुभव। JSON के साथ लौटाता है जिसमें checkout_url होता है: पैरामीटर JSON बॉडी के रूप में भेजे जाते हैं। एक बार और आवर्ती भुगतानों दोनों का समर्थन करता है। लौटाता है: {"checkout_url": "https://checkout.dodopayments.com/session/..."}। समर्थित फ़ील्ड की पूरी सूची के लिए देखें:
चेकआउट सत्र एकीकरण गाइड: https://docs.dodopayments.com/developer-resources/checkout-session
यदि ग्राहक पोर्टल रूट हैंडलर चुना गया है:
उद्देश्य: यह रूट ग्राहकों को Dodo Payments पोर्टल के माध्यम से अपनी सदस्यताओं का प्रबंधन करने की अनुमति देता है।
एकीकरण:
import { Checkout } from '@dodopayments/hono';
import Hono from 'hono'
const app = new Hono()
app.get(
"/api/customer-portal",
CustomerPortal({
bearerToken: process.env.DODO_PAYMENTS_API_KEY,
environment: process.env.DODO_PAYMENTS_ENVIRONMENT
})
);
क्वेरी पैरामीटर:
customer_id (आवश्यक): जैसे, ?customer_id=cus_123
send_email (वैकल्पिक): यदि true है, तो ग्राहक को पोर्टल लिंक ईमेल किया जाता है।
यदि customer_id गायब है तो 400 लौटाता है।
यदि वेबहुक रूट हैंडलर चुना गया है:
उद्देश्य: Dodo Payments से आने वाली वेबहुक घटनाओं को संसाधित करना ताकि आपके ऐप में घटनाएँ ट्रिगर की जा सकें।
एकीकरण:
import Hono from 'hono'
import { Webhooks } from '@dodopayments/hono'
const app = new Hono()
app.post(
"/api/webhooks",
Webhooks({
webhookKey: process.env.DODO_PAYMENTS_WEBHOOK_KEY,
onPayload: async (payload) => {
// यहाँ पेलोड को संभालें
console.log(payload)
}
})
);
विशेषताएँ:
केवल POST विधि की अनुमति है - अन्य 405 लौटाती हैं।
हस्ताक्षर सत्यापन webhookKey का उपयोग करके किया जाता है। यदि अमान्य है तो 401 लौटाता है।
Zod-आधारित पेलोड मान्यता। यदि अमान्य स्कीमा है तो 400 लौटाता है।
सभी हैंडलर असिंक्रोनस फ़ंक्शन हैं।
समर्थित वेबहुक घटना हैंडलर:
आप निम्नलिखित में से कोई भी हैंडलर पास कर सकते हैं:
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
पर्यावरण वेरिएबल सेटअप:
सुनिश्चित करें कि आपके प्रोजेक्ट में ये पर्यावरण वेरिएबल्स परिभाषित हों:
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"
इन्हें अपने कोड में इस प्रकार उपयोग करें:
process.env.DODO_PAYMENTS_API_KEY
process.env.DODO_PAYMENTS_WEBHOOK_KEY
सुरक्षा नोट: सीक्रेट्स को वर्शन कंट्रोल में कमिट न करें। स्थानीय रूप से .env फाइल्स और डिप्लॉयमेंट वातावरणों में सीक्रेट्स मैनेजर्स (जैसे, AWS, Vercel, Heroku, आदि) का उपयोग करें।
```