# Stripe

Bagi menggunakan Stripe sila pastikan anda **sudah cipta** terlebih dahulu **akaun Stripe.**

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

{% hint style="danger" %}
Jumlah transaksi minimum untuk Stripe ialah sekurang-kurangnya RM2.00
{% endhint %}

## Dapatkan API key di Stripe

1\. Pendaftaran akaun Stripe boleh dibuat di : <https://dashboard.stripe.com/register>

2\. Untuk mendapatkan api key anda boleh mencarinya di **dashboard** atau klik sahaja link ini : <https://dashboard.stripe.com/login?redirect=%2Faccount%2Fapikeys>

3\. Setelah anda mendapatkan **Publishable key** dan **Secret key** anda boleh simpankan key tersebut untuk penetapan di Shoppego.

![](/files/-MD8Z-UDHUXIhH4PNbRk)

## Penetapan Webhooks di Stripe

Terdapat 2 jenis webhooks yang anda perlu masukkan pada penetapan webhooks akaun Stripe anda, iaitu:\
1\. <https://hartamas.myshoppegram.co&#x6D;**/webhooks/payments/callback/checkouts/stripe**\\>
2\. <https://hartamas.myshoppegram.co&#x6D;**/webhooks/payments/callback/typ\\_offer/stripe>\*\*

Anda **diwajibkan untuk menggantikan <https://hartamas.myshoppegram.com> tersebut dengan URL <https://subdomain.myshoppegram.com> website anda yang tersendiri yang telah diberikan secara percuma sewaktu pendaftaran akaun Shoppego anda** tersebut.

Anda boleh dapati URL subdomain anda pada bahagian berikut:\
Dashboard Overview Shoppego -> **Settings** -> **Custom domain** -> **Subdomain**

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

Anda boleh rujuk contoh penetapan webhooks dibawah:

1. Didalam dashboard Stripe tersebut, anda boleh klik pada bahagian **Developers** -> **Webhooks**. Anda juga boleh klik pada link ini terus: <https://dashboard.stripe.com/webhooks>

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

2. Seterusnya, anda boleh klik pada **Add an endpoint/Add endpoint**

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

3. Seterusnya, anda boleh **masukkan salah satu URL webhooks store anda yang tersendiri pada bahagian Endpoint URL**. Sebagai contoh disini, kami telah masukkan URL ini terlebih dahulu: <https://hartamas.myshoppegram.com/webhooks/payments/callback/checkouts/stripe>

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

4. Kemudian, anda boleh **klik** pada **butang Select events**

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

5. Setelah anda dapat lihat paparan pemilihan events, anda boleh **cari events** yang mempunyai nama **Payment Intent** dan anda boleh **klik pada event tersebut**.

<figure><img src="/files/0LHR70LozLVqfOyaLxke" alt=""><figcaption></figcaption></figure>

6. Kemudian, anda boleh **tick Select all Payment Intent events** terlebih dahulu.

<figure><img src="/files/8Nf6CxecwtHrQUzb8ZJg" alt=""><figcaption></figcaption></figure>

7. Seterusnya, anda boleh **untick checkbox payment\_intent.amount\_capturable\_updated** dan **payment\_intent.partially\_funded**

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

8. Setelah selesai, anda boleh klik pada butang **Add events**

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

9. Setelah anda pastikan penetapan anda sudah betul, anda boleh klik pada butang **Add endpoint**

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

10. Jika anda dibawa kehalaman ini, anda boleh klik sahaja semula pada butang **Webhooks**

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

11. Nanti, anda akan dibawa semula ke halaman Webhooks dan anda boleh lihat penetapan endpoint yang anda baru lakukan sebelum ini. Seterusnya anda boleh **ulang langkah diatas dan masukkan pula endpoint/webhooks URL yang kedua**.

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

Setelah selesai, anda sepatutnya akan mempunyai **2 endpoint/webhooks URL** seperti pada paparan dibawah:&#x20;

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

## Penetapan di Shoppego

1\. Log masuk ke akaun Shoppego anda.

![](/files/lCN7aw3FznaFFoOAyya2)

2\. Klik pada **Settings**

![](/files/VsK9zs6aZtUfKK1hcCiM)

3\. Klik pada **Payment options**

![](/files/CA5qmbxGnMXdjUXh5W4M)

4\. Jika anda belum aktifkan payment option untuk Stripe. Klik butang **Activate** pada bahagian **Alternative Payments** untuk Stripe. Jika anda sudah aktifkan payment option untuk Stripe klik butang **Edit.**

![](/files/4RR2o2QPI4YtfTS3OtQk)

5\. Seterusnya akan keluar paparan seperti dibawah, anda boleh isi maklumat tersebut :&#x20;

![](/files/Y7mRZk9lurcPP9Bixg7T)

* **Display name at checkout : Masukkan nama payment yang anda inginkan ( Contoh Online Payment )**
* **Publishable key : Masukkan Publishable key yang anda sudah dapatkan di akaun Stripe anda.**
* **Secret key : Masukkan Secret key yang anda sudah dapatkan di akaun Stripe anda.**

6\. Setelah selesai pastikan anda sudah klik **Enable** dan klik button **Save**.

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

![](/files/dS3chJnBh2OUueJHYYAi)

7\. Setelah **Save** anda boleh membuat percubaan pembelian pada website anda untuk lihat payment option Stripe tersebut semasa checkout untuk penetapan yang anda baru tetapkan sebentar tadi.


---

# 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/stripe.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.