Expand pricing and billing documentation

_billing/billing-overview.md

@@ -3,16 +3,17 @@ languages: ["en", "es"]
 
 en:
   title: Pricing, billing, and plans overview
-  description: Understand where to find plan, usage, attribution, SMS limit, and billing information.
+  description: Understand pricing, usage, channel costs, invoices, payment methods, and plan changes.
 es:
   title: Resumen de precios, facturación y planes
-  description: Entiende dónde encontrar información sobre planes, consumos, atribución, límites de SMS y facturación.
+  description: Entiende precios, consumos, costos de canales, facturas, métodos de pago y cambios de plan.
 
 permalink: pricing-billing-plans-overview
 permalink_es: resumen-precios-facturacion-planes
 
 layout: guide
 topic: billing
+navigation_group: foundations
 popular: false
 ---
 

_billing/billing-settings-and-invoices.md

@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+  title: Billing settings, payment methods, and invoices
+  description: "Find your plan, usage, balance, payment methods, billing details, and monthly invoices."
+es:
+  title: Facturación, métodos de pago y facturas
+  description: "Encuentra tu plan, consumos, saldo, métodos de pago, datos fiscales y facturas mensuales."
+
+permalink: billing-settings-and-invoices
+permalink_es: facturacion-metodos-pago-facturas
+
+layout: guide
+topic: billing
+navigation_group: account_billing
+popular: false
+---
+
+{% translate_file billing/billing-settings-and-invoices.md %}

_billing/billing-troubleshooting.md

@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+  title: Troubleshoot billing questions
+  description: "Reconcile usage, invoices, payment methods, plan changes, taxes, and separate channel charges."
+es:
+  title: Solucionar dudas de facturación
+  description: "Revisa consumos, facturas, métodos de pago, cambios de plan, impuestos y costos separados por canal."
+
+permalink: billing-troubleshooting
+permalink_es: solucionar-dudas-facturacion
+
+layout: guide
+topic: billing
+navigation_group: account_billing
+popular: false
+---
+
+{% translate_file billing/billing-troubleshooting.md %}

_billing/change-or-cancel-your-plan.md

@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+  title: Change or cancel your plan
+  description: "See where to change plans and how effective dates and prorated charges are presented."
+es:
+  title: Cambiar o cancelar tu plan
+  description: "Conoce dónde cambiar de plan y cómo se muestran las fechas efectivas y los cargos prorrateados."
+
+permalink: change-or-cancel-your-plan
+permalink_es: cambiar-o-cancelar-plan
+
+layout: guide
+topic: billing
+navigation_group: account_billing
+popular: false
+---
+
+{% translate_file billing/change-or-cancel-your-plan.md %}

_billing/fair-use-message-policy.md

@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+  title: Fair-use message policy
+  description: "Learn when the variable fee for non-SMS messages becomes the monthly billed amount."
+es:
+  title: Política de fair use para mensajes
+  description: "Conoce cuándo el cargo variable por mensajes que no son SMS se convierte en el monto facturado del mes."
+
+permalink: fair-use-message-policy
+permalink_es: politica-fair-use-mensajes
+
+layout: guide
+topic: billing
+navigation_group: pricing_model
+popular: false
+---
+
+{% translate_file billing/fair-use-message-policy.md %}

_billing/how-pricing-works.md

@@ -13,6 +13,7 @@ permalink_es: explicacion-de-tarifas
 
 layout: guide
 topic: billing
+navigation_group: pricing_model
 popular: true
 ---
 

_billing/performance-fee-calculation.md

@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+  title: Performance fee calculation
+  description: "Understand how your plan rate applies to revenue attributed to Hellotext."
+es:
+  title: Cálculo de la tarifa por rendimiento
+  description: "Entiende cómo se aplica la tarifa de tu plan a los ingresos atribuidos a Hellotext."
+
+permalink: performance-fee-calculation
+permalink_es: calculo-tarifa-rendimiento
+
+layout: guide
+topic: billing
+navigation_group: pricing_model
+popular: false
+---
+
+{% translate_file billing/performance-fee-calculation.md %}

_billing/sms-pricing-and-number-types.md

@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+  title: SMS pricing and sender types
+  description: "Understand SMS rates, plan allowances, and shared or exclusive short codes."
+es:
+  title: Precios de SMS y tipos de remitente
+  description: "Entiende las tarifas de SMS, lo incluido en tu plan y los códigos cortos compartidos o exclusivos."
+
+permalink: sms-pricing-and-number-types
+permalink_es: precios-sms-tipos-remitente
+
+layout: guide
+topic: billing
+navigation_group: channel_costs
+popular: false
+---
+
+{% translate_file billing/sms-pricing-and-number-types.md %}

