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

# Payments and Billing Guide

> Learn how to manage your subscription, payment methods, and billing in Equa

# Payments and Billing

> **Status:** DRAFT
> **Last Updated:** 2026-02-22
> **Audience:** End users (company administrators, billing contacts)

***

## What This Feature Does

Payments and billing let you manage your organization’s Equa subscription: view the current plan, upgrade or change plans, add or edit payment methods (e.g., card or ACH), and see billing history. You can keep payment details up to date and avoid service interruptions.

***

## Why It Matters

Subscription and payment issues can lock you out of the product or cause failed renewals. Having a clear place to see your plan, update payment methods, and complete checkout when upgrading keeps your team on the right plan and ensures continuity.

***

## Prerequisites

Before you begin, make sure you have:

* [ ] An active Equa account with access to the organization
* [ ] A role that allows managing billing (e.g., organization admin or billing contact)
* [ ] A valid payment method (card or bank account) if you are upgrading or adding one

***

## Step-by-Step Walkthrough

### Step 1: Open Billing

1. Select your **organization** in the sidebar.
2. Go to **Settings** (organization settings).
3. Click **Billing**. You’ll see your current plan, next billing date, and options to manage payment.

### Step 2: Change or Upgrade Your Plan

1. On the Billing page, click **Upgrade** (or **Change plan** / **Select plan**).
2. You’re taken to the plan selection page with available tiers and features.
3. Choose the plan you want and click **Continue** (or **Select**).
4. On the checkout page, confirm the plan and price, then enter or confirm payment details and complete the purchase.

{/* screenshot: payments-checkout-form.png - Checkout page with plan summary and payment form */}

### Step 3: Add or Edit a Payment Profile

1. From **Organization > Settings > Billing**, open **Payment profiles** (or **Payment method** / **Manage payment**).
2. To add: click **Add payment profile** (or **New**) and enter card or bank details as prompted.
3. To edit: click the existing profile and choose **Edit**, then update the details and save.
4. You can set a default profile for subscriptions and one-time charges.

***

## Common Tasks

### How to Update a Card or Bank Account

1. Go to **Organization > Settings > Billing**.
2. Under payment profiles, open the profile you want to change and click **Edit**.
3. Enter the new card number, expiry, and security code (or new bank account details).
4. Save. The updated method is used for future charges.

### How to View Billing History

1. On the Billing page, look for **Invoices**, **Billing history**, or **Past payments**.
2. Open the list to see past charges, dates, and amounts; download or print invoices if the option is available.

### How to Downgrade or Cancel

1. In **Organization > Settings > Billing**, look for **Change plan** or **Cancel subscription**.
2. Follow the flow to switch to a lower tier or cancel. Confirm any proration or end date shown before submitting.

***

## Tips and Best Practices

* **Use a dedicated billing contact:** Assign one person (or a shared role) to keep the plan and payment method up to date so renewal emails don’t get lost.
* **Update before expiry:** If your card is expiring soon, update the payment profile a few weeks ahead so the next charge succeeds.
* **Keep an eye on upgrade prompts:** If you’re on a limited plan and need more seats or features, use **Upgrade** from Billing to see current options and pricing.

<Tip>
  Complete the checkout flow in one go when upgrading: plan selection → checkout → payment. If you leave mid-flow, you may need to start again from Billing.
</Tip>

***

## Design References

Design-system source for this guide: [Payments screenshot gallery](/architecture/design-system/screenshots/payments) and [EquaCard](/architecture/design-system/components/equa-card), [EquaButton](/architecture/design-system/components/equa-button), [EquaBadge](/architecture/design-system/components/equa-badge), [EquaModal](/architecture/design-system/components/equa-modal).

## Troubleshooting / FAQ

<AccordionGroup>
  <Accordion title="Why can't I see Billing?">
    Only users with organization admin or billing permissions can open **Settings > Billing**. If you don’t see it, ask an org admin to grant you the appropriate role.
  </Accordion>

  <Accordion title="My payment failed or card was declined">
    Check that the card (or bank account) is valid, has sufficient funds, and isn’t expired. Update the payment profile in **Billing** with correct details and retry. If the problem continues, contact Equa support with your org name and the approximate charge date.
  </Accordion>

  <Accordion title="How do I get an invoice or receipt?">
    Use **Billing history** or **Invoices** on the Billing page to find the charge you need. If there’s a **Download** or **View** option, use it for a PDF or receipt. Otherwise, the transaction list can serve as a record; contact support if you need a formal invoice.
  </Accordion>
</AccordionGroup>

***

## Related

* [Spec: Payments](/specs/010-payments/spec) · [Spec: Billing and subscriptions](/specs/011-billing-and-subscriptions/spec)
* [Finance and Transactions](/guides/finance-and-transactions) — Finance dashboard and transaction history
* [Organization Setup](/guides/organization-setup) — Organization details and settings
* [Profile and Settings](/guides/profile-and-settings) — Account and wallet
* [Guides index](/guides/index)