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

# Billing and plans

> Set the currency, tax rate and standing fees this hospital bills in, and see exactly what changes on invoices once you save.

export const StillStuck = ({topic}) => <div className="ck-callout ck-callout--note" role="note">
    <p className="ck-callout__body">
      <strong>Still stuck{topic ? ` with ${topic}` : ''}?</strong>{' '}
      Check <a href="/platform/help/troubleshooting">Troubleshooting</a> first —
      it covers the failures we see most often. If that does not resolve it,{' '}
      <a href="/platform/help/contact-support">contact support</a> and include
      your workspace name and the time the problem happened, so we can find the
      matching entry in your audit log.
    </p>
  </div>;

export const TaskHeader = ({before, time, after}) => <div className="ck-task">
    {before ? <div className="ck-task__cell">
        <div className="ck-task__title">Before you start</div>
        <p className="ck-task__body">{before}</p>
      </div> : null}

    {time ? <div className="ck-task__cell">
        <div className="ck-task__title">Takes about</div>
        <p className="ck-task__body">{time}</p>
      </div> : null}

    {after ? <div className="ck-task__cell">
        <div className="ck-task__title">When you're done</div>
        <p className="ck-task__body">{after}</p>
      </div> : null}
  </div>;

export const Path = ({steps = []}) => <span className="ck-path">
    {steps.map((s, i) => <span key={i} className="ck-path__step">
        {i > 0 ? <span className="ck-path__sep" aria-hidden="true">
            ›
          </span> : null}
        {s}
      </span>)}
  </span>;

export const Availability = ({editions = ['all'], plans, roles, note}) => {
  const list = editions.includes('all') ? ['clinic', 'pharmacy', 'lims'] : editions;
  return <div className="ck-avail" role="note" aria-label="Feature availability">
      <span className="ck-avail__label">Available in</span>

      {list.map(e => <span key={e} className={`ck-pill ck-pill--${e}`}>
          {EDITION_LABELS[e] || e}
        </span>)}

      {plans ? <span className="ck-avail__label">Plan</span> : null}
      {plans ? <span className="ck-pill ck-pill--plan">{plans}</span> : null}

      {roles ? <span className="ck-avail__label">Who</span> : null}
      {roles ? <span className="ck-pill ck-pill--role">{roles}</span> : null}

      {note ? <span className="ck-avail__note">{note}</span> : null}
    </div>;
};

<Availability editions={['clinic']} plans="Enterprise" roles="Owner, manager or accountant" note="Only the owner can save changes on this tab" />

This tab decides the shape of every amount the hospital charges — which currency it is in, what tax goes on top, and any standing fee or percentage added to each visit. Set it once and every invoice, receipt and price label across the building follows.

<Path steps={['Sidebar', 'Settings', 'Billing', 'Billing & Plans']} />

<TaskHeader before="Your local tax rate, and the currency the hospital actually banks in" time="2 minutes" after="Every new invoice and receipt priced in your currency, with your tax and fees applied" />

The sidebar groups this tab under **Practice Billing**, but everything saved here is about how *your* money is presented to *your* patients. Changing which ClinikEHR plan the hospital pays for is a separate job — see [Change your plan](/platform/plans/change-plan).

## What this tab controls

The card is headed **Billing Settings** — "Manage your clinic's billing and payment settings." Every control on it is **owner-only**: a manager or accountant sees the whole card, filled in, but nothing moves and there is no **Save Changes** button.

| Control                                 | What it does                                                                                                                                                                             | Default        |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| **Free Clinic Mode**                    | Switch. "Enable this if your clinic provides free services. All charges will be disabled." Turning it on hides every control below it and adds a green **Free Clinic** badge to the card | Off            |
| **Currency**                            | Searchable picker — "Currency for all transactions. Search by name or code." Type "naira", "NGN" or "euro" and it matches; currencies are grouped by region                              | USD            |
| **Tax Rate (%)**                        | "Applied to invoices and receipts." Accepts 0 to 100, to two decimal places                                                                                                              | 0              |
| **Fee Amount**, under **Flat Rate Fee** | "A fixed fee applied to each service or visit (e.g., consultation fee, registration fee)"                                                                                                | 0              |
| **Additional Charge**                   | Switch. "Enable a percentage-based additional charge (e.g., service charge, processing fee)." Turning it on reveals the two fields below                                                 | Off            |
| **Charge Name**                         | "Display name on invoices" — what the patient actually reads on the line                                                                                                                 | Service Charge |
| **Charge Rate (%)**                     | "Percentage applied to subtotal"                                                                                                                                                         | 0              |
| **Save Changes**                        | Writes all of the above. Only the owner sees this button                                                                                                                                 | —              |

