मैन्युअल Payment Retry

Manual Retry, आपके कहने पर, payment की detail page या API के माध्यम से विफल subscription renewal payment को फिर से आज़माता है। यह subscription पर saved payment method से charge करता है और automatic Payment Retries schedule से स्वतंत्र रूप से चलता है।

Manual Retry क्या है?

जब renewal payment विफल होता है, subscription on_hold में चला जाता है। यदि आपने Payment Retries चालू किया है, तो वे back-off schedule के अनुसार charge को फिर से आज़माते हैं। कभी-कभी आपको पता होता है कि payment अभी सफल हो जाएगा: customer ने अपने account में funds जोड़ने की पुष्टि की है, या आपकी support team उससे call पर है। Manual Retry तुरंत एक attempt भेजता है, बजाय इसके कि अगले scheduled attempt के लिए घंटों या दिनों तक प्रतीक्षा की जाए।

केवल Renewal payments: Manual Retry subscription renewal invoices पर लागू होता है, जब subscription on_hold हो। First payments, one-time payments, plan-change charges और on-demand charges eligible नहीं हैं।
Customer action आवश्यक नहीं: Charge subscription पर पहले से saved payment method पर भेजा जाता है।
Automatic retries से स्वतंत्र: Manual retry automatic schedule के किसी attempt का उपयोग नहीं करता, अगले scheduled retry को आगे नहीं बढ़ाता और Payment Retries बंद होने पर भी काम करता है।
Payment नहीं, invoice को retry करता है: विफल payment केवल entry point है। Dodo Payments उसके पीछे मौजूद open renewal invoice को ढूँढकर उस debt को charge करता है, इसलिए invoice पर मौजूद किसी भी विफल payment से retry करने पर कोई अंतर नहीं पड़ता।

Dashboard से Retry करना

केवल Owner या Editor role वाले users manual retry भेज सकते हैं।

Open the failed payment

Transactions → Payments पर जाएँ और विफल renewal payment पर click करके उसका Transaction details page खोलें।

Click Retry Payment Manually

ऊपरी-दाएँ कोने में Retry Payment Manually पर click करें। यह button केवल तब उपलब्ध होता है जब payment eligible हो।

Check the result

Dodo Payments इस attempt के लिए नया payment बनाता है और वह Activity Log में दिखाई देता है। यदि charge सफल होता है, तो subscription active में लौट जाता है और अगली billing date सफल retry के एक billing period बाद हो जाती है। यदि payment processor ने अभी charge settle नहीं किया है, तो payment in progress दिखाई देता है, जब तक कि payment.succeeded या payment.failed webhook परिणाम की सूचना न दे दे।

विफल payment के लिए Transaction details page, जिसमें error code और message, Activity Log और Retry Payment Manually button दिख रहे हैं — Retry Payment Manually on the transaction details page of a failed renewal

Eligibility

Dodo Payments manual retry तभी भेजता है जब इस table की हर जाँच सफल हो। Reason code column में API द्वारा लौटाया गया मान होता है: GET /payments/{payment_id}/retry पर reason में और POST /payments/{payment_id}/retry पर error code के रूप में।

