SHOPWARE プラグイン

Shopware 5と6で暗号資産の支払いを受け付けよう。

ショップを自分の Wholly Crypto チェックアウトに接続しよう。お客さんがネットワークとトークンを選び、検証済みの通知で注文が更新されるよ。

Shopware 5

v1.0.0

Shopware 5.7.20+ (5.7.x) · PHP 7.4+ · HTTPS · InnoDB

MIT ライセンス · PHP SDK 同梱 · Composer の設定不要

Shopware 6

v1.0.0

Shopware 6.7 · PHP 8.2+ · HTTPS · InnoDB

MIT ライセンス · PHP SDK 同梱 · Composer の設定不要

インストール

インストールパッケージをダウンロードして SHA256SUMS を確認しよう。GitHub のソース ZIP は使わないでね。

Shopware 5

whollycrypto-shopware5-1.0.0.zip

Configuration → Plugin Manager → Installed → Upload plugin

Shopware 6

whollycrypto-shopware6-1.0.0.zip

Extensions → My extensions → Upload extension

プラグインをインストールして有効にしたら、サブショップや販売チャネルに合わせて設定を開いてください。

ショップの支払い方法でWholly Cryptoを有効にしてください。Shopware 6では販売チャネルへの割り当ても必要です。

ストアを接続

API とチェックアウトのオリジン、プロジェクトとストアの API UUID、プロジェクト限定の読み書き用 API 認証情報、ストアの IPN 署名シークレットを入力しよう。Wholly で IPN を有効にすれば、コールバック URL はプラグインが設定するよ。

言語やインストール先のサブディレクトリも含めて、ショップの公開HTTPS URLを入力してください。

IPNコールバックがCAPTCHAやブラウザのログインなしでファイアウォールを通れるようにしてください。公開前にテストショップで支払いを確認しましょう。

ウォレットのキーは Wholly Crypto に保管されるよ。プラグインによる追加の料率はないけど、処理クレジットのルールは引き続き適用されるよ。

決済の流れを確認

未確認や一部入金の支払いは保留のままだよ。一致する決済済みの支払いで、注文を一度だけ更新する。過払い、遅延、無効な支払いや変更された注文は確認が必要。ブラウザーで戻っただけでは支払いは確定しないよ。

請求書の詳細は、Shopware 5では注文の内部コメント、Shopware 6では注文のWholly Cryptoカスタムフィールドで確認できます。

届かなかった更新を確認

ショップのディレクトリでこのコマンドを実行すると、重複を作らずに保存済みの請求書を確認できます。5分ごとの定期実行も可能です。

php bin/console whollycrypto:reconcile --limit=50
制限と配信の問題

自動返金、定期引き落とし、注文ごとの分割支払い、埋め込み型の決済画面には対応していません。

クレジット不足で IPN が止まっても、お客さんは支払いを続けられるよ。クレジットを補充して、Wholly の配信履歴から失敗した通知を再送してね。

処理クレジットの仕組み → · IPN ガイド →