## Set it up

<Steps>
  <Step title="Open the tab">
    Go to **Settings › Billing & Plans**. If a colleague sent you a link and you landed on **General Settings** instead, that link's tab does not exist for this hospital.
  </Step>

  <Step title="Decide on Free Clinic Mode first">
    If the hospital does not charge patients at all, turn **Free Clinic Mode** on and stop — the rest of the card disappears because none of it applies.
  </Step>

  <Step title="Choose your currency">
    Select the **Currency** box and search by name or code. Pick the currency the hospital banks in, not the one patients ask about.
  </Step>

  <Step title="Enter your tax rate">
    Put your local sales tax or VAT percentage in **Tax Rate (%)**. Leave it at 0 if you do not add tax to invoices.
  </Step>

  <Step title="Add a standing fee, if you charge one">
    **Fee Amount** is a flat sum added per service or visit — a registration or consultation fee. Leave it at 0 if there is none.
  </Step>

  <Step title="Add a percentage charge, if you charge one">
    Turn on **Additional Charge**, name it in **Charge Name** so it reads sensibly on an invoice, then set **Charge Rate (%)**.
  </Step>

  <Step title="Save">
    Select **Save Changes**. A "Billing settings updated successfully" toast confirms it.
  </Step>
</Steps>

## What changes once you save

Currency is the one with reach. It does two separate jobs.

* **Every amount in the product re-renders in the new symbol** — service prices, invoices, receipts, the pharmacy till, ward charges, dashboards and reports. The card's own footer says it plainly: "These settings affect how invoices and receipts are generated."
* **It decides which payment provider the hospital uses.** Naira routes you to **Paystack Connect**; every other currency routes you to **Stripe Connect**. Switch currency and [Online payments](/hospital/settings/online-payments) swaps to the other provider's card — a connection you already made with the previous provider is not carried across.

The rest is narrower:

* **Tax Rate (%)** starts applying to invoices and receipts created **from now on**.
* **Fee Amount** and **Additional Charge** are added to new invoices — the additional charge as a percentage of the subtotal, under the name you gave it.
* **Free Clinic Mode** disables charging everywhere and badges the workspace as a **Free Clinic**.

What does **not** change, and this is what people assume wrongly: **changing currency does not re-price anything already recorded.** An invoice raised for 15,000 stays 15,000 — the number is not converted, only the symbol in front of new amounts changes. The same is true of tax and fees: an invoice already issued keeps the tax it was issued with. If you are moving currency for real, treat outstanding invoices as historical records and raise new ones for anything still to be collected. Background: [Currency and money display](/platform/settings/currency).

**There is no Insurance Settings tab on Enterprise.** Payers, coverage, pre-authorisation and claims for a hospital live in their own module rather than behind a settings tab — see [Insurance](/hospital/insurance/overview). Nothing is missing; it moved.

## Check it worked

Raise a draft invoice for any patient. The amounts should carry your new symbol, the tax line should show your new rate, and any flat fee or named percentage charge should appear as its own line. Then open **Online Payments** — the provider card there should match your currency.

## Common issues

<AccordionGroup>
  <Accordion title="Everything on this tab is greyed out and there is no Save button">
    You are signed in as a manager or an accountant. Currency, tax and the free-clinic switch are owner-only even for managers — the controls render so you can read the current setup, but only the owner can change them.
  </Accordion>

  <Accordion title="I changed currency and old invoices look wrong">
    They are not wrong — they are unconverted. Only the symbol on newly created amounts changes; nothing already recorded is re-priced. Reissue anything still outstanding.
  </Accordion>

  <Accordion title="The currency and tax fields have disappeared">
    **Free Clinic Mode** is on. It hides everything below it because charging is disabled. Turn it off and the fields come back with their saved values.
  </Accordion>

  <Accordion title="Our Stripe connection vanished after a currency change">
    You changed to or from Naira, which swaps the provider between Stripe and Paystack. Reconnect with the provider your new currency uses — see [Online payments](/hospital/settings/online-payments).
  </Accordion>

  <Accordion title="I cannot find Insurance Settings">
    It exists on Solo and Team only. On Enterprise, insurance is a full module — open [Insurance](/hospital/insurance/overview) instead.
  </Accordion>
</AccordionGroup>

<StillStuck />