> For the complete documentation index, see [llms.txt](https://docs.omnichat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.omnichat.ai/features/she-ding/zheng-he/di-san-fang-ying-yong/chuan-jie-stripe.md).

# 串接 Stripe

{% hint style="info" %}
目前 Chat to order 已支援搭配 Stripe 以及 Global Payment 付款方式完成訂單付款，以下介紹客戶如何將 Stripe 帳號串接至 Omnichat。
{% endhint %}

### 註冊流程

1. 客戶完成 **OMO Chat to Order Module** or **WhatsApp Commerce Module** 的方案購買。
2. 客戶完成 Stripe 帳號建立，或使用曾經已建立過 Stripe 帳號也可以。
3. 取得 Stripe 相關 API Secret Key 的資料，並於 Omnichat 後台完成設定。
4. 於 Stripe 完成相關 Webhook 的串接，並於 Omnichat 後台完成設定。

### 流程步驟

#### 建立 Stripe 帳戶

1. 建立帳號：至 <https://dashboard.stripe.com/register> 並輸入 email, 全名, 密碼, 使用國家後點選 Create account

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FXYK5HT2gpOVR7KMpI1MO%2Fimage.png?alt=media&amp;token=dabd6e1d-7bd8-456b-8c44-d6be43e583a6" alt=""><figcaption></figcaption></figure>
2. 驗證 email: 註冊後會馬上收到一封含驗證連結的信，找不到的話可以檢查垃圾郵件，也可以從 Stripe 後台要求重寄。
3. 啟用帳號：
   1. 帳號建立後，會預設為 Sandbox Mode，要正式開始收款項，必須先啟用帳號才能切換到 Live Mode。
   2. 啟用時需要填寫帳號申請表，提供商家、產品，以及你與這間公司的關係等基本資訊。
   3. 過程中也可能會被要求設定帳號安全，並在最後檢查所有資料、補齊缺漏後才能啟用收款。

      <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FCxblpqdR90CYPdOLAgG0%2Fimage.png?alt=media&amp;token=b3a2fc56-9358-450c-adc4-4ff97e8e2f05" alt=""><figcaption></figcaption></figure>
4. 帳號審核：對多數商家來說，送出申請後幾乎是即時核准，可以馬上開始收款；如果 Stripe 需要更多資料或預期審核會比較久，會主動聯繫客戶。

   需要特別注意的地方：

   * 國家選擇不可更改：帳號啟用後就不能更改國家，如果要在其他支援的國家使用 Stripe，必須另外建立新帳號。
   * 台灣商家不能直接註冊：Stripe 官方目前不支援台灣的直接商家帳號。常見做法是先成立其他國家的公司，再用該國企業帳戶收款後匯回台灣。

#### 設定 Webhook

1. 前往 <https://dashboard.stripe.com/webhooks> 或於頁面左下方找到「Developers」選單，並選取「Webhooks」。

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FQajRxRwn3VV9YmaNYHvV%2Fimage.png?alt=media&amp;token=24df4cf3-b632-430b-ab38-dfadf7788d55" alt=""><figcaption></figcaption></figure>
2. 選擇「Create an event destination」

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2F8M6QmkMD5c5VnlHwiPDa%2Fimage.png?alt=media&amp;token=013318f2-7cb7-4bac-bfde-2ababea50d67" alt=""><figcaption></figcaption></figure>
3. Event destination scope 請選擇「Your Account」
4. Payload style 請選擇「Snapshot」
5. API version 請選擇「2024-12-18.acacia」

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FEFuNpcrXiJXqVOwSWD1b%2Fimage.png?alt=media&amp;token=b13eaf99-cf77-4229-ba31-7a800b9bcdef" alt=""><figcaption></figcaption></figure>
6. Select events:
   * Checkout (All 4 events)

     <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FYlLBSVRISkPh1cluFPnG%2Fimage.png?alt=media&amp;token=71ae2efe-38de-4866-b7d4-57fe45df746f" alt=""><figcaption></figcaption></figure>
   * Charge (All 13 events)

     <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FTbR6GrqNz7hccQgLRYX3%2Fimage.png?alt=media&amp;token=431e735c-04e3-46a7-ad6e-1d2a3172613d" alt=""><figcaption></figcaption></figure>
7. Choose where you want to send events 請選擇「Webhook endpoint」

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FyHJUmknv0Jm69DAy9Ww0%2Fimage.png?alt=media&amp;token=deea0f5d-6a34-4946-a8d6-d5ab1aeabfb9" alt=""><figcaption></figcaption></figure>
8. Input the Endpoint URL: <https://payment-api.omnichat.ai/v1/webhook/stripe>

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FBvm2pVtDqKyHbQTREsPM%2Fimage.png?alt=media&amp;token=92f83b9f-6c22-443d-875b-df01fb1d47fd" alt=""><figcaption></figcaption></figure>
9. 取得 Signing secret: 點擊建好的 Webhook 找到 Signing secret

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FlZsyZgEfjbwozXMmXOgd%2Fimage.png?alt=media&amp;token=3895f0ad-7646-47d9-9707-28c62d3e9ab8" alt=""><figcaption></figcaption></figure>

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FzVMkPCP8hmQdACr1oBnR%2Fimage.png?alt=media&amp;token=d6285182-1c63-419b-9b00-ff5c61b3bc05" alt=""><figcaption></figcaption></figure>

#### 取得 API Secret Key

1. 前往 <https://dashboard.stripe.com/apikeys> 或於頁面左下方找到「Developers」選單，並選取「API Keys」。

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FaxR51urnyhR38kvoE57G%2Fimage.png?alt=media&amp;token=7692dff2-7902-45b6-9ed5-184ef13c3c1d" alt=""><figcaption></figcaption></figure>
2. 找到 Secret key

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2Fa29qkkoPjAJkE5f4uRI2%2Fimage.png?alt=media&amp;token=d282dd33-c8a4-4415-b65a-45c0b06e414f" alt=""><figcaption></figcaption></figure>

#### 完成 Omnichat 中的 Stripe 串接整合

1. 前往 Omnichat 後台 > Settings > App Integrations > Stripe，點擊「Integrate」

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FgKiyDCwt4HwuNoYLOZlf%2Fimage.png?alt=media&amp;token=b77d62f0-37fa-4a26-a1b8-8e11fed60e38" alt=""><figcaption></figcaption></figure>
2. 將前幾步驟所取得的「Secret key」以及「Signing secret」貼上並點選「Submit」

   <figure><img src="https://2493459343-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LaFmilpuDQ-f7VKjHCH%2Fuploads%2FXpbt2bBYY1SkcETVe7li%2Fimage.png?alt=media&amp;token=3933b16d-f4e1-4cf2-900d-ebc6ed10f194" alt=""><figcaption></figcaption></figure>
3. 系統會自動將資料送往 Stripe 檢查是否填寫正確，如串接完成，會跳出「Stripe 串接成功」提示；如提供資料有誤，會顯示「Stripe 串接失敗」，請檢查輸入的資料是否有問題。