जाँच	आवश्यकता	Reason code
Payment type	ऐसा subscription renewal payment जिसका invoice अभी भी open हो। बिना invoice वाले payments, first payments, one-time payments, plan-change charges और on-demand charges को retry नहीं किया जा सकता।	`PAYMENT_NOT_RETRYABLE`
Subscription status	`on_hold`	`SUBSCRIPTION_INACTIVE`
Scheduled cancellation	अगली billing date पर subscription को cancel करने का schedule नहीं है।	`CHARGE_NOT_ALLOWED_FOR_SCHEDULED_CANCELLATION`
Saved payment method	Subscription में charge करने के लिए saved payment method मौजूद है।	`SUBSCRIPTION_HAS_NO_PAYMENT_METHOD`
Last failure	सबसे हाल की failure soft decline है। Hard decline या बिना classified error code वाली failure को retry नहीं किया जा सकता।	`MANUAL_RETRY_HARD_DECLINE`
Nothing in flight	Invoice पर कोई payment `processing` नहीं है और उसका recorded status भी नहीं है। ऐसा payment manual या automatic attempt होता है, जिसे अभी भेजा गया है और जिसने अभी तक परिणाम नहीं बताया है। पहले उसके परिणाम की प्रतीक्षा करें।	`MANUAL_RETRY_IN_FLIGHT`
Newest payment failed	Invoice पर सबसे हाल के payment का status `failed` है। कोई भी अन्य status, जैसे `requires_customer_action`, `requires_payment_method` या `cancelled`, retry को रोकता है, भले ही कुछ in flight न हो।	`PREVIOUS_PAYMENT_PENDING`
Not already paid	Invoice पर किसी payment को सफल नहीं होना चाहिए।	`MANUAL_RETRY_ALREADY_PAID`
Retry limit	Invoice पर 3 से कम manual retries भेजे गए हैं और cooldown पूरा हो चुका है। Retry Limits देखें।	`MANUAL_RETRY_LIMIT_REACHED`
Customer	Customer आपकी blocklist पर नहीं है।	`PAYMENT_NOT_RETRYABLE`
Payment connector	BYOP subscriptions के लिए connector enabled है।	`BYOP_CONNECTOR_DISABLED`
Live mode	Live mode में आपके business के लिए live payments enabled हैं।	`MERCHANT_NOT_LIVE`

Manual Retry एक मामले में automatic retries से अधिक सीमित है: इसके लिए subscription का on_hold होना आवश्यक है। Grace period में मौजूद past_due subscription यह जाँच विफल कर देता है। अन्य non-active statuses के लिए automatic retries चलते रहते हैं। Subscription Status Transitions देखें।

उसी card के विरुद्ध hard decline को retry करने से सफलता नहीं मिल सकती और बार-बार होने वाले declines आपकी authorization rate को नुकसान पहुँचाते हैं। जब कारण MANUAL_RETRY_HARD_DECLINE हो, तो customer से अपना payment method update करने को कहें। Subscription Dunning यह काम अपने-आप करता है।

Retry Limits

प्रत्येक renewal invoice में 3 manual retries की अनुमति होती है और इनके बीच cooldown रहता है:

Manual retry	उपलब्ध
1	Payment eligible होते ही
2	पहले के 1 घंटे बाद
3	दूसरे के 3 घंटे बाद

ये limits test mode और live mode दोनों में लागू होती हैं। जब limit retry को अस्वीकार करती है, तो API MANUAL_RETRY_LIMIT_REACHED (HTTP 429) लौटाता है और error body में केवल code तथा message होते हैं। अगला retry कब खुलेगा, यह जानने के लिए retry state जाँचें और retry_available_at पढ़ें। सभी तीन retries समाप्त होने पर यह null होता है। Automatic retries इस limit में नहीं गिने जाते और manual retries automatic schedule के 8 attempts में नहीं गिने जाते।

Manual vs. Automatic Retries

दोनों retry paths इन तरीकों से अलग हैं:

	Manual Retry	Payment Retries
Trigger	आप, dashboard या API से	Dodo Payments, back-off schedule पर
Timing	तुरंत	Failure के 12 घंटे बाद, फिर धीरे-धीरे अधिक अंतराल पर
Attempts	प्रति invoice 3, 1 घंटे और फिर 3 घंटे के cooldown के साथ	Recovery window के भीतर प्रति invoice अधिकतम 8
Needs Payment Retries enabled	नहीं	हाँ
Effect on the other	कोई नहीं। Manual failure automatic attempt को schedule या move नहीं करता।	कोई नहीं। Manual sends के बावजूद automatic chain जारी रहती है।
Analytics	Analytics → Recovery के अंतर्गत Payment Retries metrics में गिना जाता है	उन्हीं metrics में गिना जाता है

API के माध्यम से Retry करना

पहले eligibility जाँचें, फिर retry भेजें। दोनों endpoints विफल payment की ID लेते हैं।

जाँचें कि Payment को Retry किया जा सकता है या नहीं

