Create sales-tax.mdx

accounts-billing/add-tax-id.mdx

@@ -0,0 +1,69 @@
+---
+title: "Adding your tax ID"
+sidebarTitle: "Add your tax ID"
+description: "Add a tax ID to your Runpod account to update how tax is applied to your purchases."
+---
+
+Adding a valid tax ID to your account may exempt you from tax or change how it is applied, depending on your jurisdiction. `[CONFIRM: exact effect per region — full exemption vs reverse-charge for India GSTIN; confirm for other regions.]`
+
+Tax IDs apply to future purchases. `[CONFIRM: does adding a tax ID after a purchase affect that purchase, or only future ones?]`
+
+---
+
+## Add your tax ID at checkout
+
+When completing a purchase, Stripe's checkout flow includes a field to enter your tax ID. `[CONFIRM: is tax_id_collection at checkout live in production? Do not document this path until confirmed.]`
+
+1. At the payment screen, look for the **Tax ID** field below your billing details.
+2. Select your country and enter your tax ID in the correct format for your jurisdiction (see [Supported tax ID formats](#supported-tax-id-formats) below).
+3. Complete your purchase. The tax ID is saved to your account for future purchases.
+
+---
+
+## Add your tax ID in the customer portal
+
+You can add or update your tax ID at any time through the Runpod billing portal without contacting support. `[CONFIRM: is the customer portal tax ID section enabled in production? Do not document this path until confirmed.]`
+
+1. Go to **Settings → Billing** `[CONFIRM: exact console nav path]`.
+2. Click **Manage billing**.
+3. In the customer portal, select **Tax information**.
+4. Enter your tax ID and save.
+
+---
+
+## Tax ID added by support
+
+If you need a tax ID applied to a past purchase or cannot add it through the above paths, contact [support@runpod.io](mailto:support@runpod.io). `[CONFIRM: can support set tax IDs in the Stripe Dashboard on a customer's behalf? Confirm whether this covers past purchases.]`
+
+---
+
+## Supported tax ID formats
+
+Enter your tax ID in the format listed for your jurisdiction. Stripe validates the format immediately at entry — a malformed ID is rejected before your purchase is processed.
+
+| Country | Tax ID type | Format |
+|---|---|---|
+| India | GSTIN | 15-character alphanumeric (e.g. `22AAAAA0000A1Z5`) |
+| European Union | VAT number | Country code + digits (e.g. `DE123456789`) |
+| United Kingdom | VAT number | `GB` + 9 or 12 digits (e.g. `GB123456789`) |
+| Australia | ABN | 11 digits (e.g. `51 824 753 556`) |
+
+`[CONFIRM: confirm the full list of supported ID types for launch. Add rows as additional regions are enabled.]`
+
+---
+
+## Validation and verification
+
+**Validation** confirms that the format of your tax ID is correct. This happens immediately when you enter your ID — a malformed ID is rejected on the spot.
+
+**Verification** is a separate step that applies to EU VAT, UK VAT, and AU ABN numbers. After you save your ID, Stripe checks it asynchronously against the relevant government database. A correctly formatted ID can still come back unverified if the government database returns a failed result.
+
+| Status | What it means | What to do |
+|---|---|---|
+| Verified | Your ID passed the government database check | No action needed |
+| Pending | Verification is in progress | Check back after a few minutes |
+| Unverified | Your ID failed the government database check | Confirm the ID is correct and resubmit, or contact support |
+
+`[CONFIRM: confirm the exact statuses Stripe surfaces and what Runpod shows to the customer for each.]`
+
+India GSTIN does not go through async verification — format validation only.

accounts-billing/sales-tax.mdx

@@ -0,0 +1,58 @@
+---
+title: "Sales tax on Runpod purchases"
+sidebarTitle: "Sales tax"
+description: "Understand how sales tax applies to Runpod purchases, what determines your rate, and how it appears on your receipts."
+---
+
+Runpod is required by law to collect sales tax on purchases in certain jurisdictions. Whether tax applies to your account depends on your location and payment method. Where it applies, tax is charged on top of your purchase and remitted directly to the relevant tax authority by Runpod.
+
+---
+
+## What determines whether you're taxed
+
+Tax is applied based on your payment method country. `[CONFIRM: payment-method country or billing address — confirm trigger with tax implementation owner]` If your payment method or billing address is registered in a jurisdiction where Runpod collects tax, the applicable rate is added to your purchase at checkout.
+
+---
+
+## How tax affects your credits
+
+Tax is always charged **on top of** your credit purchase — it does not reduce the credits you receive.
+
+- A \$100 credit purchase in a jurisdiction with 18% GST results in a charge of **\$118** and delivers **\$100 in credits**.
+- The tax amount appears as a separate line item on your receipt.
+
+Your credit balance is unaffected by tax. \$100 purchased always equals \$100 in credits, regardless of the tax rate that applies to your account.
+
+---
+
+## Auto-reload
+
+If you have auto-reload enabled, tax applies to each reload in the same way it applies to manual purchases. Tax is additive to the reload amount:
+
+- A \$100 auto-reload in an 18% GST jurisdiction charges **\$118** and delivers **\$100 in credits**.
+
+The reload threshold and amount you configure refer to credits, not the total charge. Factor in the applicable tax rate when estimating your billing.
+
+---
+
+## Tax-registered businesses
+
+If your business is registered for tax in your jurisdiction, adding a valid tax ID may exempt you from tax or change how it is applied. `[CONFIRM: does a valid GSTIN fully exempt the charge, or shift to reverse-charge? Docs must match what is actually implemented.]`
+
+See [Adding your tax ID](/accounts-billing/add-tax-id) for instructions.
+
+---
+
+## Receipts and invoices
+
+Tax appears as a separate line on your Runpod receipt. `[CONFIRM: where exactly — receipt email, billing page, or both? Is a compliant tax invoice available for filing, and if so, how does the customer access it?]`
+
+---
+
+## Supported jurisdictions
+
+The table below lists jurisdictions where Runpod currently collects tax. Additional regions will be added as collection begins.
+
+| Country | Tax type | Rate | Notes |
+|---|---|---|---|
+| India | GST | 18% | Applies to purchases made with India-issued payment methods. `[CONFIRM: payment method trigger vs billing address]` |

docs.json

@@ -273,7 +273,9 @@
               "accounts-billing/billing",
               "accounts-billing/cost-centers",
               "accounts-billing/referrals",
-              "accounts-billing/manage-payment-cards"
+              "accounts-billing/manage-payment-cards",
+              "accounts-billing/sales-tax",
+              "accounts-billing/add-tax-id"
             ]
           },
           {