Skip to main content
PATCH
/
v1
/
periods
/
{id}
/
retry_payment
Retry Payment
curl --request PATCH \
  --url https://{defaultHost}/v1/periods/{id}/retry_payment \
  --header 'Authorization: Bearer <token>'
{
  "id": "5e53cbac-302d-43df-8160-4bffbd2741f1",
  "object": "period",
  "ad_hoc_amount": null,
  "end_at": 1770588132,
  "next_payment_retry_at": null,
  "payment_retry_count": 0,
  "payoff": false,
  "quantity": 1,
  "renewal": true,
  "renewal_reminder_sent_at": null,
  "restoral": false,
  "skip_proration": false,
  "start_at": 1767909732,
  "status": "payment_failed",
  "checkout": "3e622909-07fb-415e-8b10-b9132988f258",
  "price": "44c53844-78bd-4de5-867a-5e001602ef4c",
  "subscription": "f2ac730a-54c2-44cc-9e2e-5005c94d8770",
  "variant": null,
  "created_at": 1767909732,
  "updated_at": 1767909732
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Response

200 - application/json

Success

​
id
string | null

The UUID of the specific object.

​
object
string

A string describing the object type returned.

​
end_at
integer | null

End of the period. This will be null when the period is for a subscription with a one-time price.

​
ad_hoc_amount
integer | null

The amount to use for this period when the associated price is ad_hoc=true.

​
next_payment_retry_at
integer | null

The time at which payment will be automatically retried.

​
payment_retry_count
integer

Number of payment retries made for this period, from the perspective of the payment retry schedule. Only automatic retries increment the count.

​
payoff
boolean

Indicates whether or not this period paid off all remaining periods.

​
quantity
integer

The quantity of products being purchased.

​
renewal
boolean

Whether or not this period has been generated automatically for a subscription renewal.

​
renewal_reminder_sent_at
integer | null

The time at which the renewal reminder notification was sent to the customer.

​
restoral
boolean

Whether or not this period was generated from a subscription restoral.

​
skip_proration
boolean

Whether or not proration should be skipped when generating this period's checkout.

​
start_at
integer | null

Start of the period.

​
status
string

The current status of this period, which can be one of pending, payment_failed, paid, processing, or void.

​
checkout

Expandable – The associated checkout ID.

​
price

Expandable – The associated price ID.

​
subscription

Expandable – The associated subscription ID.

​
variant

Expandable – The associated variant ID.

​
created_at
integer | null

Time at which the object was created. Measured in seconds since the Unix epoch.

​
updated_at
integer | null

Time at which the object was last updated. Measured in seconds since the Unix epoch.