Skip to main content
POST
JavaScript

Authorizations

Authorization
string
header
required

Send your API key as a bearer token: Authorization: Bearer <api_key>. A test mode key starts with dodo_test_, for example dodo_test_AbCd1234EfGh5678.<secret>. A live mode key starts with dodo_live_. Use a test mode key on test.dodopayments.com and a live mode key on live.dodopayments.com. Keys from before these tags have no tag and operate as before.

Path Parameters

payment_id
string
required

Id of the failed payment

Response

The retry was sent. status carries its outcome

invoice_id
string
required

The invoice the send charged.

is_manual_retry
boolean
required

Always true on this route. Tells the row apart from an automatic attempt.

payment_id
string
required

The payment row this send created.

retry_attempt
integer<int32>
required

Which attempt this send is, counting manual sends on the invoice.

sends_allowed
integer<int64>
required
sends_used
integer<int64>
required

Manual sends spent on this invoice, including this one.

retry_available_at
string<date-time> | null

When the next send becomes available. Null when no send is left.

status
null | enum<string>

Outcome of the charge. processing means the processor has not settled it yet, and the payment webhooks report the result.

Available options:
succeeded,
failed,
cancelled,
processing,
requires_customer_action,
requires_merchant_action,
requires_payment_method,
requires_confirmation,
requires_capture,
partially_captured,
partially_captured_and_capturable
Last modified on October 7, 2026