Billing & subscriptions
Issue invoices and manage recurring billing with Wajub — one-shot invoices, recurring invoices, and subscription patterns.
Wajub provides billing tools through the Invoice API for generating, sending, and tracking invoices — both one-off and recurring — and a recurring billing pattern you can build on top of the Payments API for subscription-style charges.
Modules at a glance
Related pages
Choosing the right approach
| Need | How to do it |
|---|---|
| Bill a customer once | POST /invoices + POST /invoices/{id}/send |
| Bill automatically at regular intervals | POST /invoices with is_recurring: true |
| Accept a one-off payment | POST /payments — use Payments, not Billing |
| Build a subscription system (plans, tiers, trials) | Follow the recurring billing guide on top of POST /payments |
| Offer self-serve SaaS subscriptions (products, prices, coupons) | Planned — see the note below. |
How recurring billing works
With Invoice
The Invoice API supports recurring invoices natively: create an invoice with
is_recurring: true and a cycle (e.g. monthly, yearly). Wajub automatically
generates the next invoice at the end of each cycle and sends it to the customer.
This is ideal for simple recurring billing: a fixed amount at a fixed interval, with automatic generation. See Invoice → for the full API.
With Payments (DIY)
For advanced scenarios — tiered plans, metered billing, free trials, coupons — you
build the subscription logic in your application and use POST /payments to initiate
charges. See the recurring billing guide for a complete
architecture with code examples in Node.js.
Dedicated Subscriptions product
A standalone Subscriptions API (products, prices, coupons, self-serve management) is planned but not yet available. For now, use Invoice for simple recurring billing or the DIY Payments approach for advanced cases. Contact support to express interest in early access.
Was this page helpful?