この内容は完了です：海外の顧客がチェックアウトページで PayPal または国際クレジットカードで支払えるようにします。
両者とも新台湾ドル（TWD）で受け取ります。顧客が支払う際、PayPal／Stripe が顧客の通貨に換算します。国内のクレジットカード、ATM、コンビニコードについては 金流と請求書の設定方法 をご覧ください；海外の送料については 国際配送地域の送料の設定方法 をご覧ください。
どちらを選ぶか
| PayPal | Stripe（国際クレジットカード） | |
|---|---|---|
| 誰が申請できるか | 台湾の企業または個人が PayPal ビジネスアカウントを申請できます。 | Stripe がサポートする国に登録された企業のみ（例：アメリカ、日本、シンガポール、香港）。台湾の企業は現在申請できません。 |
| 顧客の支払い方法 | PayPal アカウントの残高またはリンクされたクレジットカードを使用します。 | Visa、Mastercard、AMEX などのクレジットカードを直接入力します。アカウントは必要ありません。 |
| チェックアウトページに表示される内容 | PayPal | 国際クレジットカード |
台湾の企業の場合は、PayPal または国内の決済（Green World、Neweb、PAYUNi）のクレジットカードを使用してください。両者を同時に開くことができ、チェックアウトページにはそれぞれのオプションが表示されます。
前提条件です
- ショップオンライン購入を開設し、プラットフォームが国際オンライン決済を開通している必要があります。未開通の場合、決済タブの PayPal、Stripe は「プラットフォーム未開通」と表示されますので、プラットフォームにお問い合わせください。
- 鍵とSecretの項目は管理者（所有者）のみが編集できます。 項目が見えない場合や保存できない場合は、管理者アカウントを使用してください。
- PayPalのビジネスアカウントまたはStripeアカウントを申請済みです。絶対に鍵をチャットソフトや他の公開場所に貼らないでください。
パス
ショップ → ショップ設定 → 決済 タブ（/admin/commerce/store）。
下にスクロールして PayPal（国際決済） または Stripe（国際クレジットカード） カードを見つけ、設定が完了したら下部の保存ボタンを押してください。
PayPalの設定
- PayPal（国際決済） のスイッチをオンにします。
- 環境 はまず Sandbox（テスト） を選択します。
- PayPal Developer Dashboard → Apps & Credentials でRESTアプリを作成し、Client ID と Client Secret を対応する項目に貼り付けます。サンドボックスと本番環境の証明書は異なります。
- 下部の保存を押してください。カードに Webhook URL が表示されます。
- PayPalアプリの Webhooks に戻り、このURLを追加し、カードに表示されているイベント（Checkout order approved、Payment capture completed／pending／denied／declined／refunded）を購読してください。
- PayPalに表示される Webhook ID をカードに貼り付けて、再度保存してください。
Client ID、Client Secret、Webhook ID の三項目がすべて入力されている場合のみ、チェックアウトページに PayPal が表示されます。
Stripeの設定
- Stripe（国際クレジットカード） のスイッチをオンにしてください。カードの最上部にある黄色のヒントが再度申請条件をお知らせします。
- 環境 は Sandbox（テスト） を選択してください。
- Stripe Dashboard → Developers → API keys に移動し、Secret key をコピーして Secret Key に貼り付けてください。テスト環境のキーは
sk_test_で始まり、正式環境はsk_live_で始まります。また、制限付きの Restricted key（rk_で始まる）を使用することもできます。 - 下部の保存を押してください。カードに Webhook URL が表示されます。
- Stripe Dashboard → Developers → Webhooks に移動し、エンドポイントを追加します。この Webhook URL を貼り付け、カードに表示されている4つのイベントを選択してください：
checkout.session.completed、checkout.session.async_payment_succeeded、checkout.session.async_payment_failed、refund.created。 - そのエンドポイントページで Reveal を押して Signing secret（
whsec_で始まる）を取得し、Webhook Signing Secret に貼り付けて、再度保存してください。
Secret Key と Webhook Signing Secret が正しく入力され、かつキーと環境が一致している場合のみ、チェックアウトページに「国際信用カード」が表示されます。
保存時にシステムがチェックします：
- キーと環境が一致しない場合（例えば、環境を正式に選択しているのに
sk_test_を貼り付けた場合）は保存できません。その後、環境を正式に変更する場合は、同時にsk_live_キーに変更してください。 - Signing secret が
whsec_で始まらない場合は保存できません。
顧客はどのように支払いますか
- 顧客はチェックアウトページで PayPal または 国際クレジットカード を選択し、注文を送信します。
- ページは PayPal または Stripe の支払いページに遷移します。
- 支払いが完了した後、注文完了ページに戻り、注文が支払い済みになります。
顧客が支払いページで戻るを押すか、ウィンドウを閉じた場合、料金は請求されず、注文は未払いのまま保持されます。
テスト（必ず行ってください）
- 両方の環境はまず Sandbox を使用します。
- PayPal は PayPal サンドボックスのバイヤーアカウントで支払い；Stripe は Stripe のドキュメントに提供されたテストカード番号で支払いを行います。
- バックエンドの 注文 は支払い済みに変わり、イベント記録には支払い成功が記録されます。
- 確認が完了したら、環境を Production に変更し、正式な証明書に切り替えます（Stripe の Webhook も正式環境で再度追加する必要があり、Signing secret は異なります）。次に、小額の実際の注文を検証します。
返金
注文 に移動し、その注文を開いて返金機能を使用します。全額または部分的に返金でき、複数回に分けて返金することも可能で、合計は支払金額を超えないようにしてください。返金は直接 PayPal／Stripe に送信されます；クレジットカードの返金は通常、数営業日かかって顧客のアカウントに戻ります。
PayPal または Stripe の管理画面で自分で返金を行った場合、注文のイベント記録に「金流後台返金通知」が追加され、照合が容易になります。
サポートされていない状況
- POS レジの支払いリンクでは PayPal または Stripe は使用されません。
- ショッピングカートに冷凍または冷蔵商品がある場合、PAYUNi のみで支払いが可能で、PayPal または国際クレジットカードは表示されません。
よくある問題
| 状況 | どうする |
|---|---|
| 結帳ページに PayPal がない | スイッチがオフ、保存されていない、または Client ID／Client Secret／Webhook ID が欠けている。 |
| 結帳ページに国際クレジットカードがない | スイッチがオフ、保存されていない、Signing secret が未入力、または鍵と環境が一致しない。 |
| 保存時に「Stripe Secret Key と環境が一致しない」と表示される | テスト環境では sk_test_／rk_test_、本番環境では sk_live_／rk_live_ を使用する。 |
| 支払い後、注文がずっと待機中 | Webhook が追加されていない、URL が間違っている、またはテスト環境で作成した Webhook を本番環境で使用している。 |
| 台湾の会社が Stripe を申請したい | 現在申請できません。PayPal または国内の決済のクレジットカードを使用してください。 |