Subscription Management

Manage active subscriptions and daily deliveries in your marketplace.

Overview

After a subscription is created, customers can manage their delivery schedule, change meal selections, update locations, and more. Each provider has operational cutoffs that determine when modifications can be made.

Available Actions

View Subscriptions

List all customer subscriptions or get details for a specific subscription.

List Subscriptions

Subscription Details

Modify Meals

Change meal selections for upcoming deliveries (if provider allows).

Change Meals

Update Delivery Details

Change location, delivery window, or pickup branch for scheduled deliveries.

Change Location

Change Delivery Window

Change Pickup Branch

Manage Delivery Schedule

Postpone, pause, or resume deliveries based on customer needs.

Postpone/Pause/Resume

Cancel Subscription

Cancel active subscription and all remaining deliveries.

Cancel Subscription

Operational Constraints

Each provider sets operational cutoffs that determine when customers can modify their subscriptions. These are available in the subscription details:

Date Constraints

Field	Description
`min_cancel_date`	Earliest date customer can cancel deliveries
`max_cancel_date`	Latest date customer can cancel deliveries
`min_resume_date`	Earliest date customer can resume paused subscription
`max_resume_date`	Latest date customer can resume subscription

Credit Information

Field	Description
`cancel_credits`	Credits available from cancelled/postponed deliveries
`paused_days`	Number of days subscription is currently paused
`pause_attempts_credits`	Remaining pause attempts allowed

Modification Permissions

Field	Description
`can_change_location`	Can customer change delivery location?
`can_change_meals`	Can customer change meal selections?
`can_change_branch`	Can customer change pickup branch?
`can_change_delivery_window`	Can customer change delivery time?

Provider Cutoffs

Providers set cutoff times (e.g., 24-48 hours before delivery) for modifications. Always check these constraints before allowing customers to make changes.

Managing Running Subscriptions

View Subscription Status

Use Subscription Details to get:

Current subscription status

Upcoming deliveries (sub-orders)

Available credits

Modification permissions

Date constraints

Display Upcoming Deliveries

Show customers their delivery schedule with:

Delivery dates

Selected meals

Delivery location/branch

Delivery window

Sub-order status

Enable Modifications

Based on subscription fields, enable/disable actions:

Common Scenarios

Postponing Deliveries

Customer wants to skip some deliveries:

Check min_cancel_date and max_cancel_date

Select dates to postpone

Call postpone endpoint

Credits added to subscription

Sub-orders cancelled for selected dates

Changing Meals

Customer wants different meals:

Check can_change_meals permission

Verify within modification window

Show available meal options

Submit meal changes

Update sub-order meals

Resuming Subscription

Customer wants to use credits:

Check available cancel_credits

Check min_resume_date and max_resume_date

Select dates to resume

Credits converted to new sub-orders

New deliveries scheduled

Subscription Management

Overview#

Available Actions#

Operational Constraints#

Date Constraints#

Credit Information#

Modification Permissions#

Managing Running Subscriptions#

View Subscription Status#

Display Upcoming Deliveries#

Enable Modifications#

Common Scenarios#

Postponing Deliveries#

Changing Meals#

Resuming Subscription#

Overview

Available Actions

Operational Constraints

Date Constraints

Credit Information

Modification Permissions

Managing Running Subscriptions

View Subscription Status

Display Upcoming Deliveries

Enable Modifications

Common Scenarios

Postponing Deliveries

Changing Meals

Resuming Subscription