如何設定國際付款（PayPal、Stripe）

先選哪一個

前提

• 已開電商線上購買，且平台已開通國際線上金流。沒開通時金流分頁的 PayPal、Stripe 會顯示「平台未開通」，請聯繫平台。
• 金鑰、Secret 類欄位僅站長（擁有者）可編輯。 看不到欄位或無法儲存時，請用站長帳號。
• 已申請好 PayPal 商家帳戶或 Stripe 帳戶。不要把金鑰貼到聊天軟體或其他公開處。

路徑

設定 PayPal

1. 打開 PayPal（國際付款） 開關。
2. 環境 先選 Sandbox（測試）。
3. 到 PayPal Developer Dashboard → Apps & Credentials 建立 REST App，把 Client ID 與 Client Secret 貼到對應欄位。沙盒與正式環境的憑證不同。
4. 按底部儲存。卡片上會出現 Webhook URL。
5. 回到 PayPal App 的 Webhooks，新增這個網址，並訂閱卡片上列出的事件（Checkout order approved、Payment capture completed／pending／denied／declined／refunded）。
6. 把 PayPal 顯示的 Webhook ID 貼回卡片，再儲存一次。

設定 Stripe

1. 打開 Stripe（國際信用卡） 開關。卡片最上方的黃色提示會再提醒一次申請條件。
2. 環境 先選 Sandbox（測試）。
3. 到 Stripe Dashboard → Developers → API keys 複製 Secret key，貼到 Secret Key。測試環境的金鑰以 sk_test_ 開頭，正式環境以 sk_live_ 開頭；也可以用權限受限的 Restricted key（rk_ 開頭）。
4. 按底部儲存。卡片上會出現 Webhook URL。
5. 到 Stripe Dashboard → Developers → Webhooks 新增端點，網址貼上這個 Webhook URL，並勾選卡片上列出的四個事件：checkout.session.completed、checkout.session.async_payment_succeeded、checkout.session.async_payment_failed、refund.created。
6. 在該端點頁面按 Reveal 取得 Signing secret（whsec_ 開頭），貼到 Webhook Signing Secret，再儲存一次。

• 金鑰和環境不符（例如環境選正式卻貼 sk_test_）時無法儲存。之後若要把環境改成正式，請同時換上 sk_live_ 金鑰。
• Signing secret 不是 whsec_ 開頭時無法儲存。

顧客怎麼付款

1. 顧客在結帳頁選 PayPal 或 國際信用卡，送出訂單。
2. 頁面會導到 PayPal 或 Stripe 的付款頁。
3. 付款完成後回到訂單完成頁，訂單變成已付款。

測試（務必做）

1. 兩者環境都先用 Sandbox。
2. PayPal 用 PayPal 沙盒買家帳號付款；Stripe 用 Stripe 文件提供的測試卡號付款。
3. 後台 訂單 應變為已付款，事件紀錄有付款成功。
4. 確認無誤後，環境改 Production 並換上正式憑證（Stripe 的 Webhook 也要在正式環境另外新增一次，Signing secret 會不同），再下一筆小額真實單驗證。

退款

不支援的情況

• POS 收銀的付款連結不會使用 PayPal 或 Stripe。
• 購物車有冷凍、冷藏商品時，只能用 PAYUNi 付款，不會出現 PayPal 或國際信用卡。

常見卡住

相關說明

• 如何設定金流與發票
• 如何設定國際配送地區運費
• 如何處理訂單
• 成員與權限