HYhyperswitch
Subscriptions

Subscription - Pause Subscription

Pause the subscription

post/subscriptions/{subscription_id}/pause

Request

Path parameters

subscription_idstring required

The unique identifier for the subscription

Headers

X-Profile-Idstring required

Profile ID for authentication

Request body

pause_option'immediately' | 'end_of_term' | 'specific_date'
pause_atstring nullable

Optional date when the subscription should be paused (if not provided, pauses immediately)

Response

Subscription paused successfully

idstring required

A type for subscription_id that can be used for subscription ids

status'active' | 'created' | 'in_active' | 'pending' | 'trial' | 'paused' | 'unpaid' | 'onetime' | 'cancelled' | 'failed' 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.
merchant_reference_idstring nullable

Merchant specific Unique identifier.

profile_idstring required

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

merchant_idstring required

A type for merchant_id that can be used for merchant ids

customer_idstring required

A type for customer_id that can be used for customer ids

paused_atstring nullable

Date when the subscription was paused

Changes

No recorded changes to this operation across all 1 revision of this API.