GET /payments/{payment_id}/retry किसी ineligible payment के लिए error नहीं लौटाता। इसके बजाय यह reason code के साथ can_retry: false लौटाता है, ताकि आपका अपना dashboard या support tooling Dodo Payments dashboard जैसी ही स्थिति दिखा सके। इसके लिए Viewer role आवश्यक है।

import DodoPayments from 'dodopayments';

const client = new DodoPayments({
  bearerToken: process.env.DODO_PAYMENTS_API_KEY,
});

const state = await client.payments.retrieveRetryState('pay_0NmDtkE0iRvmeTcT6t0ol');

if (state.can_retry) {
  console.log(`Retry available. ${state.sends_used}/${state.sends_allowed} used.`);
} else {
  console.log(`Cannot retry: ${state.reason}. Next window: ${state.retry_available_at}`);
}

import os
from dodopayments import DodoPayments

client = DodoPayments(bearer_token=os.environ["DODO_PAYMENTS_API_KEY"])

state = client.payments.retrieve_retry_state("pay_0NmDtkE0iRvmeTcT6t0ol")

if state.can_retry:
    print(f"Retry available. {state.sends_used}/{state.sends_allowed} used.")
else:
    print(f"Cannot retry: {state.reason}. Next window: {state.retry_available_at}")

curl https://live.dodopayments.com/payments/pay_0NmDtkE0iRvmeTcT6t0ol/retry \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY"

Response

{
  "can_retry": false,
  "reason": "MANUAL_RETRY_LIMIT_REACHED",
  "sends_used": 1,
  "sends_allowed": 3,
  "retry_available_at": "2026-08-26T16:51:00Z"
}

Field	Description
`can_retry`	जब retry तुरंत भेजा जा सकता हो, तब `true`।
`reason`	वह code जिसके साथ retry विफल होगा। जब `can_retry` `true` हो, तब `null`।
`sends_used`	इस invoice पर पहले से भेजे गए manual retries।
`sends_allowed`	हमेशा `3`।
`retry_available_at`	अगला manual retry कब खुलेगा। जब कोई retry शेष न हो या refusal का cooldown से संबंध न हो, तब `null`।

Manual Retry भेजें

POST /payments/{payment_id}/retry नया payment बनाता है और saved payment method से charge करता है। इसके लिए Editor role आवश्यक है। SDK examples पिछले example के client का पुनः उपयोग करते हैं।

// `client` is the DodoPayments instance from the previous example.
const retry = await client.payments.retry('pay_0NmDtkE0iRvmeTcT6t0ol');

console.log(retry.payment_id, retry.status);

# `client` is the DodoPayments instance from the previous example.
retry = client.payments.retry("pay_0NmDtkE0iRvmeTcT6t0ol")

print(retry.payment_id, retry.status)

curl -X POST https://live.dodopayments.com/payments/pay_0NmDtkE0iRvmeTcT6t0ol/retry \
  -H "Authorization: Bearer $DODO_PAYMENTS_API_KEY"

Response

{
  "payment_id": "pay_2IjeQm4hqU6RA4Z4kwDee",
  "invoice_id": "inv_9Kp2mQ7vRt4LxYw3",
  "status": "processing",
  "retry_attempt": 1,
  "is_manual_retry": true,
  "sends_used": 1,
  "sends_allowed": 3,
  "retry_available_at": "2026-08-26T16:51:00Z"
}

Field	Description
`payment_id`	इस attempt के लिए बनाया गया नया payment।
`invoice_id`	Charge किया गया renewal invoice।
`status`	Charge का परिणाम। `processing` का अर्थ है कि processor ने इसे अभी settle नहीं किया है। `null` का अर्थ है कि response लौटाए जाने से पहले कोई परिणाम record नहीं किया गया। दोनों मामलों में payment webhooks अंतिम परिणाम बताते हैं।
`retry_attempt`	Invoice पर manual retries में इस attempt की स्थिति, जो `1` से शुरू होती है।
`is_manual_retry`	इस endpoint पर हमेशा `true`।
`sends_used`, `sends_allowed`, `retry_available_at`	इस send के बाद retry limit state। `retry_available_at` केवल cooldown clock है। यह तब भी set होता है जब यह charge सफल हो जाए; ऐसी स्थिति में invoice paid है और कोई अगला retry नहीं खुलता।

