BTCPay の決済画面でステーブルコインを。

インストール

1. ダウンロード BTCPayServer.Plugins.WhollyCrypto.btcpay し、リリースの次の情報と照合してください： SHA256SUMS。GitHub のソース ZIP ではなく、プラグインファイルを使ってください。
2. BTCPay 管理者として開く画面： プラグイン管理 → プラグインのアップロードでファイルをアップロードし、BTCPay を再起動します。
3. ストア → プラグイン → Wholly Crypto を選びます。 インストールだけではストアは接続されません。

更新も同じアップロード手順です。Wholly 加盟店ソフトウェアを更新しても BTCPay プラグインは更新されません。

ストアを接続

1. Wholly で有効なプロジェクトとストアを作り、決済方法、バックアップ済みウォレット、レート、承認数を設定します。現行の加盟店環境を使ってください。このコネクターは 6.4.5 API を対象としています。
2. プロジェクトとストアの UUID のコピー元： ストア → 基本 → API ID。プロジェクト限定の読み書き API 認証情報を作成します。有効にする項目： ストア → IPN 。その署名用シークレットをコピーしてください。Webhook シークレットではありません。
3. BTCPay の Wholly 設定にこれらの値と API・決済画面のオリジンを入力します。例： https://api.example.com と https://pay.example.com。ポート 443 の公開 HTTPS を使い、パスは付けません。
4. 有効化 決済画面で Wholly Crypto を提供、保存してから 読み取りアクセスをテスト。必要に応じてストアの決済方法の一部だけを選べます。

両方のファイアウォールで、Wholly サーバーから BTCPay への HTTPS コールバックを許可します。URL はプラグインが用意します。その経路ではブラウザーログイン、CAPTCHA、Basic Auth を使わず、署名検証は必ず有効にしてください。

埋め込み決済画面

標準は全画面の決済で、特にモバイルウォレットアプリに便利です。iframe を使う場合：

1. Wholly の設定先： ストア → 詳細で有効にする項目： 決済画面の埋め込みを許可。BTCPay の正確な HTTPS オリジンを追加する欄： 許可する HTTPS オリジン。パスやワイルドカードは付けません。
2. BTCPay のプラグイン設定で選ぶ項目： 顧客の決済画面 → 埋め込み決済画面（iframe） を選んで保存します。
3. 新しい請求書で試してください。既存の請求書は元の表示モードを維持します。 全画面の決済を開く はフレームを読み込めない場合も同じ請求書で使えます。

ブラウザーのメッセージと戻りリンクは画面移動用で、支払いの証明にはなりません。

決済の流れを確認

テスト用ストアで少額かつ正の法定通貨請求書を作ります。選ぶ項目： ステーブルコインと暗号資産 · Wholly。決済画面、署名付き IPN、API 検証を承認完了まで確認してください。BTCPay で確定した請求書だけを基に、注文ごとに 1 回だけ処理します。

読み取りアクセスをテスト は請求書作成や IPN のテストではありません。使う画面： 接続 と 関連する支払い で安全なエラー情報、注文参照、支払いの確認ができます。