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

# Billing & payouts

> Configure payment gateways, invoices, company details, and taxes for your tenants.

Set up how your tenants pay for your plans and how their invoices are created. Configure payment gateways, add your company details, customize invoices, and manage taxes from this section.

## Payment Gateway Settings

Payment Gateway Settings lets you choose how your tenants can pay for their plans.

<Frame caption="Payment Gateway Settings page showing the available payment methods">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/payment-gateways.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=175cb2bb70061cb13610686dea361508" alt="Payment Gateway Settings page showing the available payment methods" width="1684" height="419" data-path="images/pa/payment-gateways.png" />
</Frame>

| Payment method      | Type    | Description                                                                      |
| ------------------- | ------- | -------------------------------------------------------------------------------- |
| **Bank Transfer**   | Manual  | Tenants pay directly to your bank account and submit payment proof for approval. |
| **Razorpay**        | Instant | Accept online payments through Razorpay.                                         |
| **PayPal**          | Instant | Accept online payments through PayPal.                                           |
| **Tap Payments**    | Instant | Accept online payments through Tap Payments.                                     |
| **Paymob**          | Instant | Accept online payments through Paymob.                                           |
| **Shopify Billing** | —       | Add subscription charges to the tenant's Shopify invoice.                        |

### Configure a payment gateway

<Steps>
  <Step title="Open Payment Gateway Settings">
    Select the payment gateway you want to use.
  </Step>

  <Step title="Enter the credentials">
    Add the required credentials and configuration details.
  </Step>

  <Step title="Enable and save">
    Enable the payment gateway and save the changes.
  </Step>

  <Step title="Test the connection">
    Use **Test Connection**, when available, to check the configuration.
  </Step>
</Steps>

<AccordionGroup>
  <Accordion title="Bank Transfer details" icon="landmark">
    Add your payment details such as **bank name, account holder name, account number, IFSC, and UPI ID**. Tenants can use these details to make a payment and submit their payment proof for approval.
  </Accordion>

  <Accordion title="Shopify Billing setup" icon="shopping-bag">
    Connect your Shopify app under **Settings → Integrations → Shopify**. No payment gateway credentials are required in this section.

    <Note>
      Shopify Billing only becomes available to a tenant once they have connected their own Shopify store. Until then, it does not appear as a payment option at checkout.
    </Note>
  </Accordion>
</AccordionGroup>

## Company Information

Company Information contains the business details used on tenant invoices.

<Frame caption="The Company Information settings page, with the business identity fields used on invoices">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/company-information.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=37a6acde39ee82681405d1c1dbc000e6" alt="The Company Information settings page, with the business identity fields used on invoices" width="1633" height="518" data-path="images/pa/company-information.png" />
</Frame>

* **Company Name**
* **Company Email**
* **WhatsApp Number**
* **GST Number**
* **Country**
* **State / Province**
* **ZIP / Postal Code**
* **Company Address**

These details are added to invoices generated by the platform.

## Invoice Settings

Invoice Settings controls the default information used when generating invoices.

<Frame caption="The Invoice Details settings page, with the invoice prefix, next invoice number, footer notes, and the tax toggle">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/invoice-settings.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=40901329de742846bf20105edcd8a052" alt="The Invoice Details settings page, with the invoice prefix, next invoice number, footer notes, and the tax toggle" width="1632" height="540" data-path="images/pa/invoice-settings.png" />
</Frame>

### Invoice Prefix

Set the prefix that should be added to every invoice number.

For example, if the prefix is set to `INV-`, the invoice number will start with `0001`, giving `INV-0001`.

<Note>
  Changing the prefix affects **future invoices only**.
</Note>

### Footer Notes

Add notes that should appear at the bottom of every invoice. You can use this for:

* Bank details
* Payment instructions
* Thank-you messages
* Legal information
* Other billing notes

### Tax on Invoices

Enable **Tax on Invoices** when you want tax to be added to tenant invoices. When this option is enabled, the tax configured under [**Taxes**](#taxes) can be applied to invoices.

<Info>
  A tax is applied only when **Tax on Invoices** is enabled **and** the tax is active.
</Info>

## Taxes

Use the **Taxes** section to add the tax rates that can be applied to tenant invoices.

### Add a tax

<Frame caption="The Add Tax panel, with the name, rate, type, currency, and description fields">
  <img src="https://mintcdn.com/reseller-docs/N3dwUQXnwHM07XTT/images/pa/add-tax.png?fit=max&auto=format&n=N3dwUQXnwHM07XTT&q=85&s=f05f4b2fa3269471c31932f1723de4c3" alt="The Add Tax panel, with the name, rate, type, currency, and description fields" width="554" height="381" data-path="images/pa/add-tax.png" />
</Frame>

| Field           | Description                      |
| --------------- | -------------------------------- |
| **Name**        | Name of the tax.                 |
| **Rate**        | Tax percentage.                  |
| **Type**        | Select the tax type.             |
| **Currency**    | Select the currency for the tax. |
| **Description** | Add an optional description.     |

After adding the tax, make sure [**Tax on Invoices**](#tax-on-invoices) is enabled in [**Invoice Settings**](#invoice-settings) if you want the tax to be included in invoices.

<Note>
  Tax is calculated when an invoice is created. The tax amount on that invoice does not change later.

  If the tax rate is changed, the new rate applies only to future invoices. Existing invoices keep the original tax rate.
</Note>

## How payments are settled

<Info>
  The platform does not hold your tenants' payments.
</Info>

<Tabs>
  <Tab title="Online gateways">
    For **Razorpay, PayPal, Tap Payments, and Paymob**, you use your own gateway account and credentials. Tenant payments are processed through your gateway account.

    The payment is added to the billing history and linked to the related invoice.
  </Tab>

  <Tab title="Shopify Billing">
    Subscription charges are handled through Shopify, and Shopify manages the related payouts.
  </Tab>

  <Tab title="Bank Transfer">
    Tenants pay you directly using the bank details you provide. You review their payment proof and approve or reject the payment from the platform.
  </Tab>
</Tabs>

## Review billing records

Once tenants start buying plans, their billing activity appears under **Sales**. Each area has its own page.

<CardGroup cols={2}>
  <Card title="Subscriptions" icon="repeat" href="/pa/subscriptions">
    Each tenant's current plan and subscription status.
  </Card>

  <Card title="Invoices & payments" icon="receipt" href="/pa/invoices-and-payments">
    Invoices issued to tenants and their payment history, including failed payments.
  </Card>

  <Card title="Offline payments" icon="banknote" href="/pa/offline-payments">
    Payment requests from tenants who paid by bank transfer. Approve or reject each request.
  </Card>

  <Card title="Coupons" icon="ticket-percent" href="/pa/coupons">
    Discount codes tenants can use when paying for a plan.
  </Card>
</CardGroup>
