Overview

Cancel one of the authenticated customer's subscriptions. subscription_id is required. mode defaults to end of period; mode=now cancels immediately and refunds/credits per the plan and account settings — but only when the account enables immediate cancellation. reason is optional. Returns the customer resource with a fresh JWT.

Example:

curl --request POST \
  --url 'https://www.pelcro.com/api/v1/sdk/subscription/cancel?site_id=1232' \
  --header 'Authorization: Bearer <JWT>' \
  --header 'Content-Type: application/json' \
  --data '{ "subscription_id": 4055, "reason": "too_expensive" }'

Notes

• Protected — requires the customer's JWT.
• A missing subscription_id, an unknown subscription, or immediate-cancel when disabled all return 404 with a message.