---
title: "Change subscription recurrent plan"
method: PUT
path: "/subscription/{id}"
tags: ["Subscription"]
---

# Change subscription recurrent plan

`PUT /subscription/{id}`

## Path parameters

- `id` string, required — Gateway subscription ID

## Headers

- `X-Request-ID` string

## Request body

- object
  - `price` object[]
    - `offset` string — Number of days by how long the transaction will be delayed
    - `amount` number, double — Amount of operation
    - `currency` string, ISO3 — Currency of operation in ISO3 format
    - `repeat` union
      - boolean — Set to <b>false</b> to not repeat the transation, and <b>true</b> - to repeat the transation
      - integer — Count of repeats
  - `metadata` object — Use to add additional information and related data

## Response `200`

Updated

- object
  - `id` string — Gateway subscription ID
  - `status` 'active' | 'canceled'
  - `type` 'trial' | 'free-trial' | 'regular'
  - `cycle` number — | value | description | |---|---| | 0 | subscription has an initial payment | | n | subscription has n recurrent payments |
  - `skuName` string
  - `siteId` string — Gateway site ID (created on the Merchant portal)
  - `renewalDate` string, date-time
  - `cancelDate` string, date-time, nullable
  - `consumerId` string — Gateway consumer ID (user ID)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/centrobill/apis/centrobill-payment-api.md) · [All operations](https://skmtc.dev/centrobill/apis/centrobill-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/centrobill/centrobill-payment-api/revisions/d0334aeb55ce/schema)