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."
+---
+
+Digital sales tax applies to purchases of Runpod credits in certain jurisdictions, with varying rates by both country and state or province. B2B transactions may be exempt from digital sales taxes applicable to consumers only. Runpod remits the tax directly to the relevant tax authority.
+
+---
+
+## What determines whether you're taxed
+
+Two things determine your rate: your billing address, and your payment method. If either is registered in a jurisdiction where Runpod collects tax, checkout adds the applicable rate to your purchase.
+
+---
+
+## Tax-registered businesses
+
+If your business is registered for tax in your jurisdiction, adding a valid tax ID may exempt you from tax. It may also change how tax applies. `[CONFIRM: exact effect of a valid tax ID per region — full exemption vs reverse-charge; docs must match what is actually implemented.]`
+
+See [Adding your tax ID](/accounts-billing/add-tax-id) for instructions.
+
+---
+
+## How tax affects your credits
+
+Where tax applies, Runpod always charges it **on top of** your credit purchase. It does not reduce the credits you receive.
+
+- For example, in a jurisdiction with an 18% tax rate, a \$100 credit purchase results in a charge of **\$118**. You still receive **\$100 in credits**.
+- The tax amount appears as a separate line item on your receipt.
+
+Tax does not affect your credit balance. \$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 adds to the reload amount:
+
+- For example, in a jurisdiction with an 18% tax rate, a \$100 auto-reload results in a charge of **\$118**. You still receive **\$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.
+
+---
+
+## 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 collects tax. Runpod adds regions as it begins collecting there.
+
+| Country | Tax type | Rate |
+|---|---|---|
+| India | GST | 18% |

docs.json

@@ -277,7 +277,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"
             ]
           },
           {