Payments

Invoice Module

The Invoice module manages the lifecycle of billing requests. Each record serves as a bridge between your services and Vezmo's payment gateway, handling subtotal logic, tax overhead, and discount application before finalizing a checkout session.

Invoice Lifecycle Flow

Step 1Input dataClient, line items, tax & due date

Step 2Invoice generatedTotals computed server-side

Step 3Vezmo-hosted pageShareable, branded payment page

Visual flow: input data → invoice generation → a Vezmo-hosted payment page.

Invoice Core Logic

Line Item Logic

Aggregates products, services, and quantities to calculate the gross subtotal. Each item is individually tracked for financial auditing.

Discounts & Taxes

Supports fixed-amount or percentage-based deductions. The system recalculates net totals in real-time before pushing to Vezmo.

Due Date Enforcement

Monitors payment deadlines. Invoices automatically transition to "Overdue" status in the dashboard if the due date passes.

PAYMENT STATES

DraftOpenPaidOverdue

Vezmo Sync Note:

Our system acts as the Manager, while Vezmo acts as the Cashier. Always verify the Vezmo_payment_id before marking an invoice as "Paid" in the local database.