Invoices

Invoices represent billing documents that capture itemized charges, payments, and transaction details for customer purchases and subscriptions.

Key Benefits

Automated Billing - Generate invoices automatically for subscriptions and one-time purchases

Payment Processing - Seamless integration with multiple payment providers and methods

Compliance Ready - Built-in ZATCA integration for tax compliance and regulatory requirements

Invoice Properties

Serial Numbers - Auto-generated unique identifiers (e.g., "INV-202500014") assigned after payment
Payment Status - Track paid, unpaid, and processing states
Transaction Links - Direct connection to payment transactions and methods
Tax Integration - Automatic tax calculations and ZATCA compliance

Invoice Management

Invoice Details

View comprehensive invoice information including customer details, payment status, and itemized charges.

Refund Processing

Process partial or full refunds directly from the invoice interface.

Refund Options:

Select specific items to refund

Specify partial or full refund amounts

Automatic refund transaction creation

Real-time refund status updates

Invoice Types

1. Order Normal Invoices

Created during checkout process for immediate payment of orders and one-time purchases.

2. Subscription Normal Invoices

Generated automatically for recurring billing cycles, linked to active subscriptions. These invoices are identified with is_auto_renewal=true

3. Refund Invoices

Created when processing refunds, maintaining complete transaction audit trails. These invoices are identified with type="refund"

Customer Usage

Common Use Cases: Display invoice history in customer accounts, provide downloadable receipts, show payment status and due dates, enable invoice-based payments.

List Customer Invoices

Retrieve all invoices for authenticated customers with payment status and details.

Get Invoice Details

Access specific invoice information including items, amounts, and payment URLs for unpaid invoices.

Invoice

Merchant Integration

For detailed merchant invoice operations and refund management, see Invoices

Key Benefits#

Invoice Properties#

Invoice Management#

Invoice Details#

Refund Processing#

Invoice Types#

1. Order Normal Invoices#

2. Subscription Normal Invoices#

3. Refund Invoices#

Customer Usage#

List Customer Invoices#

Get Invoice Details#

Merchant Integration#