# Billplz

## Billplz account registration

Click on this link <https://sso.billplz.com/users/sign_up> to start registering your Billplz account.&#x20;

{% hint style="success" %}
For the Billplz account registration process, you need to make sure you **already :**&#x20;

* **Have SSM**&#x20;
* **A current Bank Account.**
  {% endhint %}

{% hint style="info" %}
**Account verification, fees, and transactional funds,** they are **fully managed by Billplz.**
{% endhint %}

## Get all the necessary keys from your Billplz account

To connect Billplz with your Shoppego website, you need several keys for the authentication process. Some of the required keys are **Collection ID, Secret Key,** and **X Signature**. To start the process of setting up the **Billplz** payment gateway, you can follow these steps:

1. Log in to your **Billplz/Plzlogin** account.

![](/files/-MfezlhF2gq4BYpMPCxl)

### Get a Collection ID

1\. In the Billplz dashboard section, you can click on **Billing**

![](/files/-Mff3zrKtGpKuSJl2TsE)

2\. On the Billing page, you can click on the **Create Collection** button

![](/files/-Mff6h8Ac2pVzoGQfHxw)

3\. After you click the button, you will be asked to fill in the **Collection title** field (The name you want to use as a reference for the payment entered on your billing). Once done you can **tick on I understand how reload credit works as stated below** and click **Submit**

![](/files/-Mff6jxbXRRWMTcix0QF)

4\. When done you will be able to see the Collection that you created just now. You can click on the **Copy** and save button first or you can just directly enter in Shoppego by referring to the Shoppego setup steps below.

![](/files/-Mff7HW9mPV-oPwfiC7d)

### Get the Secret key

1\. In the Billplz dashboard section, you can click on the **down arrow icon** and click **Settings**

![](/files/-Mff04bXJTn48I79LXdo)

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

![](/files/-Mff0tFLpZpxFqGe6rsK)

3\. After you click on the **BILLPLZ SECRET KEY** tab, you will be able to see your API key for you to enter in the Shoppego system. You can click the **Copy Billplz key** button and save it first or you can just enter it directly in Shoppego by referring to the Shoppego setup steps below.

![](/files/-Mff1gnd6TTwq5SdFT89)

### Get X Signature

1\. In the Billplz dashboard section, you can click on the **down arrow icon** and click **Settings**

![](/files/-Mff04bXJTn48I79LXdo)

2\. Next you will be taken to the Settings page, you can click on **XSIGNATURE PAYMENT**

![](/files/-Mff0tFLpZpxFqGe6rsK)

3\. After you click on the **XSIGNATURE PAYMENT** tab, you will be able to see your XSignature key for you to enter in the Shoppego system. You can click the **Save & Copy XSignature Key** button and save it first or you can just enter it directly in Shoppego by referring to the Shoppego setting steps below.

**\*\***<mark style="color:red;">**Note**</mark>**:** Make sure your **XSignature settings are the same** as the display below to **ensure no issues occur** during your settings. Make sure you **tick on Enable XSignature Payment Completion only.**

![](/files/-Mff3QAV3C7H7l7TinOC)

You can save the three keys for use in the next step. The keys you need to keep are:

* Collection ID
* Secret key
* Xsignature

## Setup in Shoppego

For the Billplz payment gateway setting process in Shoppego, you need to first activate the payment gateway and enter the three keys into your payment gateway setting.&#x20;

To start setting up the payment gateway, you can follow these setup steps.

1\. Log in to your Shoppego account.

![](/files/lCN7aw3FznaFFoOAyya2)

2\. Next you can click on the **Settings** tab

![](/files/VsK9zs6aZtUfKK1hcCiM)

3\. You will be taken to the Settings page and you can click on the **Payment options** button

![](/files/CA5qmbxGnMXdjUXh5W4M)

6\. On the Payment options page, you can click the **Activate/Edit** button on the Billplz payment gateway tab.

![](/files/nIzITxEgKUY59FxQTRsr)

7\. Next, you will be taken to the setup page for the Billplz payment gateway.

![](/files/f8d1U8vEPq0X3uYsLsvn)

8\. By using the key that you have saved in the step to get the key, you can enter all the keys in their space.

![](/files/BuIXClN9Aqcp3ukTNisk)

9\. Once done you can click **Save** to save the settings.&#x20;

{% hint style="info" %}
If you want to perform a **real transaction**, kindly <mark style="color:red;">**deactivate**</mark> the **Test Mode** toggle.
{% endhint %}

![](/files/CeQr3Hz8RZuYI6EjE9Qa)

## Example on the Website

After completing the setup process, you can try making a purchase on your Shoppego website to see the results.

![](/files/-MffAaoLUxhh2CHw9A5u)


---

# 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://docs.shoppego.com/en/settings/payment-options/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.