---
title: "Cancel a recurring payment"
method: DELETE
path: "/recurring-payments/{reference}"
tags: ["Recurring Payments"]
---

# Cancel a recurring payment

`DELETE /recurring-payments/{reference}`

This cancels the recurring payment for the reference provided. Recurring payment references start with `tbx-r-`

## Path parameters

- `reference` string, required

## Response `200`

Recurring payment cancelled successfully.

- RecurringPayment
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `paused_at` string, date-time, nullable
  - `paused_until` string, date-time, nullable
  - `next_payment_date` string
  - `reference` string
  - `account_id` integer
  - `interval` string
  - `cancelled_at` string, date-time, nullable
  - `cancellation_requested_at` string, date-time, nullable
  - `status` object
    - `id` integer
    - `class` string
    - `description` string
    - `active` integer
  - `amount` object
    - `amount` number, float
    - `tax` number, float
    - `period` string
  - `cancel_reason` string, nullable
  - `links` object
    - `initial_payment` string
    - `payment_history` string[]

## Other responses

- `404` — Recurring payment not found.

---

[API](https://skmtc.net/tebex/apis/tebex-checkout-api.md) · [All operations](https://skmtc.net/tebex/apis/tebex-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tebex/tebex-checkout-api/revisions/a52c87b9a2b9/schema)