> 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/en/settings/payment-options/payment-gateway/payhalal.md).

# Payhalal

Tutorial for Payhalal Payment Gateway

## Payhalal Account Registration

Click on this link <https://payhalal.my/merchant-register> to start registering your Payhalal account.

{% hint style="success" %}
To begin registering your Payhalal Account, you must ensure you **do :**

* **Have SSM**
* **Current Bank Account.**
  {% endhint %}

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

## Get all the required keys for the Payhalal account.

To connect **Payhalal** with the Shoppego website, you will be required several keys for the verification process. The keys needed are the **App key** and the **Secret key**.

To set up the Payhalal payment gateway, kindly follow these steps:

1\. Login into your Payhalal account.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-2f7d73ea1309f13abb86cf82340468ed55d37976%2FYMx6RJwP2S3QFXtHQfUj.jpg?alt=media" alt=""><figcaption></figcaption></figure>

2\. Sign-in email and password used during registration.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-ec763443f511257d2f165396898ad0d2dd3ea75b%2Fx8Js0a5MiwbEqFEHKRVJ.jpg?alt=media" alt=""><figcaption></figcaption></figure>

3\. Then, on the **Payhalal Dashboard**, you will see the menu on the sidebar. Click on **General**.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-26b7dc2ed4c205f972d384bb1fdd85f77986890d%2FESshqGiR7POYvUipIwnn.jpg?alt=media" alt=""><figcaption></figcaption></figure>

4\. After that, you need to go to the **Developer Tools** and **Create App** to get the **App Key** and the **Secret key**.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-72c68c1c70c8c52a0719642fd5b9f227c1051521%2FBVbgwyF0CosrRIbP8PHh.jpg?alt=media" alt=""><figcaption></figcaption></figure>

5\. After that, you need to key in all the required information.

* App Name: You can put it as My App
* Website: This is Optional (Not compulsory to be filled)

In the App setting section as below you need to make sure you **use the URL** [**https://subdomain**](https://subdomain) **.myshoppegram.com of your Shoppego website which has been given for free by Shoppego during the registration of the Shoppego account**.

You can find your subdomain URL in the following section:\
Dashboard Overview Shoppego -> **Settings** -> **Custom domain** -> **Subdomain**

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-7967a6f701c7e0ac55a01618c857c2fe928d4335%2Fi6ChVkQCDHAFSqE60OI8.jpg?alt=media" alt=""><figcaption></figcaption></figure>

For example, **the subdomain link that you will use later is like this:** [**https://hartamas.myshoppegram.com**](https://hartamas.myshoppegram.com). Make sure every available URL setting space uses the subdomain link and follows the given format. You can copy the link below and place it in the App you have created.

* Success URL :\
  <https://hartamas.myshoppegram.com/checkouts/payments/redirect/payhalal>
* Callback URL: <https://hartamas.myshoppegram.com/webhooks/payments/callback/checkouts/payhalal>
* Cancel URL:\
  [https://hartamas.myshoppegram.com/checkouts/payments/redirect/payhalal](https://kedaianda.com/checkouts/payments/redirect/payhalal)
* Return URL:\
  <https://hartamas.myshoppegram.com/checkouts/payments/redirect/payhalal>

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-38233a40998404f81e2f05ad8382879ccfd84f4c%2FhSnjxIZjmXN3ww1ClC8C.jpg?alt=media" alt=""><figcaption></figcaption></figure>

6\. After you have done this, click **Save changes**.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-34a6542b17f28e610304bcc04783dac874310595%2FuAooHxwyr58dnzMDAvJ9.jpg?alt=media" alt=""><figcaption></figcaption></figure>

7\. Then, you will see several crucial data which are **App Key** and **Secret Key**. You can click on both icons highlighted in the red box to **view** and **copy the keys** to be put in the Shoppego settings.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-2126cf9f2d28761d9e3328a2d5b4a3497d95288d%2FyixeRfOIoVkIcVAspUkP.jpg?alt=media" alt=""><figcaption></figcaption></figure>

## **Shoppego Setting**

To set up the payment gateway **Payhalal** in Shoppego, you need to activate the payment gateway and insert both keys the **App key** and the **Secret Key** in your payment gateway setting.

1. Log in to your Shoppego account.

<figure><img src="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" alt=""><figcaption></figcaption></figure>

2\. Then, click on **Settings**, and click on the **Payment Options** section.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-78063a86c69dd6a6bc315e7c83f01ba10db3dbb1%2FzykM9wPrQmPVTxc7MMpq.jpg?alt=media" alt=""><figcaption></figcaption></figure>

3\. You can click on **Activate** / **Edit** on the Payhalal payment gateway.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-920d2a8fa7d10dedf2b775aceb3ac0b4d0b072cf%2FCqe62YbHCnihMbl3uKQP.jpg?alt=media" alt=""><figcaption></figcaption></figure>

4\. After that, you will be required to key in **App Key** and **Secret Key** that have been copied from Payhalal.

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

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-4644710b6cb3afae9a9d099f4b49948e4e2021ae%2Fcvkeyu0jVzilKPuuIV8v.jpg?alt=media" alt=""><figcaption></figcaption></figure>

## Website View Example

After completing the setup, you can try to do a transaction or a purchase on your Shoppego Website and view the result for yourself.

1. You can choose the Payhalal payment option as your payment gateway.

<figure><img src="https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-20c719f5724e116feb37014988957c7f3494092d%2FgtQnnCEp7fLmVEWulA7J.jpg?alt=media" alt=""><figcaption></figcaption></figure>

Congratulations! Now setup for your Payhalal is ready and successful!
