Resume a Subscription

​

Resumes a past_due subscription by attempting to collect the outstanding billing cycle payment. If the payment succeeds, the subscription moves back to active and future billing continues from the selected billing cycle anchor.

Use this endpoint after the customer has a valid default payment method and you want to recover a failed automatic renewal. Resume is only available for subscriptions using collection_method: charge_automatically.

If the recovery payment fails, the request returns a payment error and the subscription remains past_due.

You can also review past-due subscriptions in the Merchant Dashboard.

Related guide: Subscriptions

Path Parameters
  • id
    Type: string
    required

    Subscription ID (26-character ULID).

Body·
application/json

Optional request body for resuming a past-due subscription.

  • billing_cycle_anchor
    Type: string enum

    Controls how the billing schedule is aligned after the recovery payment succeeds.

    • now: reset the billing cycle anchor to the resume time and start a new billing period.
    • unchanged: keep the original billing cadence and advance to the period that contains the resume time.
    values
    • now

      Reset the billing cycle anchor to the resume time and start a new billing period.

    • unchanged

      Keep the original billing cadence and advance to the current surrounding billing period.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/v1/subscriptions/{id}/resume
curl https://api.paypercut.io/v1/subscriptions/01HD7M6DRKZ4Q4QEVWJB0RC1S6/resume \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "billing_cycle_anchor": "now"
}'

{
  "id": "01HD7M6DRKZ4Q4QEVWJB0RC1S6",
  "customer": "01KJQ34MWYH0TES77RDXA8T8TT",
  "status": "active",
  "start_date": "2026-01-01T00:00:00Z",
  "next_billing_date": "2026-02-15T10:30:00Z",
  "current_period_start": "2026-01-15T10:30:00Z",
  "current_period_end": "2026-02-15T10:30:00Z",
  "cancel_at_period_end": false,
  "cancel_at": null,
  "canceled_at": null,
  "paused_at": null,
  "trial_start": null,
  "trial_end": null,
  "billing_cycle_anchor": "2026-01-15T10:30:00Z",
  "collection_method": "charge_automatically",
  "days_until_due": null,
  "default_payment_method": "01HD7M6DRKZ4Q4QEVWJB0RC1S6",
  "currency": "USD",
  "livemode": false,
  "ended_at": null,
  "cancellation_details": null,
  "items": [
    {
      "id": "01XXXXXXXXXXXXXXXXXXXXXXX",
      "price": "01XXXXXXXXXXXXXXXXXXXXXXX",
      "product": "01XXXXXXXXXXXXXXXXXXXXXXX",
      "quantity": 1,
      "billing_interval": "monthly",
      "unit_amount": 2999,
      "currency": "USD",
      "recurring": {
        "interval": "monthly",
        "interval_count": 1,
        "usage_type": "licensed"
      },
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-01-15T10:30:00Z"
    }
  ],
  "created": "2026-01-01T00:00:00Z",
  "updated_at": "2026-01-15T10:30:00Z"
}

Subscription resumed successfully.