Manage Subscriptions

Paisr Subscriptions is designed to handle recurring invoicing for services, memberships, digital products, and more. Subscriptions are tied to your customers and can be configured with custom billing intervals.

When a subscription is created, Paisr automatically generates invoices at the scheduled interval and manages the full payment lifecycle on your behalf—from issuance to payment collection and status updates.

Prerequisited

Before creating a subscription, ensure you have the following in place:

  1. At least 1 defined Plan, which determines the pricing and billing interval.
  2. A default Wallet for receiving payouts.

How it works

Subscriptions are defined by a billing schedule and pricing configuration. Once active, Paisr handles the rest on your behalf:

  • Generate a new invoice at each billing interval.
  • Email the invoice to the customer (if enabled).
  • Track the payment status in real time.
  • Notify the customer when charges fail
  • Automatically void unpaid invoices when subscriptions are cancelled or expired.

You can create and manage subscriptions from the Billing section in your Dashboard, or programmatically using the Subscriptions API.

Create Subscription

Navigate to Billing > Subscriptions and click on Create to create a new subscription.

Subscriptions Section

Edit Subscription Details

Select the customer and price options you want to attach to the subscription. You can add up to 10 price options to a single subscription.

When subscribing to more than 1 option, you'll need to make sure that:

  • All price options have the same billing interval.
  • You provide a top-level trail period to override option based trail periods.

New Subscription

Confirm Details

Once you're done setting things up, click on Create to generate the subscription.

Activating Subscriptions

Next step is to activate the subscription. This part can easily be done by sharing the checkout url of the generated invoice with the customer to complete their payment.

Once the initial invoice is paid, the subscription will automatically be activated and renew at each interval. If auto_renew is enabled, Paisr will attemp to charge the customers saved payment method at each interval.

Subscription Details

Lifecycle of a Subscription

Understanding the subscription lifecycle helps you track the current state of a subscription and ensure proper billing.

Below is an overview of how a subscription moves through its lifecycle in Paisr:

Modifying Subscriptions

Once a subscription is created, it can't be modified directly. In order to modify the subscription, you have to update the connected Price Options. There are however some limitations:

  1. Changes will only be applied to future invoices.
  2. Billing interval changes are not inherited.
  3. Only pending and expired subscriptions can be deleted.