---
title: "Cancel a schedule. Requires the registrationId of an existing transaction of type Register / Debit-with-register / Preuathorize-with-register"
method: POST
path: "/schedule/{apiKey}/{scheduleId}/cancel"
tags: ["schedule"]
---

# Cancel a schedule. Requires the registrationId of an existing transaction of type Register / Debit-with-register / Preuathorize-with-register

`POST /schedule/{apiKey}/{scheduleId}/cancel`

## Request

- Base URL: `https://gateway.tillpayments.com/api/v3`
- URL: `https://gateway.tillpayments.com/api/v3/schedule/{apiKey}/{scheduleId}/cancel`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/tillpayments/apis/till-payments-gateway/docs/schedule/:apiKey/:scheduleId/cancel/post.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `apiKey` string, required
- `scheduleId` string, required

## Request body

- CancelSchedule

## Response `200`

Schedule response

- ScheduleResponse
  - `success` boolean
  - `scheduleId` string
  - `registrationId` string
  - `oldStatus` 'ACTIVE' | 'PAUSED' | 'CANCELLED' | 'ERROR' | 'CREATE-PENDING'
  - `newStatus` 'ACTIVE' | 'PAUSED' | 'CANCELLED' | 'ERROR' | 'CREATE-PENDING'
  - `scheduledAt` string
  - `merchantMetaData` string

---

[API](https://skmtc.dev/tillpayments/apis/till-payments-gateway.md) - [All operations](https://skmtc.dev/tillpayments/apis/till-payments-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/tillpayments/apis/till-payments-gateway/revisions/42c40d316a83?raw)