# BillPlz

To connect Billplz with the Kuasa website, you will need several keys for the verification process. Some of the required keys include **Collection ID**, **Secret Key**, and **X Signature.** To initiate the setup process of the BillPlz payment gateway, you can follow this tutorial:

\
1\. Visit [www.billplz.com](http://www.billplz.com/) if you haven't registered a Billplz account yet, or log in directly if you have already registered. Then, click the **Sign Up** button.

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2Fdw1SdgoP756941ctunh0%2FSales%20pg%20billplz%201.png?alt=media&#x26;token=2852f443-eb5c-4c63-ab3a-3974f3377ce3" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**Obtain the Collection ID.**</mark>

After you have successfully registered your account, you can log in and access the BillPlz dashboard. Then, click on **Billing** to add a **Collection ID**.

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2FxllBwaRfca0VnOeHN0IT%2FSales%20pg%20billplz%202.png?alt=media&#x26;token=64d798d9-5ee9-4eba-b718-88f13e758b46" alt=""><figcaption></figcaption></figure>

2. On the billing page, click the **Create Collection** button. A popup will appear, and you need to enter the **Collection Title** and also check "**I understand how reload credit works as stated below**", then click the **Submit** button.

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2FBsiA1jonpPTPIDPnz8Ck%2FSales%20pg%20billplz%203.png?alt=media&#x26;token=f7b49bf8-a383-409e-9482-82494dc4dba5" alt=""><figcaption></figcaption></figure>

3. Once done, you will be able to see the Collection you just created a moment ago. You can click on the **Copy** button to copy the **Collection ID** and save it for later, or you can directly input it into Kuasa.

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2FP9yiJ0nQAEdVu5rsXjrL%2FSales%20pg%20billplz%204.png?alt=media&#x26;token=a3443c0c-5444-4969-a4be-a302d68dd978" alt=""><figcaption></figcaption></figure>

### <mark style="color:blue;">Obtain the Secret Key.</mark>

1. On the **Billplz dashboard**, you can click on the downward arrow icon and then click on **Settings**.

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2FiIlD9G6PKaOEwm66RSA9%2FSales%20pg%20billplz%205.png?alt=media&#x26;token=944fa77c-3a1a-45bf-a94e-d020890f8c8e" alt=""><figcaption></figcaption></figure>

2. Next, you will be taken to the **Settings** page, where you can click on "**BILLPLZ SECRET KEY**".

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2Fp7ZmSGkEthJfPux7koNj%2FSales%20pg%20billplz%206.png?alt=media&#x26;token=ebb7bcae-faee-4e50-bf48-d2c4395fe144" alt=""><figcaption></figcaption></figure>

3. After you click on the "**BILLPLZ SECRET KEY**" tab, you will be able to see your **API key**, which you need to enter into the Kuasa system. You can click the **Copy Billplz Key** button to copy the key and save it for later, or you can directly input it into Kuasa.

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2FbUE4KetnsJYH3LHP3C6a%2FSales%20pg%20billplz%207.png?alt=media&#x26;token=cf650c60-ba91-47fa-8540-7297a3da4a21" alt=""><figcaption></figcaption></figure>

<mark style="color:blue;">**Obtain the X Signature.**</mark>

\
1\. The process is similar to obtaining the **Secret Key**. On the same page, you can click on "**XSIGNATURE PAYMENT**", then click the **Save & Copy Xsignature key** button.

<figure><img src="https://4042228131-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjUshnokTPXfX7lwwLXnA%2Fuploads%2FJioMNWtFL6ezEBrlGbgu%2FSales%20pg%20billplz%208.png?alt=media&#x26;token=84ec00b1-32ce-4e41-9c63-7cc41b0988d5" alt=""><figcaption></figcaption></figure>

1. Log in to your account via <https://landing-page.kuasa.io/>.
2. Click **Landing Page.**

<figure><img src="/files/9EYM2ZTWXXgqgIwRFcs6" alt=""><figcaption></figcaption></figure>

3. Click on **Settings**.

### Setting up in Kuasa

1. You can save all three of these keys for use in the next steps.&#x20;
2. The keys you need to save are:

* **Collection ID**
* **Secret key**
* **X Signature**

<figure><img src="/files/bYsRi4DEezUAYtaH1JCu" alt=""><figcaption></figcaption></figure>

4. Click on **Payment Gateway**.

<figure><img src="/files/T7wkhHTEMj7Vnf6de7Ck" alt=""><figcaption></figcaption></figure>

5. Fill in the **API Key**, **X Signature**, and **Collection ID** from BillPlz, and make sure the toggle button is **ON**. Click **Save Changes** button to save the changes.

<figure><img src="/files/sRz1fb3rokxbpyraJAvf" alt=""><figcaption></figcaption></figure>

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tutorials.kuasa.io/getting-started/kuasa-landing-page/payment-gateway/billplz.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
