# Billplz

## Pendaftaran akaun Billplz

Klik di link ini <https://sso.billplz.com/users/sign_up> untuk mula daftar **akaun Billplz** anda.&#x20;

{% hint style="success" %}
Bagi proses pendaftaran **akaun Billplz** anda perlu pastikan anda sudah:

* Mempunyai SSM
* Akaun bank semasa
  {% endhint %}

{% hint style="info" %}
**Urusan pengesahan akaun, caj dan wang transaksi** adalah **diuruskan sepenuhnya oleh pihak Billplz**.
{% endhint %}

## Dapatkan kesemua key yang diperlukan dari akaun Billplz

Untuk menghubungkan Billplz dengan website Shoppego, anda memerlukan beberapa key untuk proses pengesahan. Antara key yang diperlukan ialah **Collection ID,** **Secret Key** dan **X Signature**. Untuk memulakan proses penetapan payment gateway Billplz anda boleh ikut langkah penetapan ini :

1\. Log masuk ke akaun **Billplz/Plzlogin** anda.

![](/files/-MfezlhF2gq4BYpMPCxl)

### Dapatkan Collection ID

1\. Pada bahagian dashboard **Billplz**, anda boleh klik pada **Billing**

![](/files/-Mff3zrKtGpKuSJl2TsE)

2\. Di page **Billing**, anda boleh klik pada butang **Create Collection**

![](/files/-Mff6h8Ac2pVzoGQfHxw)

3\. Setelah anda klik butang tersebut, anda akan diminta untuk isi ruangan **Collection title**(Nama yang anda ingin gunakan sebagai rujukan untuk payment yang masuk pada billing anda). Setelah selesai anda boleh **tick pada I understand how reload credit works as stated below** dan klik **Submit**

![](/files/-Mff6jxbXRRWMTcix0QF)

4\. Setelah selesai anda akan dapat lihat Collection yang anda baru anda cipta sebentar tadi. Anda boleh klik pada butang **Copy** dan simpan terlebih dahulu atau anda boleh sahaja terus masukkan didalam Shoppego dengan rujuk langkah penetapan Shoppego dibawah.

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

### Dapatkan Secret key

1\. Pada bahagian dashboard Billplz, anda boleh klik pada ikon **anak panah bawah** dan **klik Settings**

![](/files/-Mff04bXJTn48I79LXdo)

2\. Seterusnya anda akan dibawa ke halamanSettings, anda boleh klik pada **BILLPLZ SECRET KEY**

![](/files/-Mff0tFLpZpxFqGe6rsK)

3\. Setelah anda klik pada tab **BILLPLZ SECRET KEY** tersebut, anda akan dapat lihat API key anda untuk anda masukkan didalam sistem Shoppego. Anda boleh klik button **Copy Billplz key** tersebut dan simpan terlebih dahulu atau anda boleh sahaja terus masukkan didalam **Shoppego** dengan rujuk langkah penetapan Shoppego dibawah.

![](/files/-Mff1gnd6TTwq5SdFT89)

### Dapatkan X Signature

1\. Pada bahagian dashboard Billplz, anda boleh klik pada icon **anak panah bawah** dan **klik Settings**

![](/files/-Mff04bXJTn48I79LXdo)

2\. Seterusnya anda akan dibawa ke halaman Settings, anda boleh klik pada **XSIGNATURE PAYMENT**

![](/files/-Mff0tFLpZpxFqGe6rsK)

3\. Setelah anda klik pada tab **XSIGNATURE PAYMENT** tersebut, anda akan dapat lihat **XSignature** key anda untuk anda masukkan didalam sistem Shoppego. Anda boleh klik button **Save & Copy XSignature Key** tersebut dan simpan terlebih dahulu atau anda boleh sahaja terus masukkan didalam Shoppego dengan rujuk langkah penetapan Shoppego dibawah.

{% hint style="info" %} <mark style="color:red;">**Perhatian**</mark>**:**&#x20;

1. Pastikan penetapan **XSignature anda sama seperti paparan dibawah** untuk memastikan **tiada sebarang isu berlaku** semasa penetapan anda.&#x20;
2. Pastikan anda **tick pada Enable XSignature Payment Completion** sahaja.
   {% endhint %}

![](/files/-Mff3QAV3C7H7l7TinOC)

Anda boleh simpan **ketiga - tiga key** tersebut untuk kegunaan di langkah seterusnya. Key yang anda perlu simpan ialah :

* Collection ID
* Secret key
* X Signature

## Penetapan di Shoppego

Untuk proses penetapan payment gateway **Billplz** di Shoppego anda perlu aktifkan terlebih dahulu payment gateway tersebut dan masukkan ketiga-tiga key tersebut kedalam penetapan payment gateway anda.&#x20;

Untuk memulakan penetapan payment gateway tersebut, anda boleh ikut langkah penetapan ini.

1\. Log masuk akaun Shoppego anda.

![](/files/lCN7aw3FznaFFoOAyya2)

2\. Seterusnya anda boleh klik pada tab **Settings**

![](/files/VsK9zs6aZtUfKK1hcCiM)

3\. Anda akan dibawa ke halaman Settings dan anda boleh klik pada butang **Payment options**

![](/files/CA5qmbxGnMXdjUXh5W4M)

6\. Pada bahagian halaman Payment options, anda boleh klik butang **Activate/Edit** pada tab payment gateway Billplz.

![](/files/nIzITxEgKUY59FxQTRsr)

7\. Seterusnya, anda akan dibawa ke halaman penetapan untuk payment gateway Billplz.

![](/files/f8d1U8vEPq0X3uYsLsvn)

8\. Dengan menggunakan key yang anda sudah simpan pada langkah mendapatkan key tersebut, anda boleh masukkan kesemua key tersebut pada ruangan mereka.

![](/files/BuIXClN9Aqcp3ukTNisk)

9\. Setelah selesai anda boleh klik **Save** untuk simpan penetapan tersebut.&#x20;

{% hint style="info" %}
Sekiranya anda ingin **memulakan transaksi sebenar**, diminta untuk anda <mark style="color:red;">**mematikan**</mark> toggle **Test Mode** itu.
{% endhint %}

![](/files/CeQr3Hz8RZuYI6EjE9Qa)

## Contoh di Website

Setelah selesai proses penetapan tersebut, anda boleh cuba membuat pembelian di website Shoppego anda untuk melihat hasilnya.

![](/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/ms/settings/payment/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.