docs(billing): add Linkrunner Wallet and how to pay an invoice

billing/overview.mdx

@@ -77,14 +77,48 @@ This means you can scale up during a big launch and scale back down the next mon
 
 ## Invoices & Payments
 
-You can view and pay invoices from your [dashboard billing page](https://dashboard.linkrunner.io/dashboard/billing).
+View and pay invoices from your [dashboard billing page](https://dashboard.linkrunner.io/dashboard/billing). Click **Pay Now** on a pending invoice to see every option available to you.
 
 **Supported payment methods:**
+
+- Bank transfer (INR invoices)
+- [Linkrunner Wallet](/billing/wallet)
 - Razorpay (cards, UPI, netbanking)
+- Cashfree (cards, UPI, netbanking, for INR invoices)
 - Stripe (cards, for USD invoices)
 - PayPal
 
-Each invoice includes a payment link. You'll receive an email notification when a new invoice is ready.
+You'll receive an email notification when a new invoice is ready.
+
+### Pay by bank transfer
+
+Available for **INR invoices**. The **Pay Now** dialog shows the account name, account number, IFSC, and the exact amount due.
+
+<img src="/images/billing/pay-invoice-bank-transfer.webp" alt="The Pay Now dialog, showing the amount due, the account to transfer to, and the field for your transfer reference" />
+
+<Steps>
+  <Step title="Transfer the amount due">
+    Transfer the **full amount shown** from your bank. An invoice is settled in full or not at all, so a partial transfer cannot clear it.
+  </Step>
+  <Step title="Submit your reference">
+    Paste the UTR (transaction reference) from your bank into **Transfer reference (UTR)** and click **Submit reference**. Do this straight after transferring. You do not need to wait for the money to arrive.
+  </Step>
+  <Step title="We match it and mark the invoice paid">
+    We check the reference against our bank statement and mark the invoice paid. It stays **Pending** until then, and you get a confirmation email with a receipt once it clears.
+  </Step>
+</Steps>
+
+<Note>
+Each reference can be used only once, and one transfer clears one invoice. If you mistype it, submit the correct one after the first is rejected.
+</Note>
+
+### Pay by card, UPI, or netbanking
+
+Click the payment link in the **Pay Now** dialog. It opens a hosted payment page, and the invoice is marked paid as soon as the payment succeeds. There is no approval step.
+
+### Pay from your wallet
+
+If your account has the wallet enabled, a pending invoice is settled from your balance automatically. See [Linkrunner Wallet](/billing/wallet).
 
 ## What happens when an invoice is overdue?
 

billing/wallet.mdx

@@ -0,0 +1,100 @@
+---
+title: "Linkrunner Wallet"
+description: "Prepay a balance and let your invoices settle themselves"
+icon: "wallet"
+sidebarTitle: "Linkrunner Wallet"
+---
+
+The wallet holds a balance on your account. When an invoice is due, it is settled from that balance instead of you paying it by hand each month.
+
+Billing stays postpaid either way. The wallet changes how an invoice gets paid, not what you are charged.
+
+<Note>
+The wallet is being rolled out account by account and is not enabled everywhere yet. If you do not see **Wallet** on your billing page, contact [support@linkrunner.io](mailto:support@linkrunner.io). You can still pay invoices normally in the meantime. See [Billing Overview](/billing/overview).
+</Note>
+
+## 1. Add funds
+
+Open **Wallet** on your [billing page](https://dashboard.linkrunner.io/dashboard/billing) and click **Add funds**.
+
+<Steps>
+  <Step title="Choose an amount">
+    We suggest 3, 6, or 12 months of your average bill, based on your last three paid invoices. You can enter your own amount instead.
+
+    If your recharge earns bonus free installs, the number is shown before you confirm.
+  </Step>
+  <Step title="Choose how to pay">
+    **Bank transfer** (INR): transfer the amount, then submit the UTR. We match it against our bank statement and credit your wallet.
+
+    **Card, UPI, or netbanking**: pay through the hosted gateway page. The balance is credited as soon as the payment succeeds.
+  </Step>
+  <Step title="Outstanding invoices settle">
+    Once the funds land, any pending invoice is paid from the balance automatically. You do not need to do anything else.
+  </Step>
+</Steps>
+
+<img src="/images/billing/wallet-add-funds.webp" alt="The Add funds dialog, with the payment method chosen, the amount, and the account to transfer to" />
+
+<Tip>
+Recharging by bank transfer avoids the gateway entirely, which is the simplest route for large amounts.
+</Tip>
+
+## 2. How invoices settle
+
+Two things happen automatically.
+
+**After you add funds.** Any invoice already pending is settled from your balance. An invoice is settled **in full or not at all**, so if your balance is short, the invoice stays pending and the wallet screen shows the top-up needed to clear it.
+
+**When your next invoice is generated.** Your balance is applied as the invoice is created, and the invoice shows the arithmetic:
+
+```
+Total amount - Wallet deducted = Net payable
+```
+
+If the balance covers the whole bill, the net payable is zero and there is nothing to pay. If it covers part of it, you pay the remainder using any [supported payment method](/billing/overview).
+
+## 3. Available vs locked balance
+
+Your balance is split into two numbers on the wallet screen:
+
+| Balance | What it is |
+|---------|------------|
+| **Locked** | Held against your estimated bill for the current month |
+| **Available** | Everything above that, which you can withdraw |
+
+The locked portion is what your next invoice will be settled against, so it cannot be withdrawn. The estimate updates through the month as your installs accumulate.
+
+## 4. Withdraw funds
+
+Click **Withdraw** on the wallet screen and enter an amount up to your available balance.
+
+- The amount is deducted from your balance when you raise the request, so it cannot be spent twice.
+- A processing fee is deducted from the payout. The fee and the net amount are shown before you confirm.
+- You enter the account name, account number, and IFSC to be paid out to as part of the request.
+- If a withdrawal is rejected or the payout fails, the full amount is returned to your balance.
+
+<Warning>
+Bonus free installs reward money kept in the wallet. Withdrawing gives up the whole unused bonus, so withdraw only what you are sure you do not need.
+</Warning>
+
+## Troubleshooting
+
+<AccordionGroup>
+  <Accordion title="I added funds but my invoice is still pending">
+    Settlement is all-or-nothing. If your balance is less than the invoice, the invoice waits. The wallet screen shows exactly how much more you need.
+  </Accordion>
+  <Accordion title="My bank transfer has not been credited">
+    Transfers are credited once we match your UTR against our bank statement. If it is still uncredited a full working day after you submitted the reference, contact [support@linkrunner.io](mailto:support@linkrunner.io) with the UTR.
+  </Accordion>
+  <Accordion title="Why can't I withdraw my whole balance?">
+    The portion locked against your estimated bill for the current month is not withdrawable. Only the available balance can be withdrawn.
+  </Accordion>
+  <Accordion title="Can I use the wallet for a USD account?">
+    Yes, but adding funds by bank transfer is available for INR only. USD accounts recharge through the payment gateway.
+  </Accordion>
+  <Accordion title="Does the wallet change my rate?">
+    No. You are billed for attributed installs at your normal tier rate. The wallet only changes how the invoice is paid.
+  </Accordion>
+</AccordionGroup>
+
+**Need help?** Contact [support@linkrunner.io](mailto:support@linkrunner.io)

docs.json

@@ -106,7 +106,7 @@
                     },
                     {
                         "group": "Billing",
-                        "pages": ["billing/overview"]
+                        "pages": ["billing/overview", "billing/wallet"]
                     },
                     {
                         "group": "Troubleshooting",