_billing/understanding-plan-quotas.md

@@ -2,17 +2,18 @@
 languages: ["en", "es"]
 
 en:
-  title: Plan usage and quotas
-  description: "See what is included in your plan and how usage counts toward your bill."
+  title: Plan usage and monthly charges
+  description: "Read the usage summary for a billing period and understand which amount drives the monthly charge."
 es:
-  title: Uso y consumos del plan
-  description: "Conoce qué incluye tu plan y cómo se cuentan tus consumos."
+  title: Uso del plan y cargos mensuales
+  description: "Interpreta el resumen de consumos de un período y entiende qué monto determina el cargo mensual."
 
 permalink: understanding-plan-quotas
 permalink_es: conociendo-los-consumos-del-plan
 
 layout: guide
 topic: billing
+navigation_group: account_billing
 popular: false
 ---
 

_billing/whatsapp-fees.md

@@ -0,0 +1,20 @@
+---
+languages: ["en", "es"]
+
+en:
+  title: Meta fees for WhatsApp
+  description: "Understand which WhatsApp charges come from Meta and how they differ from Hellotext charges."
+es:
+  title: Tarifas de Meta para WhatsApp
+  description: "Entiende qué costos de WhatsApp corresponden a Meta y cómo se diferencian de los cargos de Hellotext."
+
+permalink: whatsapp-fees
+permalink_es: tarifas-meta-whatsapp
+
+layout: guide
+topic: billing
+navigation_group: channel_costs
+popular: false
+---
+
+{% translate_file billing/whatsapp-fees.md %}

_config.yml

@@ -139,7 +139,14 @@ collections:
     order:
       - billing-overview.md
       - how-pricing-works.md
+      - performance-fee-calculation.md
+      - fair-use-message-policy.md
+      - whatsapp-fees.md
+      - sms-pricing-and-number-types.md
       - understanding-plan-quotas.md
+      - billing-settings-and-invoices.md
+      - change-or-cancel-your-plan.md
+      - billing-troubleshooting.md
   captures:
     output: true
     order:

_data/guide_groups.yml

@@ -51,3 +51,17 @@ analytics-reporting-attribution:
   - key: measurement_attribution
     en: Measurement & attribution
     es: Medición y atribución
+
+billing:
+  - key: foundations
+    en: Start here
+    es: Primeros pasos
+  - key: pricing_model
+    en: Pricing model
+    es: Modelo de cobro
+  - key: channel_costs
+    en: Messaging costs
+    es: Costos de mensajería
+  - key: account_billing
+    en: Billing & account
+    es: Facturación y cuenta

_i18n/en/billing/billing-overview.md

@@ -1,46 +1,42 @@
-Use this section to understand how Hellotext plans, usage, attributed revenue, and billing rules work together.
-
-Most billing questions start with one of three questions:
-
-- What does my plan include?
-- Which usage counts toward my monthly bill?
-- Why was revenue attributed to Hellotext?
+Use this section to understand what Hellotext charges, why a particular amount appears, and where to manage billing for your business.
 
 ## Start with the pricing model
 
-Hellotext uses a results-based pricing model. Depending on your plan and usage, your monthly Hellotext charge is based on the highest applicable billing item for the period.
-
-Keep reading: [Pricing model]({% link _billing/how-pricing-works.md %}).
+Hellotext compares the plan minimum, performance fee, SMS costs, and the variable non-SMS messaging amount. Only the highest of those four becomes the Hellotext amount for the period.
 
