Breeze's Subscription product empowers merchants to offer seamless, recurring billing experiences—designed for both flexibility and automation. With a single integration, merchants can set up free trials, manage recurring charges, and respond to billing events without the overhead of building complex subscription infrastructure.

Breeze handles the entire subscription lifecycle—from customer creation and payment collection to entitlement tracking and webhook notifications. Once a customer is onboarded, our system automates retries for failed payments, sends proactive communication (like receipts and reminders), and provides real-time updates on subscription status changes.

As a Merchant of Record (MoR), Breeze handles compliance, risk, KYC (Know Your Customer), and banking details—so your team doesn’t need to manage any of the operational or regulatory overhead.

How It Works

sequenceDiagram
  participant YourBackend as Your Backend
  participant Breeze as Breeze Subscription Service

  YourBackend->>Breeze: (1) Create Subscription Request (API call)
  Breeze-->>YourBackend: (1') Return Hosted Payment Page URL
  YourBackend->>Breeze: (2) Redirect User to Payment Page
  Breeze-->>YourBackend: (3) Webhook Notifications (status updates)

1. Create a Customer (If you haven't)

• Call Breeze API to create a customer entry

2. Create a Subscription Request

• Call Breeze’s subscription API with key parameters:
  • productId, priceId, and optional trial duration
  • customer.id
• Receive a url in the response—this is the hosted payment page where the customer can complete the first payment.

3. Redirect the User

• Send your customer to the provided checkout url.
• Breeze handles the initial payment, customer creation (if not already present), and sends email confirmations and receipts.
• Once payment is successful, the subscription becomes ACTIVE.
• If a trial is configured, the billing cycle starts after the trial ends.

If a customer's payment fails, Breeze will retry and notify both the merchant and the customer with instructions to update the payment method.

4. Receive Webhooks

• Breeze sends webhook events to your backend to keep you in sync:
  • SUBSCRIPTION_STATUS_UPDATED
  • INVOICE_STATUS_UPDATED

Use these to update your internal system or notify users.

Key Takeaways:

• Breeze offers a hosted subscription flow: from free trials to recurring payments.
• Merchants integrate once and get webhook-driven updates on all key events.
• Subscription state transitions (e.g. active → grace_period → canceled) are managed and exposed via APIs and webhooks.
• No need to build your own billing engine, grace period enforcement, or retry logic.