CIHWEB ／ JPYC対応ECサイト制作 ／ Welcart導入ガイド
WelcartのJPYC決済導入ガイド｜設定手順・購入テスト
Welcartのネットショップに、
JPYC決済を追加する。
WelcartのJPYC決済導入を、設定プラグインと決済モジュールの設置、JSON設定、支払い方法の有効化、購入テストまで順番に解説します。
対象：JPYC_GATEWAY_Welcart.zipとjpyc_cihpay.phpを含むCIH PAY for Welcart配布パッケージ。 配布版によって画面名・対応条件が変わる場合があります。お手元の同梱説明書と、CIHWEBから案内された接続情報を優先してください。
1. WelcartにJPYC決済を導入する前に
まず、商品・税・送料・配送先の設定を済ませ、通常の注文ができるECサイトを用意します。JPYC決済プラグインは、既存ショップに支払い方法を追加するためのものです。
- ショップのバックアップと検証環境：ファイルとデータベースを保存し、利用中のカート・PHP・テーマ・決済拡張のバージョンを控えます。
- HTTPSのショップURL：公開するURLとCIHWEBに登録するURLをそろえます。検証用URLと本番URLは混同しないでください。
- CIHWEBの会員登録・接続申込み：会員登録後、マイページから案内を確認し、対象カートの配布ファイルと接続情報を準備します。ダウンロードと決済接続の手続きは別です。
- 受取先と接続情報：Shop ID、認証キー、受取ウォレット、利用するネットワーク・JPYCの種類を、発行された案内と照合します。認証キーや設定JSONは公開記事に貼り付けないでください。
会員登録から設定情報を受け取る流れは、JPYCセットアップ共通ガイドをご覧ください。
2. Welcart用JPYCプラグインの設置手順
- 外側の配布ZIPを展開する
同梱の「JPYC_GATEWAY_Welcart.zip」「jpyc_cihpay.php」「README」を確認します。外側のセット一式と、WordPressにアップロードする内側のZIPを区別してください。 - 設定プラグインを有効化する
WordPressの「プラグイン → プラグインを追加 → アップロード」で、内側のJPYC_GATEWAY_Welcart.zipを選び、インストール・有効化します。内側のZIPは展開しません。 - Welcart決済モジュールを配置する
バックアップ後、管理権限のある担当者がSFTP等でjpyc_cihpay.phpを/wp-content/plugins/usc-e-shop/settlement/へ配置します。既存ファイルがある場合は対応版を確認してから更新します。 - JSONを保存する
WordPressの「設定 → CIH PAY」を開き、発行された設定JSONを貼り付けて「JSON から設定を保存」を実行します。 - Welcart側の支払い方法を確認する
配布版の案内に従い、Welcartのクレジット決済設定・支払方法設定でCIH PAYを有効にします。購入画面でJPYCを選択できることを確認します。
WordPressへのアップロード画面は画像付きインストール手順も参考にできます。Welcart本体の設定はWelcart公式マニュアルをご参照ください。
3. JPYC決済の接続設定
| 確認する項目 | 設定・確認のポイント |
|---|---|
| 設定JSON | { から } までをまとめて貼り付けます。Shop IDやshop_secretが欠けていないか確認してください。 |
| 認証キーとウォレット | 認証キー（shop_secret）とウォレットアドレスは別の値です。アドレスを認証キーとして入力しないでください。 |
| リレイヤー接続確認 | 保存後に接続確認を実行します。成功しても、Welcart注文への入金反映まで確認したことにはなりません。 |
| 決済モジュール | 設定プラグインだけでなく、settlementフォルダーのPHPファイルも必要です。Welcart更新後にも配置・互換性を確認します。 |
| Webhook / return_url | 発行済み設定に含まれる通知先・戻り先を確認します。別ショップや検証環境の情報を混ぜないでください。 |
Webhookは「決済結果をショップに知らせる通知先」です。購入者が戻るURLとは役割が違います。設定画面や発行された案内に記載された、そのショップ専用のURLを使ってください。
4. 公開前に確認する購入テスト
- 通常の商品で注文する
商品、配送先、送料を設定し、支払い方法にJPYCが表示されることを確認します。決済画面の合計とWelcartの合計を照合します。 - 案内された方法で決済を確認する
受取先・ネットワークを確認し、必要な送金操作は店舗の担当者が行います。途中離脱の場合に未入金のままになることも確認します。 - Welcartの受注画面で確認する
対象注文の入金状態と購入者への通知メールを確認します。接続成功表示や完了ページだけで、入金済みと判断しないでください。
接続確認の成功だけでは購入テストは完了しません。注文番号・支払金額・入金状態・購入者宛メールまで確認してから、一般のお客様向けに公開します。
5. JPYCが表示されない・入金が反映されないとき
| 確認する項目 | 設定・確認のポイント |
|---|---|
| ZIPをインストールできない | 外側の配布セットを選んでいないか確認し、内側のJPYC_GATEWAY_Welcart.zipを指定します。 |
| JPYCの支払方法が出ない | プラグイン有効化、settlementフォルダーのファイル配置、Welcartの支払方法設定を確認します。 |
| JSONの保存に失敗する | 波括弧を含むJSON全体をコピーし、全角引用符や説明文が混ざっていないか確認します。 |
| 更新後に決済できなくなった | Welcart本体の更新でモジュールが失われていないか、対応版が変わっていないか確認します。バックアップを基に担当者へ相談してください。 |
解決しない場合は、CIHWEBへお問い合わせください。カートとプラグインのバージョン、発生日時、注文番号、エラー文を添えると確認が進みます。認証キー・設定JSON全文・購入者の個人情報は、公開コメントやスクリーンショットに含めないでください。
6. Welcart × JPYC決済のよくある質問
プラグインを入れるだけで完了しますか？
この配布形式では、設定用プラグインとWelcart決済モジュールの両方が必要です。さらにWelcart側の支払方法設定と購入テストを行います。
FTPやSFTPが苦手でも導入できますか？
設置代行をご相談いただけます。サイト環境を確認し、必要な作業と費用をご案内します。
認証キーとウォレットアドレスは同じですか？
異なります。JSONの各項目をそのまま使い、手入力で入れ替えないでください。
導入料金と、設定を依頼したい方へ
JPYC決済の接続には、対象プランへのお申込みが必要です。接続料金・利用料・適用条件は、管理画面と連動する最新の料金案内をご確認ください。ECサイト制作や個別の設置代行は、作業内容に応じてご案内します。
JPYC決済の料金を見るECサイト制作・カートを比較するほかのECカートでJPYC決済を使う
少数の商品やブログから始めたい場合
CIHWEBカートは、記事や販売ページから購入につなげる別の選択肢です。CIHWEB Anywhere CartのWordPress.org公式配布ページもご覧いただけます。この配布ページはCIHWEBカート用であり、上記4カート向けの決済プラグインとは別製品です。