---
title: "Cancel recurring payment"
method: POST
path: "/recurring/cancel"
tags: ["Recurring Service"]
---

# Cancel recurring payment

`POST /recurring/cancel`

Cancels an active recurring payment and stops future billing cycles for the specified recurring ID.

## Request body

- RecurringCancelRequest
  - `subscriptionId` string, required — Unique subscription identifier associated with the recurring payment.
  - `recurringId` string, required — Unique identifier of the recurring payment.
  - `cancelReasonCode` integer, required — Cancellation reason code. Valid values: 1 = Payment Failure, 2 = Fraud-Related, 3 = Chargeback, 4 = Disabled/Blocked Case/Payer, 5 = Customer Initiated, 6 = Other.
  - `cancelReasonText` string — Additional free-text details for the cancellation reason.

## Response `200`

Recurring payment cancelled successfully

- RecurringCancelResponse
  - `subscriptionId` string — Unique subscription identifier associated with the recurring payment.
  - `recurringId` string — Unique identifier of the recurring payment.
  - `httpStatusCode` integer — HTTP status code.
  - `message` string — Response message.
  - `cancelledAt` string, date-time — Date and time when the recurring payment cancellation was processed.

## Other responses

- `400` — Invalid request data
- `401` — Unauthorized. The access token is missing, invalid, or expired.
- `404` — Recurring payment not found
- `500` — Internal server error

---

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