> For the complete documentation index, see [llms.txt](https://docs.shoppego.my/tutorials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shoppego.my/tutorials/ms/settings/payment/payment-gateway/billplz.md). # Billplz ## Pendaftaran akaun Billplz Klik di link ini untuk mula daftar **akaun Billplz** anda. {% 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. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-fe7169814d360617c90e28cd352a4a96a00bce63%2F-MfezlhF2gq4BYpMPCxl.png?alt=media) ### Dapatkan Collection ID 1\. Pada bahagian dashboard **Billplz**, anda boleh klik pada **Billing** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-63179bea3ea558dd90da263ed7b9e28ca2037926%2F-Mff3zrKtGpKuSJl2TsE.jpg?alt=media) 2\. Di page **Billing**, anda boleh klik pada butang **Create Collection** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-eee290ac0d84e7d7214c8476815854117e2515bc%2F-Mff6h8Ac2pVzoGQfHxw.jpg?alt=media) 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** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-8e8dd05e4a5e5be685e0197f4484cc5b63801f54%2F-Mff6jxbXRRWMTcix0QF.jpg?alt=media) 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. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-22e76c0b1059334963faaef6b48ec0db17353e6b%2F-Mff7HW9mPV-oPwfiC7d.jpg?alt=media) ### Dapatkan Secret key 1\. Pada bahagian dashboard Billplz, anda boleh klik pada ikon **anak panah bawah** dan **klik Settings** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-52ba69c493096a855f6aa2f669a2ed56daf879cd%2F-Mff04bXJTn48I79LXdo.jpg?alt=media) 2\. Seterusnya anda akan dibawa ke halamanSettings, anda boleh klik pada **BILLPLZ SECRET KEY** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-ccfedd794526a5e204d5dc1793540bd4f7b9a430%2F-Mff0tFLpZpxFqGe6rsK.jpg?alt=media) 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. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-da1304169a19252db0eb64b3f01376779bd54c4e%2F-Mff1gnd6TTwq5SdFT89.jpg?alt=media) ### Dapatkan X Signature 1\. Pada bahagian dashboard Billplz, anda boleh klik pada icon **anak panah bawah** dan **klik Settings** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-52ba69c493096a855f6aa2f669a2ed56daf879cd%2F-Mff04bXJTn48I79LXdo.jpg?alt=media) 2\. Seterusnya anda akan dibawa ke halaman Settings, anda boleh klik pada **XSIGNATURE PAYMENT** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-ccfedd794526a5e204d5dc1793540bd4f7b9a430%2F-Mff0tFLpZpxFqGe6rsK.jpg?alt=media) 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" %} \*\*Perhatian\*\*\*\*:\*\* 1. Pastikan penetapan **XSignature anda sama seperti paparan dibawah** untuk memastikan **tiada sebarang isu berlaku** semasa penetapan anda. 2. Pastikan anda **tick pada Enable XSignature Payment Completion** sahaja. {% endhint %} ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-1549bff52fa42786d4c2576de1e414d1924b30a7%2F-Mff3QAV3C7H7l7TinOC.jpg?alt=media) 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. Untuk memulakan penetapan payment gateway tersebut, anda boleh ikut langkah penetapan ini. 1\. Log masuk akaun Shoppego anda. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-b853fc0189b34fb1d3990f5b1f53fa71deb9d384%2FlCN7aw3FznaFFoOAyya2.jpg?alt=media) 2\. Seterusnya anda boleh klik pada tab **Settings** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-9ae8b66b366958146673b78216b78ff0e8f12b90%2FVsK9zs6aZtUfKK1hcCiM.jpg?alt=media) 3\. Anda akan dibawa ke halaman Settings dan anda boleh klik pada butang **Payment options** ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-6887bc460f7731261524a21148108938e4436a20%2FCA5qmbxGnMXdjUXh5W4M.jpg?alt=media) 6\. Pada bahagian halaman Payment options, anda boleh klik butang **Activate/Edit** pada tab payment gateway Billplz. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-069a530e2dc3591540eb4239cf85b329505c4786%2FnIzITxEgKUY59FxQTRsr.jpg?alt=media) 7\. Seterusnya, anda akan dibawa ke halaman penetapan untuk payment gateway Billplz. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-9f997efb50783824618c3c637f2ccf66a8a2fcc7%2Ff8d1U8vEPq0X3uYsLsvn.jpg?alt=media) 8\. Dengan menggunakan key yang anda sudah simpan pada langkah mendapatkan key tersebut, anda boleh masukkan kesemua key tersebut pada ruangan mereka. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-4fe4363f21b87a1366b692d28b54fd54e256e751%2FBuIXClN9Aqcp3ukTNisk.jpg?alt=media) 9\. Setelah selesai anda boleh klik **Save** untuk simpan penetapan tersebut. {% hint style="info" %} Sekiranya anda ingin **memulakan transaksi sebenar**, diminta untuk anda **mematikan** toggle **Test Mode** itu. {% endhint %} ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-60fa84b5afc1d1d07972d4e881ca1578c2ffff46%2FCeQr3Hz8RZuYI6EjE9Qa.jpg?alt=media) ## Contoh di Website Setelah selesai proses penetapan tersebut, anda boleh cuba membuat pembelian di website Shoppego anda untuk melihat hasilnya. ![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-ce9984350f78f44ff7ccf6cc4bf8971055cc4f29%2F-MffAaoLUxhh2CHw9A5u.png?alt=media)