> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

<Note>
  Invoicing Integration is currently in **Private Beta**. Contact your Stigg account team to enable it for your environment.
</Note>

Stigg's Invoicing Integration is a built-in billing and contract management module designed for B2B SaaS teams. It handles invoices and contracts directly within Stigg, while Stigg continues to manage entitlements, subscription provisioning, and usage metering.

This module is designed for two types of teams:

| Who                                    | What they get                                                                                                      |
| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **AI startups doing SLG**              | Full contract management and invoicing without a separate billing system — Stigg handles entitlements and invoices |
| **AI startups doing both PLG and SLG** | PLG checkout flows (via Airwallex or Stripe) paired with enterprise contract management for larger deals           |

## What you can do

* Create enterprise contracts with custom pricing, multi-year terms, and negotiated conditions
* Automatically generate and manage invoices per contract billing schedule
* Collect payment via **Airwallex** (cross-border / FX payments) or **bank transfer**
* Let customers view their current invoice and upcoming invoice as a link or PDF
* Map Stigg metered features to contract line items to bill for usage
* Sync usage data from Stigg automatically

## How it works

The module separates two concerns: **billing** and **provisioning**, both driven by a single **Order** — the formal record of what a customer has committed to buy.

```mermaid theme={null}
flowchart TD
    A[Signed Order Form] --> B[Order]
    B --> C[Contract → Billing]
    B --> D[Provisioning]
    C --> E[Invoice generation, payment, dunning]
    D --> F[Entitlements, feature flags, usage metering]
```

**The Order entity** is the source of truth that keeps finance and product provisioning synchronized. A single contract can have multiple orders over its lifetime — initial order, upsell/expansion, and renewal — each recalculating the contract's value without changing how entitlements are modeled in Stigg.

## SLG flow: contract management

This flow applies to teams closing deals through sales. Once an order form is signed (via PDF or Salesforce), the fulfillment process in Stigg is:

1. **Create an Order** in Stigg with status `NEW`
2. **Create a billing contract** in the Stigg app — defines payment terms, billing schedule, and contract line items
3. **Provision subscriptions** to custom plans in Stigg to grant the customer their entitlements
4. **Map metered features** to contract line items (if the contract includes usage-based charges)
5. Once all steps are complete, the Order status updates to **FULFILLED**

Invoices are generated on the contract billing schedule. Invoices are not automatically sent — they are held for review before dispatch, allowing finance teams to verify each invoice before it goes to the customer. Customers can view their invoice as a hosted link or download it as a PDF.

## PLG flow: checkout with invoicing

This flow applies to teams with a self-serve checkout. Customers select a plan, enter payment details, and Stigg provisions their subscription automatically. An invoice is generated and the payment is processed.

```mermaid theme={null}
flowchart TD
    A[Customer selects plan] --> B[Checkout - Stigg widget]
    B --> C[Payment - Airwallex or Stripe]
    C --> D[Invoice generated + Subscription provisioned]
```

**Airwallex** is the recommended PSP for teams with international customers. Its key advantage over Stripe is native cross-border and FX payment support, enabling customers to pay in their local currency without manual conversion.

## Setting up the integration

In the [Stigg app](https://app.stigg.io), go to **Settings > Integrations > Apps**.

### SLG-only setup

1. Select the **Invoicing** category
2. Select **Stigg Invoicing**
3. Configure your **debit entity** — company name, logo, and billing details that appear on invoices
4. Configure **dunning** — automated payment reminders for outstanding invoices

Multiple billing entities are supported. You can add more than one invoicing integration if needed.

### PLG + SLG setup

1. Select the **Invoicing** category
2. Select a third-party payment integration — **Airwallex** or **Stripe**
3. Complete the setup for that provider

Multiple integrations are supported. You can connect both Airwallex and Stripe simultaneously.

## Capability matrix

| Capability                     | SLG only | PLG + SLG            |
| ------------------------------ | -------- | -------------------- |
| Contract management            | ✅        | ✅                    |
| Invoice preview                | ✅        | ✅                    |
| Invoice PDF generation         | ✅        | Via billing provider |
| Invoice payment link           | Optional | Via billing provider |
| Invoice consolidation          | Optional | Optional             |
| Automated dunning              | Optional | Via billing provider |
| Immediate payment collection   | ❌        | ✅                    |
| Financial reporting (ARR, MRR) | Stigg    | Via billing provider |
| Revenue recognition            | Stigg    | Via billing provider |

## Airwallex payment support

Airwallex is a Payment Service Provider (PSP) that Stigg integrates with directly. It is the recommended payment method for teams with cross-border or international revenue because it:

* Supports local payment methods across 150+ countries
* Reduces FX conversion costs compared to USD-only billing
* Authors invoices and collects payment in the customer's preferred currency

Airwallex is available for both the PLG checkout flow and as a payment method on SLG contracts.