ऑन-डिमांड सब्सक्रिप्शन

​

अवलोकन

• एक ऑन-डिमांड सब्सक्रिप्शन बनाएं (वैकल्पिक प्रारंभिक मूल्य के साथ एक आदेश को अधिकृत करें)
• कस्टम राशि के साथ बाद के चार्ज को ट्रिगर करें
• वेबहुक का उपयोग करके परिणामों को ट्रैक करें

​

पूर्वापेक्षाएँ

• डोडो पेमेंट्स व्यापारी खाता और API कुंजी
• वेबहुक गुप्त कुंजी कॉन्फ़िगर की गई और घटनाओं को प्राप्त करने के लिए एक एंडपॉइंट
• आपके कैटलॉग में एक सब्सक्रिप्शन उत्पाद

​

ऑन-डिमांड कैसे काम करता है

1. आप on_demand ऑब्जेक्ट के साथ एक सब्सक्रिप्शन बनाते हैं ताकि एक भुगतान विधि को अधिकृत किया जा सके और वैकल्पिक रूप से एक प्रारंभिक शुल्क एकत्र किया जा सके।
2. बाद में, आप समर्पित चार्ज एंडपॉइंट का उपयोग करके उस सब्सक्रिप्शन के खिलाफ कस्टम राशि के साथ चार्ज बनाते हैं।
3. आप वेबहुक (जैसे, payment.succeeded, payment.failed) को सुनते हैं ताकि अपने सिस्टम को अपडेट कर सकें।

​

एक ऑन-डिमांड सब्सक्रिप्शन बनाएं

​

एक ऑन-डिमांड सब्सक्रिप्शन बनाएं

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode', // defaults to 'live_mode'
});

async function main() {
  const subscription = await client.subscriptions.create({
    billing: { city: 'SF', country: 'US', state: 'CA', street: '1 Market St', zipcode: '94105' },
    customer: { customer_id: 'customer_123' },
    product_id: 'prod_sub_123',
    quantity: 1,
    payment_link: true,
    return_url: 'https://example.com/billing/success',
    on_demand: {
      mandate_only: true, // set false to collect an initial charge
      // product_price: 1000, // optional: charge $10.00 now if mandate_only is false
      // product_currency: 'USD',
      // product_description: 'Custom initial charge',
      // adaptive_currency_fees_inclusive: false,
    },
  });

  // If payment_link was true, redirect the customer to authorize the mandate
  console.log(subscription.payment_link);
}

main().catch(console.error);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get('DODO_PAYMENTS_API_KEY'),
    environment="test_mode",  # defaults to "live_mode"
)

subscription = client.subscriptions.create(
    billing={
        "city": "SF",
        "country": "US",
        "state": "CA",
        "street": "1 Market St",
        "zipcode": "94105",
    },
    customer={"customer_id": "customer_123"},
    product_id="prod_sub_123",
    quantity=1,
    payment_link=True,
    return_url="https://example.com/billing/success",
    on_demand={
        "mandate_only": True,
        # "product_price": 1000,
        # "product_currency": "USD",
        # "product_description": "Custom initial charge",
        # "adaptive_currency_fees_inclusive": False,
    },
)

print(subscription.payment_link)

package main

import (
  "context"
  "fmt"
  "github.com/dodopayments/dodopayments-go"
  "github.com/dodopayments/dodopayments-go/option"
)

func main() {
  client := dodopayments.NewClient(
    option.WithBearerToken("YOUR_API_KEY"),
  )
  subscription, err := client.Subscriptions.New(context.TODO(), dodopayments.SubscriptionNewParams{
    Billing: dodopayments.F(dodopayments.BillingAddressParam{
      City:    dodopayments.F("SF"),
      Country: dodopayments.F(dodopayments.CountryCodeUs),
      State:   dodopayments.F("CA"),
      Street:  dodopayments.F("1 Market St"),
      Zipcode: dodopayments.F("94105"),
    }),
    Customer: dodopayments.F[dodopayments.CustomerRequestUnionParam](dodopayments.AttachExistingCustomerParam{
      CustomerID: dodopayments.F("customer_123"),
    }),
    ProductID:  dodopayments.F("prod_sub_123"),
    Quantity:   dodopayments.F(int64(1)),
    PaymentLink: dodopayments.F(true),
    ReturnURL:   dodopayments.F("https://example.com/billing/success"),
    OnDemand: dodopayments.F(dodopayments.OnDemandSubscriptionReqParam{
      MandateOnly: dodopayments.F(true),
      // ProductPrice: dodopayments.F(int64(1000)),
      // ProductCurrency: dodopayments.F(dodopayments.CurrencyUsd),
      // ProductDescription: dodopayments.F("Custom initial charge"),
      // AdaptiveCurrencyFeesInclusive: dodopayments.F(false),
    }),
  })
  if err != nil { panic(err) }
  fmt.Println(subscription.PaymentLink)
}

