Skip to main content

​
Overview

Shoppex handles recurring payments automatically. Create subscription products and let us manage renewals, retries, and cancellations.

​
Creating a Subscription Product

1

Create Product

Go to Products → Create Product and select Subscription as the product type.
2

Configure Billing

Set the billing interval:
  • Daily - Charged every day
  • Weekly - Charged every 7 days
  • Monthly - Charged on the same day each month
  • Yearly - Charged annually
3

Set Trial Period (Optional)

Offer a free trial before the first charge:
  • 7-day trial
  • 14-day trial
  • 30-day trial
  • Custom duration

​
Subscription Lifecycle

​
Handling Failed Payments

When a renewal payment fails, Shoppex:
  1. Retries automatically - 3 attempts over 7 days
  2. Notifies the customer - Email with payment update link
  3. Marks as past_due - Subscription continues during grace period
  4. Cancels - After all retries fail
Configure retry behavior in Settings → Subscriptions.

​
Customer Portal

Give customers control over their subscriptions via the Shoppex billing portal. Each customer receives a unique portal link in their confirmation emails where they can:
  • View billing history
  • Update payment method
  • Cancel subscription
  • Download invoices
The customer portal link is included in all subscription-related emails sent to customers.

​
Webhooks

Subscribe to these events for subscription updates:
EventDescription
subscription:createdNew subscription started
subscription:cancelledSubscription cancelled
See the Webhooks Guide for setup instructions.

​
Prorating

When customers upgrade or downgrade:
  • Upgrade: Charged the difference immediately
  • Downgrade: Credit applied to next invoice
Proration is calculated based on days remaining in the current billing period.