> 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/stripe.md).

# Stripe

To use Stripe please make sure you have **created a Stripe** account first.

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

{% hint style="danger" %}
The minimum transaction amount for Stripe is at least RM2.00
{% endhint %}

## Get an API key on Stripe

1\. Stripe account registration can be done at: <https://dashboard.stripe.com/register>

2\. To get the **live key** you can find it on the dashboard or just click this link: <https://dashboard.stripe.com/login?redirect=%2Faccount%2Fapikeys>

3\. Once you get the **Publishable key** and **Secret key** you can save the key for setting in Shoppego.

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-e7d42fabca0d813e48adac8932f953ceef0eff39%2F-MD8Z-UDHUXIhH4PNbRk.png?alt=media)

## Webhooks settings at Stripe

There are **2 types of webhooks** that you need to enter in the webhooks settings of your Stripe account, namely:\
1\. <https://hartamas.myshoppegram.co&#x6D;**/webhooks/payments/callback/checkouts/stripe**\\\\> 2. <https://hartamas.myshoppegram.co&#x6D;**/webhooks/payments/callback/typ\\\\_offer/stripe>\*\*

You are **required to replace the** [**https://hartamas.myshoppegram.com**](https://hartamas.myshoppegram.com) **with the URL** [**https://subdomain.myshoppegram.com**](https://subdomain.myshoppegram.com) **of your own website which has been given for free during the registration of your 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>

You can refer to examples of setting webhooks below:

1. In the Stripe dashboard, you can click on the **Developers** -> **Webhooks** section. You can also click on this link directly: <https://dashboard.stripe.com/webhooks>

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

2. Next, you can click on **Add an endpoint/Add endpoint**

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

3. Next, you can **enter one of your unique webhooks store URLs in the Endpoint URL section**. For example here, we have entered this URL first: <https://hartamas.myshoppegram.com/webhooks/payments/callback/checkouts/stripe>

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

4. Then, you can **click on the Select events button**

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

5. Once you can see the event selection display, you can **search for events** that have the name **Payment Intent** and you can **click on the event**.

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

6. Then, you can **tick Select all Payment Intent events** first.

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

7. Next, you can **untick checkbox payment\_intent.amount\_capturable\_updated** and **payment\_intent.partially\_funded** settings

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

8. Once done, you can click on the **Add events button**

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

9. Once you make sure your settings are correct, you can click on the **Add endpoint button**

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

10. If you are taken to this page, you can simply click again on the **Webhooks** button

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

11. Later, you will be taken back to the Webhooks page and you can see the endpoint setting you just made earlier. Next, you can **repeat the steps above and enter the second endpoint/webhooks URL**.

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

Once finished, you should have **2 endpoints/webhooks URL** as shown below:

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

## Setup in Shoppego

1\. Log in to your Shoppego account.

![](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\. Click on **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\. Click on **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)

4\. If you have not enabled the payment option for Stripe. Click the **Activate** button in the Alternative Payments for Stripe section.

If you have enabled the payment option for Stripe, click the **Edit** button.

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-e8c36895cfd828782ab6f58fb4e7922c7408e468%2F4RR2o2QPI4YtfTS3OtQk.jpg?alt=media)

5\. Next will appear the display as below, you can fill in the information:

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-46618f52981e8ecc5b53c584a037ba3445b1e16c%2FY7mRZk9lurcPP9Bixg7T.jpg?alt=media)

* **Display name at checkout: Enter the name of the payment you want (Example Online Payment)**
* **Publishable key: Enter the Publishable key you already got in your Stripe account.**
* **Secret key: Enter the Secret key you already got in your Stripe account.**

6\. Once done make sure you have clicked **Enable** and click the **Save** button.

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

![](https://3359028955-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lh09fNwqqta5Vj6Wr8p%2Fuploads%2Fgit-blob-98b982aebc5bdb277f6335cf5ed0028a82bdefa7%2FdS3chJnBh2OUueJHYYAi.png?alt=media)

7\. After **Save** you can make a purchase attempt on your website to see the Stripe payment option during checkout for the setting that you just set just now.