Skip to main content
POST
Retry a failing invoice now
Requeues a past-due invoice so the retry worker picks it up on its next pass instead of waiting for next_retry_at. The worker then runs the normal settle path — this endpoint charges nothing itself and posts no ledger legs. The request is refused with a 409 unless the invoice is tenant-owned, past_due, not paused, not collected by a mandate, and has no payment attempt still in flight — the same envelope the automated engine honors, so a manual retry can never stack a second charge on a settling one. Find candidates on the collections queue; if the invoice is paused, resume it with Pause Dunning first.

Path Parameters

No request body.

Example Request

Response

Fields

Errors

The 409 is also returned when the invoice’s state changed between the check and the requeue (for example it settled a moment earlier) — the response is never a false success. Errors use the standard envelope — see Errors.

Authorizations

Authorization
string
header
required

Tenant API key obtained from POST /auth/register or POST /v1/developer/keys.

Path Parameters

id
string<uuid>
required

Response

Requeued for retry.

data
object