Invoices API

Create, send, and manage professional invoices with automated payment tracking and webhook notifications.

Invoice Workflow

Create Invoice

Send to Customer

Track Payment

Automatic Payment Links

When you create an invoice, VeriPay automatically generates payment links and handles the verification process.

Create Invoice

Create a new invoice with line items, customer details, and payment terms.

POST /api/v1/invoices

'Response', 'content' => '{ \"id\": 456, \"invoice_number\": \"INV-2024-001\", \"status\": \"draft\", \"customer_id\": 123, \"due_date\": \"2024-09-15\", \"currency\": \"TTD\", \"subtotal_cents\": 505000, \"tax_cents\": 63125, \"total_cents\": 568125, \"payment_link\": \"https://veripay.us/invoice/INV-2024-001\", \"created_at\": \"2024-08-14T10:30:00Z\" }' ] ]" default="Request" />

List & Retrieve Invoices

List All Invoices

GET /api/v1/invoices

GET /api/v1/invoices?status=pending&page=1&per_page=25
Authorization: Bearer sk_test_...

Get Specific Invoice

GET /api/v1/invoices/{id}

GET /api/v1/invoices/456
Authorization: Bearer sk_test_...

Mark Invoice as Paid

Manually mark an invoice as paid or update its status.

PATCH /api/v1/invoices/{id}

Automatic Status Updates

When customers pay through VeriPay payment links, invoice status is automatically updated to "paid" when payment is verified.

Invoice Status Values

draft Invoice created but not yet sent

sent Invoice sent to customer, awaiting payment

viewed Customer has viewed the invoice

paid Payment received and verified

overdue Payment past due date

cancelled Invoice cancelled

Webhook Events

Receive notifications for invoice-related events:

invoice.created New invoice created

invoice.sent Invoice sent to customer

invoice.viewed Customer viewed invoice

invoice.paid Payment received and verified

invoice.overdue Invoice became overdue

Learn more about webhook implementation in our Webhooks guide.

Related Resources

Customers API Payments API Webhooks