Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Headers

Idempotency-Key
string

A unique key for making the request idempotent. Must match pattern: ^[a-zA-Z0-9\-_:\.]+$. See Idempotent Requests for more details.

Maximum string length: 255
Pattern: ^[a-zA-Z0-9\-_:\.]+$

Body

application/json

Manual Retry Subscription

subscriptionId
string
required

Unique identifier of the subscription whose failed payment should be retried.

Example:

"sub_fooBOwYsaK50AEfK"

Response

Manual retry response

success
boolean

Indicates whether the manual retry payment was successful.

Example:

true

minManualRetryDate
string<date-time> | null

Earliest time at which another manual retry can be attempted based on the 4-hour cooldown.

Example:

"2026-09-08T14:30:00.000+00:00"

status
enum<string>

Current subscription status after the retry attempt. Refer subscription statuses.

Available options:
ACTIVE,
UNPAID,
ENDED
Example:

"ACTIVE"

errorCode
string | null

Machine-readable failure reason when the manual retry is unsuccessful. null on success. See all possible values here.

Example:

"card_declined"

errorMessage
string | null

Human-readable failure reason when the manual retry is unsuccessful. null on success.

Example:

null