> For the complete documentation index, see [llms.txt](https://chatlyst.gitbook.io/chatlyst-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatlyst.gitbook.io/chatlyst-user-guide/top-up-guideline/top-up-guideline.md).

# Top Up Guideline

This guide explains how to top up credits in Chatlyst.

Chatlyst uses two credit types, and each one supports a different function.

* **Knowledge Consolidation Bot Credits (KC Bot)** — Used to train and update business knowledge.
* **AI Response Credits** — Used for AI bot chat handling, including generating and sending responses during conversations.

### How to Top Up

{% stepper %}
{% step %}
Users can open the Top up page in several ways. Choose the option that is fastest at the time.

* Open **Settings →** [**Billing**](https://www.notion.so/Settings-f3f58ff777ff82df8265815e49b337cb?pvs=21).
* Open **Dashboard → Usage**, then select [**Top up**](/chatlyst-user-guide/dashboard/usage.md).
* **(Recommend)** On the Home page, use the [**Usage Details: Top up shortcut**](/chatlyst-user-guide/getting-started/home.md#usage-details).
  * This shortcut is useful when credits are running low.
  * It also shows the remaining credit balance.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FpWF68t7HfywEHKbEJV71%2Fimage.png?alt=media&amp;token=fefd44fa-d47d-4fff-aba3-390b69a9fb7d" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
After selecting **Top up**, Chatlyst redirects to the Billing page. Then select the credit type to purchase.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FKhuZQNtcEa0YPD9YOgin%2Fimage.png?alt=media&amp;token=64d74c5f-240e-4b1f-ad02-abecccb1a2be" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
In the Credit tab, users can review available credits and see a Low Balance reminder in the top-right corner when credits are running low.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FRyn3JRaBCjRujm28rTgk%2Fimage.png?alt=media&amp;token=bf82139f-976c-4d9d-a2f3-250bd800aeca" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
The Purchase Credits window appears after selecting the credit type.

{% hint style="info" %}
A minimum purchase amount of HKD 50 per transaction applies, including cases where the amount is equivalent to HKD 50.
{% endhint %}

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FWcPk9RMoYXogrBKx03hY%2Fimage.png?alt=media&amp;token=4ee3c3cd-11f9-4fc4-896a-600bdc559197" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
(Optional) Switch credit type or top up both credit types. Use the toggles on the right side of the window.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F4Rvk2DETzjCsuTH2PmNr%2Fimage.png?alt=media&amp;token=52090db5-21d8-43e2-8d37-5cb7cb25122f" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Review recent usage (last 30 days) to understand how quickly credits are consumed.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F8WPEhMgzoG4ESbP1uC0a%2Fimage.png?alt=media&amp;token=04dbcc55-52ac-4b3c-ad52-5888d65c07ce" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Review pricing tiers for the selected credit type. Select View KC Pricing Tiers or View AI Pricing Tier to expand the pricing list. Compare the available tiers and the included credits before continuing.

<div><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FMRMKpOgxRSqSf7FCxNTY%2Fimage.png?alt=media&amp;token=1fb3af87-619d-4d91-b33d-8e89d3cc553d" alt=""><figcaption></figcaption></figure> <figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F96bQ1J9z3NOEnNzNlDHH%2Fimage.png?alt=media&amp;token=f49448b8-6e74-4172-bc73-c69051d34257" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Drag the slider to set an amount, or enter an exact number in the input field.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FCiShiHbInrvIv6jlJgpa%2Fimage.png?alt=media&amp;token=7739aa22-9a3a-4619-873e-7d8d7e1814db" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Review the purchase summary to confirm the credit amount and total cost, then select **Pay**.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FSIfnkSmpZIABwYOnr2zS%2Fimage.png?alt=media&amp;token=25039882-872a-4db7-93b8-cd42618c7eb6" alt="" width="375"><figcaption></figcaption></figure></div>

{% hint style="warning" %}
If the amount does not meet the minimum payment requirement of HKD 50, the Pay option is disabled and displayed in grey.

![](https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F0kJZ0Fk9oE0oB32rvF4A%2Fimage.png?alt=media\&token=88e027d4-1cda-4f42-b274-5dff279b43dd)
{% endhint %}
{% endstep %}

{% step %}
In the Complete Purchase window, enter payment details, then select **Pay** to submit payment and complete the purchase.

<div><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F0yFMErPtvP8h2TVCsc8A%2Fimage.png?alt=media&amp;token=37250b2d-6081-4e57-88cc-d913a4fab1a9" alt=""><figcaption></figcaption></figure> <figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2Fn0tGxgFbcQckrbTtv0dm%2Fimage.png?alt=media&amp;token=119984d0-997c-4c9c-93aa-c7570edbc53e" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Other Options:**

* Save purchase information — Select the checkbox to save purchase information for faster checkout next time.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FSiR1t1mVADvqCLkEh5v7%2Fimage.png?alt=media&amp;token=4b03edd0-9838-45fc-9db8-11481c4a57a7" alt="" width="375"><figcaption></figcaption></figure></div>

* Breakdown — Select **View Details** to review the purchase breakdown before payment.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FEXasBuSORMR71ZE76dzJ%2Fimage.png?alt=media&amp;token=70e10cc6-82da-4c99-b973-7464573a12b8" alt="" width="375"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FEoNy9lO2iqxVIpzobX5a%2Fimage.png?alt=media&amp;token=0252c8bd-59b9-4a64-874a-f2692fd755ce" alt="" width="375"><figcaption></figcaption></figure></div>

* Quick checkout with Link — If there is a Link account, select **Pay with Link** for faster checkout.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2F11Ar3pHlOpZuIJMxbqSE%2Fimage.png?alt=media&amp;token=b6f59ae0-e6ce-4ddf-9ba7-7988a48564f2" alt="" width="375"><figcaption></figcaption></figure></div>
{% endstep %}
{% endstepper %}

### Purchase Confirmation

* After the purchase is complete, Chatlyst redirects back to the [Billing](/chatlyst-user-guide/settings/billing.md) page. Confirm the purchase in Transaction History, where the new purchase record appears.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FGfqWvVyvjDUExgk47jko%2Fimage.png?alt=media&amp;token=3cf958f3-3d81-4758-a1e8-9df381bd513b" alt=""><figcaption></figcaption></figure></div>

* Chatlyst will also send a receipt to your email with downloadable links for both the invoice and receipt.

<div data-with-frame="true"><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FaCCj7YkyeJpwT8HnZsdG%2Fimage.png?alt=media&amp;token=f7c90248-104d-4c0a-af09-c3a2763b6e46" alt="" width="375"><figcaption></figcaption></figure></div>

* The invoice and receipt templates are shown below:

<div><figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2Fat4vMofnRTutgsACMrUs%2Fimage.png?alt=media&amp;token=0ff28bb9-79f5-4168-8179-bd9c2eb2fcf9" alt="" width="563"><figcaption><p>Invoice</p></figcaption></figure> <figure><img src="https://1646628841-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FBW7n4ClAhZvbgvusylCd%2Fuploads%2FxAqcRKRtpLRDGIsg8vx0%2Fimage.png?alt=media&amp;token=0ff14d5b-99d4-41e6-b9e2-2d88da18b2b8" alt="" width="563"><figcaption><p>Receipt</p></figcaption></figure></div>
