Billing & Invoices

Paisr provides a full-stack billing system that's designed to simplify your workflows end-to-end. Whether you're billing one-time or recurring customers, Paisr helps you manage the full billing lifecycle from issuing, to payment collection and settlement.

Invoices are personalized, support multiple currencies, and integrate seamlessly with your customer records for efficient tracking and reporting.

Prerequisited

Before you start billing customers, please make sure your profile meets the following conditions:

  1. Your business profile must be in a pending, verified, or limited verification state.
  2. A default Wallet must be set up and active for receiving payouts.

If your buiness fails to meet these conditions, Payouts will be delayed and payments will stay in a processing state untill your profile meets the requirements for receiving payouts.

How it works

Each invoice is unique and can include up to 500 line-items. Once issued, customers can pay the invoice via a secure checkout link or custom integration.

You can generate and manage invoices directly from the Billing section in your Dashboard, or programmatically using the Invoices API.

Create Invoice

Navigate to Billing > Invoices and click on Create to create a new invoice.

Invoices Section

Edit Invoice Details

Add a description on what the invoice is about, set the due date, select the customer and currency.

New Invoice

Add Line Items

Add atleast 1 line item to the invoice. Each line item has a description, unit price and quantity. The unit price must be atleast 0.01, and quantity atleast 1.

New Invoice Item

Confirm Details

Once you're done adding line items, click on Create to generate the invoice.

Paying an Invoice

Next step is to receive payment for the invoice. This can easily be done by sharing the checkout url with the customer to complete their payment.

Invoice Details

You can also send it to them via email directly from your Dashboard.

Invoice Lifecycle

Understanding the invoice lifecycle helps you track the current state of a invoice.

Invoices linked to subscriptions inherit lifecycle rules based on the subscription's status. This ensures automated billing cycles are handled gracefully.

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

Modifying Invoices

Invoices in Paisr can be updated or deleted, but only under specific conditions to ensure billing integrity and compliance with payment workflows.

  1. Editable States

    You can modify an invoice only if it is in one of the following states:

    • draft - Invoices in draft mode are fully editable.
    • unpaid - Invoices that have been issued but not yet paid can also be updated.
  2. Invoices Linked to Subscriptions

    Invoices that are automatically generated by a subscription follow a stricter rule:

    • These invoices cannot be directly modified or deleted.
    • To remove such an invoice, you must first delete the associated subscription. Once deleted, all invoices generated by that subscription will automatically be deleted.

Once an invoice is marked as paid or void, it becomes locked and can no longer be altered or removed. This ensures the integrity of your financial records.