# Shopware 6 アプリを使用する

Shopware 6 ストアの決済管理、返金、トラブルシューティングについて学びましょう。

決済の管理、返金の処理、Shopware 6 の一般的な問題のトラブルシューティングを行い、EC 業務を円滑に進めましょう。

## 注文レベルでの決済情報

注文時、**Payments** タブには、Stripe の支払いに関する以下の詳細が表示されます。

- **説明**: 顧客のメールアドレス、顧客 ID、注文 ID を表示します。
- **支払いインテントのステータス**: 注文の支払いステータスを表示します。
- **決済手段**:支払いに使用される決済手段を識別します。
- **支払いのリスクスコア**: 支払いの不正利用リスクを評価します。
- **タイムライン**: 支払い中に発生した一連のイベントを表示します。

## 支払いをキャンセルする

支払いが未キャプチャーで、ステータスが**オーソリ済み**になっている場合は、その支払いをキャンセルできます。

- Shopware で注文のステータスを **オーソリ済み** から **キャンセル済み** に変更します
- Stripe ダッシュボードで注文内の**キャンセル**ボタンをクリックします。

## 注文を返金する

`Paid` ステータスの注文はすべて返金できます。

1. Shopware の管理画面から **Orders (注文)** > **Overview (概要)** を選択します。
1. 注文の支払いステータスを `Paid` から `Refunded` に変更します。

Shopware は一部返金に対応していません。`Refunded (partially)` または `Refunded` のいずれかのステータスを選択すると、全額返金されます。

## 失敗した Webhook 通知を解決する

同期はすべて私たちのシステムを介して行われるため、アプリはクライアント側でどの Webhook も作成しません。アプリに移行する前に、以前の Stripe プラグインで登録された古い Webhook をまだ保持している場合、*Webhook 失敗* の通知メールが届くことがあります。Webhook はアプリの機能を妨げません。

Webhook を無効にしてこれらのメールの受信を停止するには、以下の手順を実行します。

1. Workbench の[Webhooks](https://dashboard.stripe.com/webhooks)タブで、古い Webhook の URL をクリックします。
1. オーバーフローメニュー (⋯) をクリックし、**Delete** を選択します。
1. **Delete webhook** をクリックします。

## 同期の問題解決

Shopware は、ショップの同期に関連する以下の[既知の問題](https://developer.shopware.com/docs/guides/plugins/apps/app-base-guide.html#handling-the-migration-of-shops)を認識しています。

- ショップが新しいサーバーに移行するか、または URL を変更すると、登録時に保存した URL が無効になり、アプリからの接続が切断されることがあります。

- 稼働中の **PRODUCTION** ショップがそのデータベース全体を複製して **STAGING** 環境を作成した場合、両方の環境が同じ`shopId`を持っているため、データが破損する可能性があります。また、両方のショップから同じショップから来たように見える Webhook を受け取るかもしれません。

これらの問題は、**PRODUCTION** 環境に Stripe Payments for Shopware 6 App を再インストールすることで解決できます。この操作により、認証情報および、Stripe Payments for Shopware 6 App と **PRODUCTION** にある Shopware インスタンスの間の接続が更新されます。

新しいデータベースを使用してクリーンインストールを実行し、他の Shopware インスタンス (STAGING や DEV 環境など) が PRODUCTION 環境に干渉しないことを確認します。PRODUCTION 環境からインストールを複製しないでください。

新しいデータベースを使用できない場合は、`system_config table`から`core.app.shopId`行エントリを削除して、インストールされているすべてのアプリケーションの設定をリセットします。次に、Stripe Payments for Shopware 6 App を再インストールして、新しい ID と認証情報を確立します。

Stripe Payments for Shopware 6 App を再インストールするには、以下の手順に従います。

1. Shopware インスタンスで管理ページを開きます。
1. 左側のパネルで、**Extensions** > **My Extensions** に移動します。
1. **Stripe Payments for Shopware 6 App** のアクションダイアログを開くには、オーバーフローメニュー (⋯) をクリックします。
1. **Uninstall** をクリックします。
1. ページが更新されたら、**Install the App** をクリックします。