---
title: "Pause a subscription"
method: PUT
path: "/subscription/pause"
---

# Pause a subscription

`PUT /subscription/pause`

Pause an active subscription in the payment system. The subscription will be paused and no further charges will be made until it is resumed. Only available for Stripe and Paddle subscriptions.

## Request body

- object
  - `pay_system_id` string, required — ID of the subscription in external Stripe/Paddle, e.g. sub_1PzNJzCsRq5tBi2bbfNsAf86or I-H7HC902MYM49
  - `behavior` 'keep_as_draft' | 'mark_uncollectible' | 'void' — Behavior for paused subscription (Stripe only). Options: 'keep_as_draft', 'mark_uncollectible', 'void'

## Response `200`

Subscription paused successfully.

- object
  - `success` integer
  - `error` integer
  - `message` string

## Other responses

- `400` — Invalid request or missing parameters.

---

[API](https://skmtc.net/web2wave/apis/web2wave-api.md) · [All operations](https://skmtc.net/web2wave/apis/web2wave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/web2wave/web2wave-api/versions/c88545119271/schema)