Billing & Invoicing
Overview
Kopo Pay Invoicing is a complete billing solution that automates payment collection, PDF generation, and revenue reporting. Whether you're sending a one-off invoice for professional services or managing thousands of recurring subscription bills, our API handles the entire lifecycle.
Auto-Collection
Automatically charge stored payment methods on the due date.
PDF Generation
Professional, platform-branded PDFs generated for every invoice.
Global Tax
Automatic tax calculation based on customer location.
One-off Invoices
Send a manual invoice to a customer for a specific purchase or service.
Step 1: Create an Invoice
const invoice = await kopopay.invoices.create({
customer: 'cus_123',
description: 'Consulting Services - April',
});Step 2: Add Invoice Items
const item = await kopopay.invoiceItems.create({
customer: 'cus_123',
invoice: invoice.id,
amount: 5000,
currency: 'usd',
description: '5 hours of professional consulting',
});Recurring Invoicing
For subscriptions, Kopo Pay generates invoices automatically at the start of every billing cycle.
Subscription Lifecycle
- T-3
`invoice.upcoming` event fires. Great for notifying customers about upcoming charges.
- T=0
`invoice.created` event fires. The invoice is drafted and finalized.
- T+1
`invoice.paid` event fires once payment is successfully collected.
Tax & Discounts
Apply tax rates and coupons to your invoices with simple API parameters.
const invoice = await kopopay.invoices.create({
customer: 'cus_123',
default_tax_rates: ['txr_vat_20'],
discounts: [{ coupon: 'SPRING_SALE_2026' }],
});Payment Collection
Auto-Collection
Charge the saved card on file. If it fails, Kopo Pay triggers Smart Retries.
Send for Payment
Email the invoice to the customer with a link to a hosted payment page.