curl -X POST "$DODO_API/subscriptions" \
  -H "Authorization: Bearer $DODO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "billing": {"city": "SF", "country": "US", "state": "CA", "street": "1 Market St", "zipcode": "94105"},
    "customer": {"customer_id": "customer_123"},
    "product_id": "prod_sub_123",
    "quantity": 1,
    "payment_link": true,
    "return_url": "https://example.com/billing/success",
    "on_demand": {
      "mandate_only": true
    }
  }'

{
  "subscription_id": "sub_123",
  "payment_link": "https://pay.dodopayments.com/checkout/...",
  "customer": { "customer_id": "customer_123", "email": "[email protected]", "name": "Alex Doe" },
  "metadata": {},
  "recurring_pre_tax_amount": 0,
  "addons": []
}

​

एक ऑन-डिमांड सब्सक्रिप्शन चार्ज करें

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
  environment: 'test_mode', // defaults to 'live_mode'
});

async function chargeNow(subscriptionId) {
  const res = await client.subscriptions.charge(subscriptionId, { product_price: 2500 });
  console.log(res.payment_id);
}

chargeNow('sub_123').catch(console.error);

import os
from dodopayments import DodoPayments

client = DodoPayments(
    bearer_token=os.environ.get('DODO_PAYMENTS_API_KEY'),
    environment="test_mode",  # defaults to "live_mode"
)

response = client.subscriptions.charge(
    subscription_id="sub_123",
    product_price=2500,
)

print(response.payment_id)

package main

import (
  "context"
  "fmt"
  "github.com/dodopayments/dodopayments-go"
  "github.com/dodopayments/dodopayments-go/option"
)

func main() {
  client := dodopayments.NewClient(option.WithBearerToken("YOUR_API_KEY"))
  res, err := client.Subscriptions.Charge(context.TODO(), "sub_123", dodopayments.SubscriptionChargeParams{
    ProductPrice: dodopayments.F(int64(2500)),
  })
  if err != nil { panic(err) }
  fmt.Println(res.PaymentID)
}

curl -X POST "$DODO_API/subscriptions/sub_123/charge" \
  -H "Authorization: Bearer $DODO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_price": 2500,
    "product_description": "Extra usage for March"
  }'

{ "payment_id": "pay_abc123" }

​

भुगतान पुनः प्रयास

​

सुरक्षित पुनः प्रयास नीतियों के लिए सिद्धांत

• बैकऑफ तंत्र: पुनः प्रयासों के बीच गुणात्मक बैकऑफ का उपयोग करें।
• पुनः प्रयास सीमाएँ: कुल पुनः प्रयासों को सीमित करें (3-4 प्रयास अधिकतम)।
• बुद्धिमान फ़िल्टरिंग: केवल पुनः प्रयास करने योग्य विफलताओं (जैसे, नेटवर्क/जारीकर्ता त्रुटियाँ, अपर्याप्त धन) पर पुनः प्रयास करें; कभी भी कठिन अस्वीकृतियों पर पुनः प्रयास न करें।
• कार्ड परीक्षण रोकथाम: DO_NOT_HONOR, STOLEN_CARD, LOST_CARD, PICKUP_CARD, FRAUDULENT, AUTHENTICATION_FAILURE जैसी विफलताओं पर पुनः प्रयास न करें।
• मेटाडेटा में भिन्नता (वैकल्पिक): यदि आप अपनी पुनः प्रयास प्रणाली बनाए रखते हैं, तो मेटाडेटा के माध्यम से पुनः प्रयासों को भिन्न करें (जैसे, retry_attempt)।

