---
title: "POST /subscription/edit"
method: POST
path: "/subscription/edit"
---

# POST /subscription/edit

`POST /subscription/edit`

## Headers

- `Idempotency-Key` string

## Request body

- EditSubsRequest
  - `subscriptionId` string, required — Unique identifier of the subscription
  - `newAmount` integer — New recurring amount for the subscription, if changed. The amount in lowest count unit. e.g.: For USD 1, amount is 100 representing 100 cents (The minimum amount should be greater than 1 USD).
  - `newCycleCount` integer — New number of billing cycles for the subscription, if changed.
  - `newNextPaymentDate` integer — New next payment date in epoch milliseconds, if changed. Future payments will be deducted at the frequency interval defined in the subscription, calculated from the new next payment date.
  - `interval` 'DAY' | 'WEEK' | 'MONTH' | 'YEAR' — The interval group between subscriptions. ⚠️ Please note: When editing interval, `intervalCount` and `newNextPaymentDate` must also be provided.
  - `intervalCount` integer — The number of intervals between subscription billings. For example, `interval = MONTH` and `intervalCount = 3` bills every 3 months. ⚠️ Please note: When editing intervalCount, `interval` and `newNextPaymentDate` must also be provided.

## Response `200`

Subscription edited successfully

## Other responses

- `400` — unexpected error

---

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