Professional Documents
Culture Documents
(2.13 系)
s
導入・設定マニュアル
加盟店様用
Ver.1.2
2023 年 1 月 16 日
改訂履歴
バージョン 公開日付 改訂内容
1.0 2021/11/22 初版
1.1 2022/11/14 サービス名称変更による修正「クロネコペイ」→「クロネコ クレカ払い」
2
目次
改訂履歴................................................................................................................................. 2
第 0 章 本マニュアルについて .......................................................................................................... 4
第 1 章 はじめに ........................................................................................................................ 5
1.事前にご用意いただく書類 ...................................................................................................... 5
2.ご留意事項 ...................................................................................................................... 5
(1)EC-CUBE モジュール全体のご留意事項 ...................................................................................... 5
(2)クロネコ クレカ払いご利用上のご留意事項 .................................................................................... 6
3.モジュール機能 ................................................................................................................... 7
第 2 章 モジュール導入設定 .......................................................................................................... 8
1.モジュールのダウンロード .......................................................................................................... 8
(1)モジュール購入 ................................................................................................................... 8
2.クロネコwebコレクト初期設定 ............................................................................................... 9
(1)クロネコwebコレクト初期設定(webコレクト管理画面における作業) ................................................ 9
(2)警報について ................................................................................................................... 12
3.EC-CUBE モジュール クロネコ クレカ払い設定............................................................................. 13
4.支払い方法設定 .............................................................................................................. 15
5.配送方法の設定(支払方法のひも付け設定) ............................................................................ 16
(1)支払方法の紐づけ設定 ....................................................................................................... 16
第 3 章 受注操作方法 .............................................................................................................. 17
1.出荷情報登録................................................................................................................. 18
(1)ヤマト配送の場合 .............................................................................................................. 18
(2)他社配送の場合............................................................................................................... 19
2.金額変更 ...................................................................................................................... 20
3.決済取消し .................................................................................................................... 21
第 4 章 疎通テスト ................................................................................................................... 22
1.クロネコ クレカ払い疎通テスト方法........................................................................................... 22
2.本番実装 ...................................................................................................................... 24
【付録①】よくあるご質問 .............................................................................................................. 25
【付録②】各種お問い合わせ先 ....................................................................................................... 26
3
本マニュアルについて
第00章章本マニュアルについて
第
■ごあいさつ
このたびは、ネット総合決済サービス「クロネコwebコレクト」をご利用いただき、誠にありがとうございます。ご使用の前に、この導入
マニュアルをお読みいただき、正しくお使いください。お読みになった後は、いつでも見られるよう大切にお手元に保管してください。
■用語について
◇webコレクト ・・・ ネット総合決済「クロネコwebコレクト」を示します。
◇クロネコ クレカ払い ・・・ クロネコ クレカ払いはクロネコwebコレクトの契約があるショップ様が利用できる ID 決済です。
◇EC-CUBE ・・・ EC-CUBE 本体を示します。
◇EC-CUBE モジュール ・・・ クロネコ クレカ払い決済モジュール 2.13 系 を示します。
◇ご利用の手引き ・・・ ネット総合決済「クロネコwebコレクト」ご利用の手引きを示します。
◇GIP ・・・ グローバル IP アドレスを示します。
◇ ・・・ 特に注意していただきたい点を示します。
◇ ・・・ 操作・設定を誤った場合、運用上に障害が発生することが想定されることを示します。
◇ ・・・ 知っていると役に立つ操作を示します。
■マニュアルの使い方
①導入・設定マニュアル(本書)
●ご利用開始のための初期設定
●設定方法
モジュール導入~疎通テスト
●受注操作方法
●よくある質問
②ネット総合決済サービス 「クロネコwebコレクト」ご利用の手引き
●webコレクトに関する詳細
マニュアル
※ 基本的には本書をご利用ください。
本書で解決できない内容につきまして
は、ご利用の手引きをご確認ください。
③EC-CUBE 開発コミュニティ(http://xoops.ec-cube.net/)
●EC-CUBE に関するご質問、ご要望、ご意見投稿用のコミュニティ。
4
第1章
第 はじめに
1 章 はじめに
1.事前にご用意いただく書類
・クロネコwebコレクト登録完了書(加盟店様へメール・郵送または、弊社営業担当より直接お渡ししております)
2.ご留意事項
(1)EC-CUBE モジュール全体のご留意事項
①対応バージョン
②動作環境について
③モジュールインストールについて
インストールの際、レンタルサーバーの仕様によっては、新規作成フォルダのパーミッションが読取り専用になるケースがあります。
その場合、パーミッションの設定が別途必要です。
④ECCUBE をルートディレクトリとは別のディレクトリに設置している場合の対応
上記の場合、InternetExplorer 向けの遷移用画面(※)のパスが正しく指定できません。
「location.origin + "/kuronekopayblank.html"」が成り立つように html ファイルを移動してください。
※InternetExplorer 向けの遷移用画面について
メンバーズ画面へのログイン実行時に、InternetExplorer のみ加盟店様 EC サイトアプリケーションサーバを経由します。
その場合、購入者様の端末のスペックに依存しますが、購入者様が EC サイトで規定された「404 not found」エラー画面を
視認する可能性があるため、対処方法として EC-CUBE モジュールでは遷移用画面を経由画面のパス「location.origin +
"/kuronekopayblank.html"」にて配備します。これによって「404 not found」エラー画面表示を回避することが可能です。
⑤文字コードについて
5
(2)クロネコ クレカ払いご利用上のご留意事項
①サーバについて
②売上確定について
クロネコ クレカ払いでは、与信承認済みの受注に送り状番号を登録、出荷情報が反映する事で売上確定を行います。
出荷情報登録をされないと売上確定とはなりませんのでご注意ください。
※ ヤマト運輸以外の配送会社をご利用の加盟店様は別途「ヤマトグループ外運送サービス」をお申込ください。
※ 出荷情報と送り状番号をマッチングさせ売上確定を行うのはヤマト運輸で登録された受注のみです。
③与信情報について
与信情報の保持期間は 30 日間となります。
30 日以内に出荷情報登録処理を行わないと与信情報は削除されますのでご注意ください。
なお、「クロネコwebコレクト」管理画面における警報設定により最大 60 日まで与信情報の保持が可能です。
④メンテナンスについて
下記メンテナンス中は決済できませんのでご了承ください。
※メンテナンス実施日を含む各種お知らせはお申込の際ご記入いただく「ご担当者メールアドレス」宛へお送りいたします。
⑤手数料について
クレジットカード払いの場合、売上確定していただくと、サービス手数料が発生します。返品になった場合も、決済金額に応じたサービス
手数料を申し受けます。
⑥推奨環境について
クロネコwebコレクトの推奨環境については
コチラ( https://business.kuronekoyamato.co.jp/service/lineup/payment/flow_creditcard/requirements/ )
をご確認ください。
6
3.モジュール機能
本モジュールの機能は以下の通りです。
■支払方法
クロネコ クレカ払い決済
■決済機能
・決済取消
・金額変更
・出荷情報登録(ヤマト/他社)
商品については以下をご参照ください。
▼クロネコ クレカ払い
https://business.kuronekoyamato.co.jp/service/lineup/payment/id/
7
第第22
章章モジュール導入設定
モジュール導入設定
1.モジュールのダウンロード
(1)モジュール購入
①お使いのインターネットブラウザにて「EC-CUBE オーナーズストア」にアクセスします。
「クロネコ クレカ払い決済モジュール(2.13 系)」を無料購入いただけます。
②モジュール購入手続きについては株式会社イーシーキューブ(旧ロックオン)が公開しているマニュアルを参考に行ってください。
下記マニュアルに沿って、「認証キーの設定」、「モジュールのダウンロード」、「モジュールの有効化」を完了させてください。
▼EC-CUBE2 系 モジュール購入ガイド
https://www.ec-cube.net/document/MN02_module_install.pdf
※株式会社イーシーキューブが公開しているマニュアルの内容についてご質問をいただいても弊社カスタマーサポートセンターにてサポートは行っておりません。
▼競合回避用修正パッチ
https://ap3.salesforce.com/sfc/p/10000000arVY/a/5F000000HUA5/DgbwyZSXKzwYtHcOOfvU6CGFzxRl8_T55YHd0CRfPiI
8
2.クロネコwebコレクト初期設定
(1)クロネコwebコレクト初期設定(webコレクト管理画面における作業)
❶
ヤマト運輸㈱の HP にある
「ログイン一覧」>「決済」をクリック
(https://business.kuronekoyamato.co.jp/)
❷
クロネコ web コレクトのテキストボックス
に、登録完了書に記載の URL 末尾 2~7 桁
を入力して「入力後にログイン」をクリック
❸
クロネコ web コレクト管理画面のログイン
ページが表示されるので、以下を入力して
ログインします。
■加盟店コード
登録完了書に記載の「加盟店コード」
■ユーザ ID
「加盟店コード」と同じ数字
■パスワード
登録完了書に記載の「アクセスパスワード」
■ワンタイムパスワード
初回ログイン時は入力不要
9
❹初回ログイン後、2 回目以降のログイン用に
「任意パスワードの設定」 「ワンタイムパスワードの設定」 「子ユーザの設定」 が必要です。
以下のいずれかの設定方法を参照し、設定を完了してください。
https://business.kuro https://www.youtube.
nekoyamato.co.jp/logi com/watch?v=nmyhU
n/shoki_settei/ 22FESs
必ず 「子ユーザの設定」 まで完了させてください。
設定が完了していなければ、次のステップに進めません。
❺
「加盟店情報設定」をクリックして、
次のページに記載の設定を行ってください。
10
ご利用開始日 *必須*
決済手段ごとの利用開始日を入力してください。
入力しなければ、決済が利用できずエラーとなります。
メール署名設定 *必須*
購入者さま向けのメールに記載される、加盟店さまの
ご連絡先を設定してください。
・ご利用ショッピングカート:
入力不要
・グローバル IP:EC-CUBE2.13 系
クロネコ web コレクトへアクセスする際
のリクエスト元となるサーバーの IP アド
レスを入力してください
最低限必要な設定は以上の3点です。
(ご利用開始日、メール署名設定、接続方式情報)
他の項目などの設定については、
P.10 の YouTube 動画やご利用の手引きを
参照し設定をお願いします。
❻
画面最下部にある「確認」をクリック
し、内容に問題がなければ「確定」を
クリックして完了です。
11
(2)警報について
お支払い手続きが行われていない等の理由から、決済不能になってしまう可能性がある受注を警報として表示いたします。管理画面で
は各警報情報の発生タイミングを設定できます。
❷
③ 確認画面で内容に誤りがなければ「確定」をクリックして完了です
警報発生から 30 日間のみ、クレジットカードの与信が保持されます。
そのまま警報を放置すると、与信保持期間が切れて
受注が無効になる可能性がございます。
12
3.EC-CUBE モジュール クロネコ クレカ払い設定
①モジュール一覧画面からクロネコヤマト クレジットカード決済モジュールの「設定」をクリックしてください。
②下記のとおりモジュールの設定を行ってください。
クロネコwebコレクト加盟店コード
登録完了書に記載している加盟店コードを入力してく
ださい。 ※記載場所は本書 P.9 参照
テンプレート初期化 ファイルのコピー
初回導入時とモジュールのアップデート時はチェックを
入れてください。
テンプレートの初期化・・・決済画面のデザインテンプレー
トを初期化します。※デザインテンプレートは、EC-CUBE
モジュールの設定時に、自動的に EC-CUBE のデザイン管
理に追加されます。
ファイルのコピー・・・設定内容の登録時に記載のファイル
が上書きされます。
アクセスキー
登録完了書に記載しているアクセスキーを入力してくだ
さい。 ※記載場所は本書 P.9 参照
カート画面ボタン設定
カラーと位置を設定してください。
他社配送設定
ヤマト運輸以外の配送サービスを併用する場合は「他
社配送」を選択してください。※別途運送サービス拡大申
込(無料)が必要です。
ヤマトを選択した場合
ヤマトグループで発送した荷物の送り状番号を登録し、出荷登録を行う。
出荷情報登録時は登録した伝票番号が API で連携されます。
他社配送を選択した場合
送り状番号の登録は任意です。出荷情報登録時は受付番号が API で連携されます。
13
ログイン・会員登録必須
購入時に会員登録を必須とする機能です。利用したい場合は「オン」にしてください。
■グローバス IP アドレス
の「こちら」をクリックすると web コレクトと通信する際のお客様側サーバのアクセス元 GIP が表
示されます。
web コレクトに疎通する際は以下の GIP が登録されている必要があります。
登録を行っていない場合は P.11 を参照して登録してください。
111.22.3.44
最後に画面最下部の → をクリックして登録してください。
14
4.支払い方法設定
ここでは各支払い方法の設定について説明します。
① 「クロネコ クレカ払い」の行の「編集」をクリックしてください。
② 下記のとおり支払い方法の設定を行ってください。
支払方法
ここで設定した支払方法名称が購入時決済選択画面に表示されます。後ほど変更することもできます。
利用条件(円)
設定可能な金額は「1 円から 300,000 円」までです。
※取り扱い上限金額の変更申請をしている場合、設定可能な金額は「1 円から 999,999 円まで」です。
支払種別
決済画面で選択する支払回数を設定します。
複数回払いを設定しても、ヤマト運輸からの精算は一括で入金されます。
本人認証サービス(3D セキュア)
本人認証サービス(3D セキュア)は「利用する」にチェックすることを推奨します。
3D セキュアを「利用にしない」とした場合には、ご購入者様のクレジットカードが 3D セキュアに対応しているカード利用でも
本人認証ではなく、セキュリティコード認証を行います。その場合はチャージバック対象となる為、商品発送時にはお名前などの確認を
行い、不正利用でないかを確認の上、発送ください。
最後に画面最下部の をクリックして登録してください。
15
5.配送方法の設定(支払方法のひも付け設定)
ここでは配送方法の設定について説明します。
をクリックして「配送方法設定」画面を開いてください。
(1)支払方法の紐づけ設定
各配送方法を選んだ際に、選択できる支払い方法を設定します。
①設定したい配送方法の「編集」をクリックし、「配送方法登録」画面を開きます。
②「取扱方法設定」でこの配送に利用できる支払い方法を選択します。
配送業者名に設定した名称が実際の購入手続きの画面に反映します。
最後に画面最下部の をクリックしてください。
とウィンドウが表示されたら をクリックして設定を登録してください。
16
第
第33章章受注操作方法
受注操作方法
クレジットカード受注の決済操作は受注管理画面および、各受注の詳細画面にて行います。
各受注の【編集】をクリックすると受注の詳細情報が表示されます。
「取引状況」と「対応状況」それぞれのステータスは以下の状況を示しています。
17
1.出荷情報登録
クロネコ クレカ払いの注文の売上確定を行います。この作業を行わないと決済は完了しませんので必ず行ってください。
他社配送を含む運用を行う場合は(2)他社配送の場合を実施してください。
(1)ヤマト配送の場合
事前注意事項
EC-CUBE モジュールのモジュール設定画面にて「他社配送設定:ヤマト」となっていることを確認の上実施ください。
①受注編集画面内の「送り状番号」欄に登録し、「受注情報を登録」をクリックしてください。
※実際に発送するヤマト運輸の送り状番号を登録する必要があります。
②決済操作メニューの をクリックし、さらに をクリックしてください。
③EC-CUBE 管理画面受注管理画面では取引状況が「精算確定待ち」へ変われば完了です。
18
(2)他社配送の場合
事前注意事項
EC-CUBE モジュールのモジュール設定画面にて「他社配送設定:他社配送」となっていることを確認の上実施ください。
①受注管理画面を開きます。
出荷情報登録を行う受注を選択し、「出荷登録」をクリックします。
出荷時登録欄が「-」に変われば正常に処理が完了しています。
19
2.金額変更
金額変更できるのは売上確定後 90 日後までです。
②「受注商品情報」欄にて商品金額の変更を行い をクリックし、お支払合計が修正されることを確認してください。
りんご
③最後に画面最下部の → をクリックして登録してください。
④変更後の金額を登録すると ボタンが表示されるので、このボタンをクリックします。
⑤決済金額が変更されたら金額変更処理の完了となります。
ボタンをクリックしないと
決済システム側へ連携されませんのでご注意ください。
EC-CUBE 管理画面から金額変更した場合
金額変更のお知らせメールは送信されません。
メールを送信したい場合はご自身でメールテンプレート
を作成しメールを送信してください。
20
3.決済取消し
受注取消できるのは売上確定後 90 日後までです。
②ネット総合決済サービス決済情報欄にある をクリックしてください。
ステータスが「取引状況:取消」と「対応状況:キャンセル」に変わります。
21
第
第44章章疎通テスト
疎通テスト
この章では疎通テストのやり方についてご説明します。モジュールの全ての設定が完了しましたら下記のテストを実施してください。
1.クロネコ クレカ払い疎通テスト方法
テスト環境をご利用する場合、テスト環境のお申込が必要です。
クロネコ web コレクト加盟店管理画面のログイン画面にある
テスト環境の申込
「テスト環境の申込」から申し込んでください。
テスト環境管理画面ログイン情報は「クロネコwebコレクトテスト環境利用登録完了のお知らせ」
メール内に記載しています。
▼テスト環境管理画面ログイン画面
https://ptwebcollect.jp/test_gateway/manageOrderDataLogout.do
※メールを紛失した場合は≪導入サポート≫までお問合せください。
ご連絡先:link-support@kuronekoyamato.co.jp
①モジュールをテスト環境に設定します。
②ショッピングサイト購入画面から、商品をカートに入れてテスト購入を行います。
③クロネコメンバーズログイン部分について、エミュレータを用意しています。
「クロネコID」を選択し、紐付けるクレジットカード番号をご入力ください。
「クロネコID」項目にはクロネコメンバーズの代表的な登録パターンを用意しています。
登録パターンは次ページをご参照ください。
「紐付けるクレジットカード」項目には、選択した「クロネコID」に紐付けるクレジットカード番号を入力してださい。
入力するカード番号は下記ダミーカードから選択してください。
テスト環境では以下のダミーカードを使用し、テスト購入を行ってください。
③購入テスト後、EC-CUBE 管理画面で受注一覧を確認し、注文が追加されることを確認してください。
この時 EC-CUBE 対応状況が「新規受付」となっていることを確認してください。
④EC-CUBE にて出荷情報登録を行い、テスト環境管理画面へ送り状番号が反映しているか確認してください。
※テスト環境管理画面上には決済方式欄に「トークン方式」と表示されますが、
EC-CUBE 上で「クロネコ クレカ払い」と表示されていたら問題ございません。
22
■クロネコメンバーズ登録パターン
未設定項目については NULL が返却されます。
黒猫 黒猫 黒猫最大桁十五文字一二三 黒猫 ㈱黒猫
3 氏名姓
四五六
onekoyamato.co.jp p
丁目 目 桁数確認用市区群町村字丁 四丁目
目12345678990
19 市区郡町村字丁目
123456789012
345678901234
5678901234
21 建物名 ン1 桁30文字確認12345
678901
23
2.本番実装
①モジュールを本番環境に設定します。
②EC-CUBE の各種設定を実施します。
③EC-CUBE フロント画面から商品を購入していただき、問題なく利用できることを確認してください。
④購入テスト後、EC-CUBE 管理画面で受注一覧を確認し、対応状況が変更されることを確認してください。
24
【付録①】 よくあるご質問
【付録①】よくあるご質問
EC-CUBE モジュールの機能が正常に動きません。どうしたらいいですか?
カスタマイズの実施や他のプラグイン・モジュールを導入している場合競合し、正常に動作しない可能性があります。
今回の事象が、その影響を受けている可能性がございますため、お手数ですが、一度他のプラグイン・モジュールを無効にして
いただき正常に動作するか、ご確認をお願いいたします。
クレジットカード決済画面で「チェックサム不正」と表示されます。なぜですか?
アクセスキーの設定が誤っている可能性があります。プラグイン・モジュールの設定をご確認ください。
アクセスキーは登録完了書に記載されているものをご入力ください。
取引情報と支払方法が不明な状態と表示される受注があります。なにが原因ですか?
他のモジュールやプラグインと競合している場合に発生することがあります。他のモジュールやプラグインは無効にしてください。
サーバ移行のためグローバル IP アドレスが変更になります。変更の申請は必要ですか?
25
【付録②】各種お問い合わせ先
【付録②】 各種お問い合わせ先
カスタマイズを実施している場合や他モジュール・プラグインを導入されている場合、お問合せいただいてもサポートできかねます。
ご了承ください。EC-CUBE 開発コミュニティ等をご利用いただき、ご自身にてご確認をお願い致します。
オープンソースの為、公式のサポートはございません。
EC-CUBE
EC-CUBE 提供元が公開する資料等をご確認ください。
に関するお問合わせ
(商品登録・配送設定等基本
設定や運用方法など) EC-CUBE 開発コミュニティ : https://xoops.ec-cube.net/
ヤマトビジネスメンバーズ サポートセンター
(受付時間 平日 8:00~20:00、土日祝 9:00~18:00)年中無休
B2 クラウドに関する
お問い合わせ
TEL :0120-23-8010
ヤマト運輸株式会社
精算内容、
お客様管理画面
① FAQ サイト :https://faq-biz.kuronekoyamato.co.jp/
に関するお問い合わせ
② お問い合わせフォーム :お客様管理画面にログイン後の「お問合せ」ボタンから
お荷物の配送状況 ① お問い合わせフォーム :
に関するお問い合わせ https://faq.kuronekoyamato.co.jp/app/ask?refname=contact
② スマホ・携帯から TEL :0570-200-000(通話料有料)
③ 固定電話から TEL :0120-01-9625
26