delete
https://www.pelcro.com/api/v1/core/subscriptions//phases
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Overview
Delete one or all future phases from a subscription schedule. Useful when a customer wants to undo a scheduled renewal or when replacing renewal offers.
Modes
| Mode | Behavior |
|---|---|
last_phase (default) | Deletes only the last future phase |
all_phases | Deletes all future phases, leaving only the current phase |
Restrictions
| Condition | Result |
|---|---|
| Subscription has no schedule | 404 error |
| Subscription has only one phase | 422 error |
| No future phases exist | 422 error |
| Phase is a gifted renewal | Cannot be deleted |
Behavior After Deletion
- Auto-renew plan: After deleting all phases,
end_behavioris set torelease(subscription will auto-renew after the last remaining phase) - Self-renew plan: After deleting all phases,
end_behavioris set tocancel(subscription expires after the last remaining phase) - Advance invoices for deleted phases are voided or refunded depending on payment status
Webhook
No explicit webhook event is dispatched for phase deletion. The subscription model update may trigger subscription.updated via the Eloquent observer if the subscription record is saved during the operation.