-For current plan pricing and SMS rate tables, always check the public [Hellotext pricing page](https://www.hellotext.com/pricing).
+Read [Pricing model]({% link _billing/how-pricing-works.md %}) before trying to add individual usage amounts together.
 
-## Review plan usage and quotas
+Current plan prices, included features, rates, and country-specific SMS allowances live on the public [Hellotext pricing page](https://www.hellotext.com/pricing).
 
-Your plan determines what is included, which usage is tracked, and how monthly activity is calculated.
+## Understand attributed revenue
 
-Use the plan usage guide when you need to understand plan minimums, performance fees, SMS costs, variable messaging fees, and how they appear on invoices.
+The performance fee uses revenue attributed to Hellotext, not all store revenue.
 
-Keep reading: [Plan usage and quotas]({% link _billing/understanding-plan-quotas.md %}).
+- [Performance fee calculation]({% link _billing/performance-fee-calculation.md %}) explains the billing calculation.
+- [How we attribute sales]({% link _analytics-reporting-attribution/sales-attribution.md %}) explains which orders and evidence are eligible.
 
-## Understand attribution
+## Understand messaging costs
 
-Attributed revenue matters because it can affect results-based billing and reporting.
+Messaging has three distinct concepts:
 
-Use the attribution guide when you need to understand source precedence, eligible evidence, attribution windows, team participation, supported order changes, and why a sale was or was not attributed to Hellotext.
+- [Fair-use message policy]({% link _billing/fair-use-message-policy.md %}) explains when eligible non-SMS message volume becomes the Hellotext amount.
+- [SMS pricing and sender types]({% link _billing/sms-pricing-and-number-types.md %}) explains country rates, plan allowances, and sender options.
+- [Meta fees for WhatsApp]({% link _billing/whatsapp-fees.md %}) explains the separate costs defined by Meta.
 
-Keep reading: [Sales attribution]({% link _analytics-reporting-attribution/sales-attribution.md %}).
+## Review usage and invoices
 
-## SMS limits for new businesses
+Open **Settings → Billing** to see your current plan, period usage, balance, payment history, payment methods, billing information, and available invoices.
 
-Some new prepaid businesses begin with a temporary SMS sending limit while Hellotext reviews sending quality.
+- [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %}) helps you interpret a selected period.
+- [Billing settings, payment methods, and invoices]({% link _billing/billing-settings-and-invoices.md %}) explains each billing control.
 
-Use the SMS limits guide when SMS messages are blocked by a temporary daily limit, or when you need to understand how the review period works.
+## Change the plan or solve a problem
 
-Keep reading: [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %}).
+- [Change or cancel your plan]({% link _billing/change-or-cancel-your-plan.md %}) explains upgrades, scheduled downgrades, and cancellations.
+- [Troubleshoot billing questions]({% link _billing/billing-troubleshooting.md %}) provides a reconciliation checklist and the details to send support.
 
 ## Related guides
 
+- [Revenue report guide]({% link _analytics-reporting-attribution/revenue-report-guide.md %})
 - [Messaging channels overview]({% link _numbers/messaging-overview.md %})
-- [Campaign reporting]({% link _analytics-reporting-attribution/campaign-reporting.md %})
-- [Audience and segmentation overview]({% link _audience/audience-overview.md %})
-- [Setup and integrations overview]({% link _integrations/setup-overview.md %})
+- [SMS sending limits for new businesses]({% link _troubleshooting-deliverability/sms-sending-limits-for-new-businesses.md %})

_i18n/en/billing/billing-settings-and-invoices.md

@@ -0,0 +1,54 @@
+Open **Settings → Billing** to manage the billing information for your business. The page brings together your plan, usage, balance, payment history, payment methods, billing details, and available invoices.
+
+## Current plan and usage
+
+The first cards show the active plan and the usage summary. Use **Change plan** to review other plans, and select a period in the usage summary to inspect billable activity.
+
+See [Plan usage and monthly charges]({% link _billing/understanding-plan-quotas.md %}) for help interpreting the comparison.
+
+## Balance and payment history
+
+The balance area shows funds available to the business when balance billing applies. Open **Payment history** and select a year or period to review recorded movements.
+
+The payment history is not a replacement for the invoice. Use it to trace balance movements, then use the invoice for the finalized billing document.
+
+## Payment methods
+
+The **Payment methods** section shows the methods available for the business. Depending on the business source and region, this can include a saved card, Shopify billing, or another supported arrangement.
+
+When the interface allows it, use **New payment method** to add a card. Keep at least one valid method available before enabling paid usage or changing to a paid plan.
+
+The public pricing page lists major credit cards and bank transfers depending on the region. The Billing page for your business is the source of truth for the methods currently available to that account.
+
+## Billing information and country
+
+Use **Billing information** to add the legal or tax details that should accompany billing records.
+
+The business country affects tax treatment and can affect currency and available payment methods. Use **Change country** carefully and confirm the tax notice shown by Hellotext before saving.
+
+## View an invoice
+
+1. Open **Settings → Billing**.
+2. Find **Invoices**.
+3. Select the year and month you want to review.
+4. Open the available invoice.
+
+Invoices appear after they are available for the billing period. If a month is not listed yet, confirm that the period has been finalized.
+
+## Before contacting support
+
+Have these details ready:
+
+- business or workspace identifier;
+- invoice month and currency;
+- the line or amount you are asking about;
+- the corresponding usage-summary period; and
+- any payment error shown in the interface.
+
+Do not send full card numbers, security codes, or banking credentials.
+
+## Related guides
+
+- [Pricing model]({% link _billing/how-pricing-works.md %})
+- [Change or cancel your plan]({% link _billing/change-or-cancel-your-plan.md %})
+- [Troubleshoot billing questions]({% link _billing/billing-troubleshooting.md %})