---
title: "Pause Subscription"
method: POST
path: "/iap/subscriptions/pause"
tags: ["Subscriptions"]
---

# Pause Subscription

`POST /iap/subscriptions/pause`

Pauses a user's active web checkout subscription. The subscription will automatically resume after the pause duration expires.

## Request body

- object
  - `user_id` string, required — The user's external ID.
  - `product_id` string — Specific product to pause. If omitted, pauses the user's active subscription.
  - `pause_duration_days` integer — Number of days to pause the subscription. If omitted, uses the default configured in the cancel flow.

## Response `200`

Subscription paused

- PauseResponse — Response from pausing a subscription.
  - `status` string — Result status.
  - `paused_at` string, date-time — When the subscription was paused.
  - `resumes_at` string, date-time — When the subscription will automatically resume.

## Other responses

- `400` — Invalid request -- missing or malformed parameters.
- `401` — Invalid or missing API key.
- `404` — Resource not found.

---

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