Canceling Subscriptions

​

Timing options

​

Cancel via the API

curl -X POST https://api.alguna.io/subscriptions/sub_abc123/cancel \
  -H "Authorization: Bearer $ALGUNA_API_KEY" \
  -H "Alguna-Version: 2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{
    "effective": "end_of_term",
    "reason": "moving_provider",
    "reason_description": "Consolidating tooling with their existing vendor"
  }'

import os

import requests

HEADERS = {
    "Authorization": f"Bearer {os.environ['ALGUNA_API_KEY']}",
    "Alguna-Version": "2026-04-01",
    "Content-Type": "application/json",
}

response = requests.post(
    "https://api.alguna.io/subscriptions/sub_abc123/cancel",
    headers=HEADERS,
    json={
        "effective": "end_of_term",
        "reason": "moving_provider",
        "reason_description": "Consolidating tooling with their existing vendor",
    },
    timeout=10,
)
response.raise_for_status()
subscription = response.json()
print(subscription["status"], subscription["contract"].get("end_date"))

​

Reason codes

​

Cancel via the dashboard

1

Open the cancellation dialog

On the Subscription Details page, open the three-dot menu (...) in the top-right corner and click End Subscription.

2

Choose timing and reason

• When: End of current billing period (default), Specific date, or Immediately.
• Reason: required; one of the codes above, with an optional description.
• Send cancellation email: tick to notify the customer.

3

Decide what happens to unissued invoices

If the subscription has invoices that are generated but not yet issued, choose:

• Do nothing — leave them as they are, to review and resolve manually after cancellation.
• Cancel unissued invoices — void them, then cancel the subscription.
• Issue invoices — issue them to the customer, then cancel the subscription.

4

Confirm

Click End Subscription to schedule the cancellation, or Keep Subscription to back out without changing anything.

​

What happens on cancellation

• subscription.cancelation_scheduled fires when the cancellation is recorded; subscription.canceled fires when it takes effect. See Webhooks.
• Future billing stops from the effective date. Charges already issued stand.
• Entitlements from the subscription stop being returned by GET /customers/{id}/entitlements once the subscription is no longer active; revoke access in your application on subscription.canceled.
• Cancelling at the end of the billing period needs no credit: the customer keeps access to what they paid for. Cancelling immediately ends billing today; review the subscription’s invoices afterwards and issue a credit note if the customer is owed money for an unused advance charge. See Proration.

​

Reverting a scheduled cancellation

• Once the cancellation has taken effect the subscription is canceled, which is final. Restarting the customer means creating a new subscription.
• Invoices that were voided or issued when the cancellation was scheduled are not restored.

​

Pausing instead of cancelling

​

Deleting a draft

​

Customer self-service

​

Troubleshooting

​

Next steps