CIHWEB ／ JPYC対応ECサイト制作 ／ WooCommerce導入ガイド
WooCommerceに、
JPYCという支払い方法を。
WooCommerceにJPYC決済を追加する手順を、プラグインの設置、設定JSON、Webhook、ブロックチェックアウト、注文確認まで解説します。
対象：CIHWEB Stablecoin Checkout for WooCommerce 1.3.0の配布資料・設定項目。JPYC（Polygon）向けの手順です。 配布版によって画面名・対応条件が変わる場合があります。お手元の同梱説明書と、CIHWEBから案内された接続情報を優先してください。
1. WooCommerceにJPYC決済を導入する前に
まず、商品・税・送料・配送先の設定を済ませ、通常の注文ができるECサイトを用意します。JPYC決済プラグインは、既存ショップに支払い方法を追加するためのものです。
- ショップのバックアップと検証環境：ファイルとデータベースを保存し、利用中のカート・PHP・テーマ・決済拡張のバージョンを控えます。
- HTTPSのショップURL：公開するURLとCIHWEBに登録するURLをそろえます。検証用URLと本番URLは混同しないでください。
- CIHWEBの会員登録・接続申込み：会員登録後、マイページから案内を確認し、対象カートの配布ファイルと接続情報を準備します。ダウンロードと決済接続の手続きは別です。
- 受取先と接続情報：Shop ID、認証キー、受取ウォレット、利用するネットワーク・JPYCの種類を、発行された案内と照合します。認証キーや設定JSONは公開記事に貼り付けないでください。
会員登録から設定情報を受け取る流れは、JPYCセットアップ共通ガイドをご覧ください。
2. WooCommerce用JPYCプラグインの設置手順
- WooCommerceの基本設定を済ませる
商品・税・送料を設定し、通貨を日本円（JPY）にします。カートページと購入手続きページが割り当てられていることも確認します。 - 専用プラグインをインストールする
WordPressの「プラグイン → プラグインを追加 → プラグインのアップロード」から、WooCommerce向けに配布されたZIPを選び、インストール後に有効化します。 - 支払い設定を開く
「WooCommerce → 設定 → 決済」から「CIHWEB Checkout (JPYC)」を開きます。旧版と併用中の場合は、同じJPYC支払い方法を二重に表示させないよう確認します。 - 設定JSONと通知先をそろえる
発行されたJSONを設定欄に貼り付けて保存します。画面に表示されるWebhook URLを接続先の登録内容と照合し、JPYC決済を有効にします。
3. JPYC決済の接続設定
| 確認する項目 | 設定・確認のポイント |
|---|---|
| Shop configuration | 「Shop configuration (paste to set or replace)」へ発行済みJSONを貼り付けます。Shop ID・認証キー・ウォレットを任意の値へ書き換えず、更新時も新しいJSONを使用します。 |
| Enable / Title / Description | 決済を有効化し、購入者に表示する名称・説明を確認します。例：「JPYC決済」。利用ネットワークが伝わる説明を添えます。 |
| Mode（Test / Live） | CIHWEB側の登録モードと一致させます。Testを選ぶだけで、すべての環境で模擬決済が使えるとは限りません。発行されたテスト方法に従います。 |
| Webhook URL | 設定画面に表示されたURLを使用します。WordPressの設置階層やURL変更後は再確認してください。 |
| Debug log | 調査時に必要に応じて有効化します。「WooCommerce → ステータス → ログ」で、ログ名（source）cihweb-checkoutを確認できます。 |
Webhookは「決済結果をショップに知らせる通知先」です。購入者が戻るURLとは役割が違います。設定画面や発行された案内に記載された、そのショップ専用のURLを使ってください。
4. 公開前に確認する購入テスト
この版は、ブロック型と従来型のチェックアウトに対応する構成です。ただし、独自の購入画面やテーマを使っている場合は、実際の表示を確認します。WooCommerce公式：カート・チェックアウトのカスタマイズ
- 注文前の表示
購入者として商品をカートへ入れ、住所・配送方法を選択します。JPYCが表示され、送料・税を含む最終合計が正しいことを確認します。 - 決済画面への移動
JPYCを選んで注文し、決済側の注文情報・金額・ネットワーク・受取先を確認します。実送金を伴う確認は、担当者が案内された条件で行ってください。 - Webhook後の注文確認
管理画面で入金反映・注文メモ・購入者メールを確認します。戻りページを開いただけでは入金確定になりません。金額が一致しない注文は保留と注文メモを確認します。 - 中断・再試行も確認
支払い前の離脱や再試行で、未払い注文が誤って支払済みにならないか確認します。既存の銀行振込なども引き続き選べるか確認します。
接続確認の成功だけでは購入テストは完了しません。注文番号・支払金額・入金状態・購入者宛メールまで確認してから、一般のお客様向けに公開します。
5. JPYCが表示されない・入金が反映されないとき
| 確認する項目 | 設定・確認のポイント |
|---|---|
| チェックアウトに出ない | 有効化、JPY通貨、JSONの保存、チェックアウト方式、他の決済拡張との競合を順に確認します。 |
| 支払い後も保留になる | 戻りURLだけで判断せず、Webhook到達、署名検証エラー、金額不一致、注文メモとログを確認します。 |
| 旧版から切り替えたい | 検証環境で新しい決済方法を確認してから、旧版の停止と通知先の切替を行います。未払い注文の扱いも確認してください。 |
解決しない場合は、CIHWEBへお問い合わせください。カートとプラグインのバージョン、発生日時、注文番号、エラー文を添えると確認が進みます。認証キー・設定JSON全文・購入者の個人情報は、公開コメントやスクリーンショットに含めないでください。
6. WooCommerce × JPYC決済のよくある質問
ブロックチェックアウトで使えますか？
1.3.0の配布版にはブロック型と従来型向けの実装があります。テーマやチェックアウト拡張を含めた購入テストが必要です。
USDCも使えますか？
このガイドの対象版はJPYC（Polygon）向けです。他の通貨・ネットワークへ設定を流用せず、対応状況をお問い合わせください。
WordPress.orgのCIHWEBカートを入れればよいですか？
別製品です。WooCommerceへの決済追加には、WooCommerce向けのCIHWEB Stablecoin Checkoutを使用します。
導入料金と、設定を依頼したい方へ
JPYC決済の接続には、対象プランへのお申込みが必要です。接続料金・利用料・適用条件は、管理画面と連動する最新の料金案内をご確認ください。ECサイト制作や個別の設置代行は、作業内容に応じてご案内します。
JPYC決済の料金を見るECサイト制作・カートを比較するほかのECカートでJPYC決済を使う
少数の商品やブログから始めたい場合
CIHWEBカートは、記事や販売ページから購入につなげる別の選択肢です。CIHWEB Anywhere CartのWordPress.org公式配布ページもご覧いただけます。この配布ページはCIHWEBカート用であり、上記4カート向けの決済プラグインとは別製品です。