# PrestaShop 連携

このドキュメントでは、BTCPay Server を PrestaShop ストアに連携する方法を説明します。
まだストアがない場合は、このステップバイステップの記事 (opens new window)に従ってゼロから作成してください。

既存の PrestaShop ストアに BTCPay Server を連携するには、以下の手順に従ってください。

TIP

このドキュメントはモジュールの最新 v6 バージョンにのみ適用されます。その他のバージョン:

# サーバー要件

このプラグインをインストールする前に、以下の要件を満たしていることを確認してください。

PHP 8.0 以上を使用している
PrestaShop が 8.0 以上である
- ストアで HTTPS が有効になっており、公開アクセス可能であること
BTCPay Server が 1.7.0 以上である
PHP 拡張の PDO、curl、gd、intl、json、mbstring が利用可能である
セルフホストまたはサードパーティホストの BTCPay Server を用意している
- BTCPay Server インスタンスで HTTPS が有効になっており、公開アクセス可能であること
インスタンスに登録済みアカウントがある
インスタンスに BTCPay ストアがある
ストアにウォレットが接続されている

Prestashop の BTCPay Server モジュールは、あなたのサーバー（決済プロセッサ）と EC ストアをつなぐブリッジです。
手順 2 でセルフホストかサードパーティホストのどちらを選んでも、設定手順は同じです。

BTCPay Server URL フィールドにホストの完全 URL（https を含む）を入力します。例: https://testnet.demo.btcpayserver.org
デフォルトのトランザクション速度を選択します（BTCPay が推奨する手数料額に影響します）。
任意: ストアに適した注文モード（支払い前に注文作成 / 支払い後に注文作成）を選択します。
- この項目は、該当ロジックが削除された v5.1.0 以前を使用している場合のみ関係します。
記帳用途のために、顧客メタデータを BTCPay Server インスタンスへ送信するかどうかを選択します。
Connect を押して設定を保存し、BTCPay Server インスタンスへリダイレクトして API キーを作成します。
API キー作成時は、必ず特定の 1 ストアに対して権限を付与してください（複数ストアは未対応です）。

Authorize app ボタンを押すと Prestashop ストアへ戻ります。"Invalid Token" ポップアップが出る場合は、PrestaShop と BTCPay Server の両方で HTTPS が有効で、正しいホスト名を使っているか確認してください（Server Requirements を参照）。

TIP

BTCPay Server からのリダイレクトは、PrestaShop 側の挙動により失敗することがあります。その場合でも、/account/apikeys から API キーをコピーしてフォームに貼り付ければ、このプラグインを利用できます。

必要に応じて、/account/addapikey で API キーを手動作成することもできます。手動で作成する場合は、単一のストアに対して次の権限を持つようにしてください。

BTCPay は世界中のボランティアコントリビューターによって構築・保守されています。新しい貢献を歓迎し、感謝しています。

貢献したい方は、プルリクエストを開く前に、まず issue を作成 (opens new window) するか、コミュニティチャット (opens new window) に参加してください。早い段階でフィードバックを得たり、最適な進め方を議論したり、作業重複を防げます。

PrestaShop のサポートは公式チャネルで提供されています。