Cancel immediately

Immediate cancellation terminates the subscription right away. No further invoices are generated.

Dashboard

API

Go to Billing > Subscriptions in the sidebar
Select the subscription to cancel
Click Cancel subscription
Choose Cancel immediately
Select a refund option
Confirm the action

The subscription transitions to Cancelled state. This is a terminal state and cannot be reversed.

Cancel at period end

Schedule the subscription to cancel at the end of the current billing period. The customer continues to have access until the period expires.

API

Python SDK

$ curl -X PATCH https://api.paymentkit.com/api/{account_id}/subscriptions/{subscription_id} \
> -H "Authorization: Bearer sk_live_..." \
> -H "Content-Type: application/json" \
> -d '{
>   "cancel_at_period_end": true
> }'

The subscription remains Active until the current period ends, then automatically transitions to Cancelled.

Cancel on a specific date

Schedule the subscription to cancel on a custom date. Use this for contract end dates or customer-requested future cancellations.

$ curl -X POST https://api.paymentkit.com/api/{account_id}/subscriptions/{subscription_id}/schedule-cancellation \
> -H "Authorization: Bearer sk_live_..." \
> -H "Content-Type: application/json" \
> -d '{
>   "cancel_at": "2026-06-01T00:00:00Z",
>   "refund_option": "none"
> }'

The subscription continues billing normally until the scheduled date, then cancels automatically.

Refund options

When cancelling, choose how to handle the customer’s payments:

Option	Behavior
`none`	Cancel with no refund. The default.
`full`	Refund the full paid amount for the current billing period.
`prorated`	Refund only the unused portion of the current period, calculated by remaining time.
`cancel_unpaid`	Void all open and draft invoices instead of refunding paid ones.

Only invoices with licensed (non-metered) prices are eligible for refunds. Metered usage that has already been consumed is not refundable.

Preview a cancellation

Before confirming, preview the refund amount without applying any changes:

$ curl -X POST https://api.paymentkit.com/api/{account_id}/subscriptions/{subscription_id}/cancel \
> -H "Authorization: Bearer sk_live_..." \
> -H "Content-Type: application/json" \
> -d '{
>   "refund_option": "prorated",
>   "is_preview": true
> }'

The response includes the calculated refund amount. No database changes or payment operations are performed.

Undo a scheduled cancellation

Remove a scheduled cancellation before it takes effect:

Cancel at period end

Cancel on date

$ curl -X PATCH https://api.paymentkit.com/api/{account_id}/subscriptions/{subscription_id} \
> -H "Authorization: Bearer sk_live_..." \
> -H "Content-Type: application/json" \
> -d '{
>   "cancel_at_period_end": false
> }'

The subscription continues renewing as normal.

When to use each approach

Approach	Use case
Cancel immediately	Customer requests immediate termination. Pair with a refund option.
Cancel at period end	Customer wants to stop renewing but use the service through the paid period. Most common for self-service flows.
Cancel on date	Contract has a defined end date, or customer requests cancellation on a future date.

Cancellation is irreversible. To restart billing for a cancelled customer, create a new subscription.

Webhook events

Event	Trigger
`subscription.cancelled`	Subscription was cancelled (immediate, at period end, or on scheduled date)