---
title: "Update a product payment plan"
method: PATCH
path: "/api/products/{productId}/payment-plans/{planId}"
tags: ["Product Payment Plans"]
---

# Update a product payment plan

`PATCH /api/products/{productId}/payment-plans/{planId}`

## Path parameters

- `productId` string, required
- `planId` string, required

## Request body

- PaymentPlanUpdateRequest — Update editable payment plan fields.
  - `name` string — Payment plan name shown to customers.
  - `type` 'free' | 'onetime' | 'emi' | 'subscription'
  - `oneTimeAmount` number — Required when `type` is `onetime`.
  - `emiAmount` number — Required when `type` is `emi`.
  - `emiTotalInstallments` number — Required when `type` is `emi`.
  - `subscriptionMonthlyAmount` number — Use for monthly subscriptions. For `subscription`, provide exactly one subscription amount.
  - `subscriptionYearlyAmount` number — Use for yearly subscriptions. For `subscription`, provide exactly one subscription amount.
  - `description` string

## Response `200`

Success.

- PaymentPlan
  - `planId` string
  - `name` string
  - `type` 'free' | 'onetime' | 'emi' | 'subscription'
  - `entityId` string
  - `entityType` string
  - `oneTimeAmount` number
  - `emiAmount` number
  - `emiTotalInstallments` number
  - `subscriptionMonthlyAmount` number
  - `subscriptionYearlyAmount` number
  - `description` string
  - `isDefault` boolean

## Other responses

- `400` — Unsupported payment plan field.
- `422` — Payment plan validation failed.

## Changes

- **2026-07-17** `3b48f60910dc` — 1 info
  - endpoint added
- **2026-04-19** `85a1c15f561d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/codelitdev/apis/courselit-rest-api/changes/api/products/:productId/payment-plans/:planId/patch.md)

---

[API](https://skmtc.dev/codelitdev/apis/courselit-rest-api.md) · [All operations](https://skmtc.dev/codelitdev/apis/courselit-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codelitdev/courselit-rest-api/revisions/3b48f60910dc/schema)