​

पुनः प्रयास अनुसूची (सब्सक्रिप्शन)

• 1st प्रयास: जब आप चार्ज बनाते हैं तो तुरंत
• 2nd प्रयास: 3 दिन बाद
• 3rd प्रयास: 7 और दिनों के बाद (कुल 10 दिन)
• 4th प्रयास (अंतिम): 7 और दिनों के बाद (कुल 17 दिन)

​

बर्स्ट पुनः प्रयास से बचें; प्राधिकरण समय के अनुसार संरेखित करें

• अपने पोर्टफोलियो में “बर्स्ट” व्यवहार से बचने के लिए पुनः प्रयासों को मूल प्राधिकरण टाइमस्टैम्प से जोड़ें।
• उदाहरण: यदि ग्राहक आज 1:10 बजे एक परीक्षण या आदेश शुरू करता है, तो अपने बैकऑफ के अनुसार अगले प्रयासों को 1:10 बजे निर्धारित करें (जैसे, +3 दिन → 1:10 बजे, +7 दिन → 1:10 बजे)।
• वैकल्पिक रूप से, यदि आप अंतिम सफल भुगतान समय को संग्रहीत करते हैं T, तो समय-समय पर संरेखण बनाए रखने के लिए अगले प्रयास को T + X days पर निर्धारित करें।

​

अस्वीकृति कोड जिन पर आपको पुनः प्रयास नहीं करना चाहिए

• STOLEN_CARD
• DO_NOT_HONOR
• FRAUDULENT
• PICKUP_CARD
• AUTHENTICATION_FAILURE
• LOST_CARD

​

कार्यान्वयन दिशानिर्देश (कोई कोड नहीं)

• सटीक टाइमस्टैम्प को बनाए रखने के लिए एक शेड्यूलर/क्यू का उपयोग करें; अगले प्रयास को समय-समय पर ऑफसेट पर सटीक समय पर गणना करें (जैसे, T + 3 days उसी HH:MM पर)।
• अंतिम सफल भुगतान टाइमस्टैम्प T को बनाए रखें और संदर्भित करें ताकि अगले प्रयास की गणना की जा सके; एक ही समय में कई सब्सक्रिप्शन को एकत्रित न करें।
• हमेशा अंतिम अस्वीकृति कारण का मूल्यांकन करें; ऊपर दिए गए स्किप सूची में कठिन अस्वीकृतियों के लिए पुनः प्रयास रोकें।
• आकस्मिक वृद्धि को रोकने के लिए प्रति ग्राहक और प्रति खाता समवर्ती पुनः प्रयासों को सीमित करें।
• सक्रिय रूप से संवाद करें: ग्राहक को अगले निर्धारित प्रयास से पहले उनके भुगतान विधि को अपडेट करने के लिए ईमेल/SMS करें।
• केवल अवलोकन के लिए मेटाडेटा का उपयोग करें (जैसे, retry_attempt); कभी भी धोखाधड़ी/जोखिम प्रणालियों से “बचने” के लिए तुच्छ फ़ील्ड को घुमाने की कोशिश न करें।

​

वेबहुक के साथ परिणामों को ट्रैक करें

• subscription.active: आदेश अधिकृत और सब्सक्रिप्शन सक्रिय
• subscription.failed: निर्माण विफल (जैसे, आदेश विफलता)
• subscription.on_hold: सब्सक्रिप्शन होल्ड पर रखा गया (जैसे, अनपेक्षित स्थिति)
• payment.succeeded: चार्ज सफल
• payment.failed: चार्ज विफल

​

परीक्षण और अगले कदम

​

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

• 422 अमान्य अनुरोध: सुनिश्चित करें कि निर्माण पर on_demand.mandate_only प्रदान किया गया है और चार्ज के लिए product_price प्रदान किया गया है।
• मुद्रा त्रुटियाँ: यदि आप product_currency को ओवरराइड करते हैं, तो सुनिश्चित करें कि यह आपके खाते और ग्राहक के लिए समर्थित है।
• कोई वेबहुक प्राप्त नहीं हुआ: अपने वेबहुक URL और हस्ताक्षर गुप्त कुंजी कॉन्फ़िगरेशन की पुष्टि करें.