Error Responses

जब retry की अनुमति नहीं होती, तब POST इनमें से एक HTTP status लौटाता है:

HTTP status	Codes	क्या करें
`404`	`NOT_FOUND`	Payment आपके business से संबंधित नहीं है।
`409`	`MANUAL_RETRY_IN_FLIGHT`, `PREVIOUS_PAYMENT_PENDING`, `CHARGE_NOT_ALLOWED_FOR_SCHEDULED_CANCELLATION`	Block अस्थायी है या पहले कुछ और बदलना होगा। In-flight या pending payment के final state तक पहुँचने की प्रतीक्षा करें या scheduled cancellation हटाएँ।
`422`	`PAYMENT_NOT_RETRYABLE`, `SUBSCRIPTION_INACTIVE`, `SUBSCRIPTION_HAS_NO_PAYMENT_METHOD`, `MANUAL_RETRY_HARD_DECLINE`, `MANUAL_RETRY_ALREADY_PAID`, `BYOP_CONNECTOR_DISABLED`, `MERCHANT_NOT_LIVE`	इस payment को retry नहीं किया जा सकता। Call दोबारा न दोहराएँ।
`429`	`MANUAL_RETRY_LIMIT_REACHED`	Retry state जाँचें और `retry_available_at` तक प्रतीक्षा करें, या सभी तीन retries समाप्त होने पर रुक जाएँ।

Error Codes reference में प्रत्येक code का विवरण है।

Webhooks

Manual retry एक सामान्य payment बनाता है, इसलिए वही webhooks fire होते हैं जो किसी भी renewal attempt के लिए होते हैं:

Event	कब fire होता है
`payment.succeeded`	Retry charge किया गया। Subscription के reactivated होने पर `subscription.active` आता है।
`payment.failed`	Retry decline हुआ। Subscription `on_hold` में रहता है और manual failure automatic retry schedule नहीं करता।
`payment.processing`	Processor ने charge स्वीकार कर लिया है, लेकिन अभी settle नहीं किया है।

इन events के payment object में retry_attempt 1 या उससे अधिक होता है और subscription_id set होता है, ठीक automatic retry की तरह। Payment object में manual attempt को चिह्नित करने वाला कोई field नहीं है, इसलिए यदि आपको manual attempt को scheduled attempt से अलग पहचानना हो, तो retry response से payment_id सुरक्षित रखें।

Payment Webhook Payloads

Payment events के full payload schemas।

Subscription Payment Retries

Manual retries के साथ चलने वाला automatic back-off schedule।

Subscription Dunning

Hard decline के बाद customer को अपना payment method update करने के लिए email करें।

Handle Payment Failures

Decline codes पढ़ें और तय करें कि retry करना कब उपयोगी है।

Error Codes

हर MANUAL_RETRY_* code, उसका trigger और उसका message।

Getting Started

Features

Integrate

Merchant of Record

Miscellaneous

Manual Retry क्या है?

Dashboard से Retry करना

Eligibility

Retry Limits

Manual vs. Automatic Retries

API के माध्यम से Retry करना

जाँचें कि Payment को Retry किया जा सकता है या नहीं

Manual Retry भेजें

Error Responses

Webhooks

Payment Webhook Payloads

संबंधित

Subscription Payment Retries

Subscription Dunning

Handle Payment Failures

Error Codes

​Manual Retry क्या है?

​Dashboard से Retry करना

​Eligibility

​Retry Limits

​Manual vs. Automatic Retries

​API के माध्यम से Retry करना

​जाँचें कि Payment को Retry किया जा सकता है या नहीं

​Manual Retry भेजें

​Error Responses

​Webhooks

Payment Webhook Payloads

​संबंधित

Subscription Payment Retries

Subscription Dunning

Handle Payment Failures

Error Codes

Manual Retry क्या है?

Dashboard से Retry करना

Eligibility

Retry Limits

Manual vs. Automatic Retries

API के माध्यम से Retry करना

जाँचें कि Payment को Retry किया जा सकता है या नहीं

Manual Retry भेजें

Error Responses

Webhooks

संबंधित