Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stablepayfi.ai/llms.txt

Use this file to discover all available pages before exploring further.

Invoicing is StablePay’s product for merchant-created, one-time invoices addressed to specific customers. It is built for B2B billing, services, wholesale orders, account-managed sales, and manual billing workflows where the merchant needs an official payable document and a clear payment record. Merchants create and manage invoices in the Merchant Portal, then deliver them by email, PDF, or hosted invoice page. The payer can review invoice details and pay through StablePay’s hosted payment experience when the invoice is open or past due.

Product demo

When to use it

Use Invoicing when the payment should be tied to a named customer and a specific bill. Common fit examples include:
  • B2B or wholesale orders where the buyer expects an invoice.
  • Professional services, retainers, and account-managed sales.
  • Manual billing flows where a finance or sales team creates the payment request.
  • Customer-specific amounts, due dates, notes, and line items.
  • Workflows that need invoice status tracking, reminders, PDFs, and recordkeeping.
If you need a public, reusable payment page that is not pre-bound to a customer, use Payment Links. If you need recurring billing, use Stablecoin Subscriptions.

How it works

  1. A merchant creates an invoice in the Merchant Portal.
  2. The invoice includes customer details, line items, amount, due date, and optional notes.
  3. The merchant sends or shares the invoice by email, PDF, or hosted invoice page.
  4. The payer opens the hosted invoice page, reviews invoice details, and pays through StablePay Checkout.
  5. StablePay updates invoice and payment records as the invoice moves through its lifecycle.

Merchant capabilities

CapabilityDescription
Create and manage invoicesBuild one-time invoices in the Merchant Portal for named customers.
Email deliverySend the invoice directly to the customer’s email address.
PDF downloadDownload or share an invoice PDF for procurement, finance, or offline workflows.
Hosted invoice pageGive the payer a hosted page to review the invoice and start payment.
RemindersManage follow-up for unpaid invoices.
Duplicate invoiceReuse an existing invoice as a starting point for repeat manual billing.
Payment recordsTrack how invoice payment activity maps to StablePay payment records.

Invoice lifecycle

StatusMerchant meaning
draftThe invoice is being prepared and is not yet payable.
openThe invoice is payable and can be sent or shared with the customer.
past_dueThe invoice is still open, but its due date has passed and an unpaid amount remains.
paidThe invoice has been fully paid.
voidThe invoice was canceled and is no longer payable.
past_due is a derived display state. It helps merchants understand overdue invoices without changing the underlying idea that the invoice remains open and unpaid.

Hosted invoice page

The hosted invoice page is the payer-facing payment entry point for Invoicing. It lets the payer review merchant details, customer details, line items, amount due, due date, and payment state before starting payment.
Invoice stateHosted page behavior
openThe payer can review details and pay.
past_dueThe payer can still review details and pay, with overdue context visible.
paidThe page remains viewable for recordkeeping and receipt-style confirmation.
voidThe page remains viewable for recordkeeping, but cannot be paid.
PDF invoice and receipt behavior can depend on invoice state. Open, past due, paid, and void invoices can remain useful as records, while payment receipt behavior is most relevant after successful payment.

Manual invoices and subscription invoices

Manual invoices are created by merchants for one-time customer billing workflows. They belong to the Invoicing product experience. Subscription-generated invoices are created by the subscription billing lifecycle. They may appear as billing records and can be useful for reporting, but they may be read-only in Portal invoice workflows because the subscription system controls their lifecycle.
InvoicingPayment Links
For a named customer and a specific billPublic and reusable
Includes invoice details, due date, and customer contextCustomer details can be collected during checkout
Delivered by email, PDF, or hosted invoice pageShared as a hosted payment page or QR-friendly link
Best for B2B, finance, and account-managed workflowsBest for campaigns, social selling, and one-to-many distribution

Important notes

  • Invoicing is for named customers and one-time invoice workflows, not reusable public payment pages.
  • Refunds are based on payments. Refunding a payment does not automatically rewrite the invoice state machine.
  • Subscription-linked invoices may exist as billing records but are not the same as manually created invoices.
  • Use the hosted invoice page as the payer-facing entry point when the customer needs to review the bill before paying.
Last modified on April 29, 2026