Skip to main content
POST
/
subscriptions
/
{subscription_id}
/
resume
Subscription - Resume Subscription
curl --request POST \
  --url https://sandbox.hyperswitch.io/subscriptions/{subscription_id}/resume \
  --header 'Content-Type: application/json' \
  --header 'X-Profile-Id: <x-profile-id>' \
  --header 'api-key: <api-key>' \
  --data '{
  "resume_option": "immediately",
  "unpaid_invoices_handling": "schedule_payment_collection"
}'
{
  "id": "<string>",
  "status": "active",
  "merchant_reference_id": "<string>",
  "profile_id": "<string>",
  "merchant_id": "<string>",
  "customer_id": "<string>",
  "next_billing_at": "<string>"
}

Authorizations

​
api-key
string
header
required

Use the API key created under your merchant account from the HyperSwitch dashboard. API key is used to authenticate API requests from your merchant server only. Don't expose this key on a website or embed it in a mobile application.

Headers

​
X-Profile-Id
string
required

Profile ID for authentication

Path Parameters

​
subscription_id
string
required

The unique identifier for the subscription

Body

application/json

Request payload for resuming a subscription.

​
resume_option
enum<string>
Available options:
immediately,
specific_date
​
resume_date
string | null

Optional date when the subscription should be resumed (if not provided, resumes immediately)

​
charges_handling
enum<string>
Available options:
invoice_immediately,
add_to_unbilled_charges
​
unpaid_invoices_handling
enum<string>
Available options:
no_action,
schedule_payment_collection

Response

Subscription resumed successfully

Response payload returned after successfully resuming a subscription.

​
id
string
required

A type for subscription_id that can be used for subscription ids

​
status
enum<string>
required

Possible states of a subscription lifecycle.

  • Created: Subscription was created but not yet activated.
  • Active: Subscription is currently active.
  • InActive: Subscription is inactive.
  • Pending: Subscription is pending activation.
  • Trial: Subscription is in a trial period.
  • Paused: Subscription is paused.
  • Unpaid: Subscription is unpaid.
  • Onetime: Subscription is a one-time payment.
  • Cancelled: Subscription has been cancelled.
  • Failed: Subscription has failed.
Available options:
active,
created,
in_active,
pending,
trial,
paused,
unpaid,
onetime,
cancelled,
failed
​
profile_id
string
required

A type for profile_id that can be used for business profile ids

​
merchant_id
string
required

A type for merchant_id that can be used for merchant ids

​
customer_id
string
required

A type for customer_id that can be used for customer ids

​
merchant_reference_id
string | null

Merchant specific Unique identifier.

​
next_billing_at
string | null

Date when the subscription was resumed