O-PLUX・不正チェッカー連携

目次

1.O-PLUX・不正チェッカー連携 概要
2.審査結果サンプル(ショップ管理ツール受注画面)
3.運用手順と注意点
 STEP1.お申込み手続き
 STEP2.O-PLUXアカウント発行
 STEP3.自由項目の登録
 STEP4.m:idの組み込み
 STEP5.初期設定の登録
 STEP6.準備完了
4.運用中のポイント


1.O-PLUX・不正チェッカー連携 概要

O-PLUX・不正チェッカー連携とは

「O-PLUX・不正チェッカー」は、かっこ株式会社様が提供する不正注文検知サービスです。
サービス内容は下記公式HPをご覧ください。

O-PLUX
不正チェッカー

ご利用にあたり、弊社へのオプション申し込みの他、かっこ株式会社様への利用申し込み手続きが必要です。

・O-PLUX・不正チェッカー、いずれのサービスをご利用いただいても、下記でご案内するebisumart上の導入手順や
 設定項目名は同一で、項目名や関連初期設定名もO-PLUX表記となりますのでご注意ください。
 不正チェッカーは、審査結果理由やかっこ株式会社様側での提供サービス内容がO-PLUXと異なります。

クレジットカード以外の各種決済を「O-PLUX」または「不正チェッカー」の審査対象とする場合は、
 審査対象とする決済および審査モデルについて、かっこ株式会社様との事前確認および申し込み手続きが必要です。



2.審査結果サンプル(ショップ管理ツール受注画面)

商品購入完了のタイミングで、自動でO-PLUX・不正チェッカーの審査を実行します。

主な機能の説明

■O-PLUX・不正チェッカー審査結果
 OK・NG・REVIEWのいずれかを審査結果として表示します。(不正チェッカーの場合はOK・NGのみ)
■O-PLUX・不正チェッカールール説明文
 審査結果に対する理由(発動したルールの情報)を表示します。※発動したルールがない場合は非表示


3.運用手順と注意点

STEP1. お申込み手続き

インターファクトリーへの申込み
本オプション利用の申し込みの旨を、弊社担当営業またはサポート窓口までご連絡ください。

かっこ株式会社様への申込み
「O-PLUX」「不正チェッカー」の利用申し込みの旨を、かっこ株式会社様にご連絡ください。ご利用規約への同意や申込書のご提出が必要です。



STEP2. O-PLUXアカウント発行

かっこ株式会社様から、O-PLUX・不正チェッカーのアカウントが発行されます。(お申込みから3~5営業日想定)



STEP3. 自由項目の登録

O-PLUX・不正チェッカーとの連携に必要な項目を、ショップ管理ツール上で設定します。 「受注ヘッダ」の自由項目を12個登録します。
下記内容で自由項目を登録してください。「利用フラグ」は全項目「利用する」にしてください。



追加する自由項目一覧
No. 項目名 概要
1 O-PLUXイベントID O-PLUX・不正チェッカーでイベントを一意にするキー情報
2 O-PLUX決済ステータス 決済の状況
3 O-PLUX審査結果 O-PLUX・不正チェッカー自動審査結果
4 目視審査結果 O-PLUX・不正チェッカー自動審査結果NG、HOLD、REVIEW(再判定結果NG)に対して店舗管理者の
目視審査時のコード
5 目視審査結果メモ O-PLUX・不正チェッカー自動審査結果NG、HOLD、REVIEW(再判定結果NG)に対して店舗管理者の
目視審査時のメモ
6 O-PLUXブラックフラグ O-PLUX・不正チェッカー自動審査結果NG、HOLD、REVIEW(再判定結果NG)に対して店舗管理者が
目視審査してブラックになった場合フラグをON設定
7 O-PLUX処理結果 リトライのための仕組み(O-PLUX・不正チェッカー連携エラー、メンテナンス時を想定)
8 ブラウザ情報 注文時のデバイス情報
9 IPアドレス 注文者のIPアドレス
10 O-PLUXルール説明文 O-PLUX・不正チェッカー審査結果の理由説明文
11 O-PLUXエラーメッセージ O-PLUX・不正チェッカー処理結果が「審査エラー」、または「更新エラー」の場合のエラーメッセージ
12 API連携再連携区分 手動再連携時、エラーとなった元処理の区分


1. O-PLUXイベントID
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
O-PLUXイベントID※O-PLUX・不正チェッカー連携側の識別IDラベル(表示のみ)----何もしない半角500検索表示
2. O-PLUX決済ステータス
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
O-PLUX決済ステータス-ラベル(表示のみ)----何もしない全角10検索表示
3. O-PLUX審査結果
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
O-PLUX審査結果-ラベル(表示のみ)----何もしない半角10検索表示
4. 目視審査結果
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
目視審査結果-プルダウン:選択してください,
10:OK,
20:NG,
30:HOLD
---何もしない半角10検索表示
5. 目視審査結果メモ
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
目視審査結果メモ-一行テキスト-150--何もしない全角200検索表示
6. O-PLUXブラックフラグ
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
O-PLUXブラックフラグ-プルダウン:選択してください,
1:ブラック,
0:ブラックではない
---何もしない半角10検索表示
7. O-PLUX処理結果
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
O-PLUX処理結果-ラベル(表示のみ)----何もしない全角10検索表示
8. ブラウザ情報
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
ブラウザ情報-ラベル(表示のみ)----何もしない全角3000検索非表示
9. IPアドレス
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
IPアドレス-ラベル(表示のみ)----何もしない半角120検索非表示
10. O-PLUXルール説明文
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
O-PLUXルール説明文-ラベル(表示のみ)----何もしない全角1500検索表示
11. O-PLUXエラーメッセージ
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
O-PLUXエラーメッセージ-ラベル(表示のみ)----何もしない全角200検索表示
12. API連携再連携区分
画面表示名画面コメント項目入力形式項目選択肢テキスト項目横幅テキスト項目縦幅項目大文字変換項目入力モード属性最大文字数検索非表示設定
API連携再連携区分-ラベル(表示のみ)----何もしない全角2検索非表示


自由項目の表示について
カート画面の標準テンプレートには、ユーザーウェブ上に受注ヘッダの自由項目1~20を表示する記述があります。
そのため標準テンプレートの記述を利用している場合、O-PLUX・不正チェッカーとの連携に必要な項目については
自由項目1~20の使用を避けていただく等、ユーザーウェブ上に項目が表示されないようご注意ください。



自由項目の個数について
標準範囲での最大個数は50個です。
空きがない場合、弊社サポート窓口までお知らせください。
自由項目の個数追加には費用がかかる可能性がございます。予めご了承ください。



登録手順について
「STEP5. 初期設定の登録」を行う前に、必ず本項「STEP3. 自由項目の登録」を行ってください。



STEP4. m:idの組み込み

該当テンプレートにO-PLUX・不正チェッカーを利用するためのm:idを組み込みます。

(1)ブラウザ情報を取得するためのJavaScriptを、bodyの開始タグの直下に追加する。

対象テンプレート
view/userweb/cart_index.xhtml
view/smartphone/cart_index.xhtml


(2)ブラウザ情報を取得するためのJavaScriptを、formの開始タグの直下に追加する。

対象テンプレート
view/userweb/cart_login.xhtml
view/smartphone/cart_login.xhtml


(3)ブラウザ情報を取得するためのJavaScriptを、formの開始タグの直下に追加する。

対象テンプレート
view/userweb/cart_confirm.xhtml
view/smartphone/cart_confirm.xhtml


別精算ページオプションと併用する場合、別精算ページ用のテンプレート(cart_confirm$xxx.xhtml)にも同様に追加してください。


(4)ブラウザ情報を取得するためのJavaScriptを、formの開始タグの直下に追加する。

対象テンプレート
view/userweb/member_input.xhtml
view/smartphone/member_input.xhtml


弊社で組み込み作業を行う場合、別途費用が発生します。


「STEP4」までの設定完了後、弊社にて設定の切り替えが必要となります。
「STEP4」の設定完了後、弊社サポートまでご一報くださいますようお願いいたします。



STEP5. 初期設定の登録

O-PLUX・不正チェッカーとの連携に必要な項目を、ショップ管理ツール上で設定します。
審査対象とする決済により、設定が必要な初期設定は変わります。

クレジットカード以外の各種決済を「O-PLUX」または「不正チェッカー」の審査対象とする場合のご注意
クレジットカード以外の各種決済を「O-PLUX」または「不正チェッカー」の審査対象とする場合は、
かっこ株式会社様へ以下の情報をご確認の上、弊社へお知らせください。
また該当する初期設定については、弊社にて設定を行います。

【必要となる情報】
・審査対象とする決済
・審査モデルID
・O-PLUX決済コード
・後払い決済ID

【該当する初期設定】
O-PLUX 非クレジットカード決済有効化フラグ
O-PLUX 連携決済マッピング
O-PLUX 審査モデルマッピング
O-PLUX 後払い決済ID
O-PLUX 定期受注審査方式



No.項目設定内容
1加盟店ID申し込み後にかっこ社から発行
2O-PLUXシークレット
アクセスキー
申し込み後にかっこ社から発行
3O-PLUX接続元ID申し込み後にかっこ社から発行
4O-PLUXイベント登録API
リクエストURL
デモ環境:
https://api.tst.o-plux.com/v2/event
本番環境:
https://api.o-plux.com/v2/event
5O-PLUX氏名正規化API
リクエストURL
デモ環境:
https://staging-name-normalizer.o-plux.com
本番環境:
https://name-normalizer.o-plux.com
6O-PLUXイベント更新API
リクエストURL
デモ環境:
https://api.tst.o-plux.com/v2/event
本番環境:
https://api.o-plux.com/v2/event
7O-PLUX連携項目下記の「O-PLUX連携項目」を参照
8O-PLUX商品情報制御イベント登録APIで連携する「加盟店商品ID」として使用する項目を選択します。

・商品ID
・商品コード
・購入時の商品属性コード
9O-PLUX受注OUT制御受注の審査結果によって、受注データ連携OUTを行うかを制御します。

・制御しない
・制御する(自動審査NG,自動審査REVIEW,目視審査NG,目視審査HOLD)
・制御する(自動審査NG,目視審査NG,目視審査HOLD)
10 O-PLUX 非クレジットカード
決済有効化フラグ
クレジットカード以外の決済による受注に対して、
O-PLUX・不正チェッカー連携を有効とする場合に設定します。
11 O-PLUX 連携決済マッピング O-PLUX・不正チェッカー連携を有効とする決済を設定します。
上記10.O-PLUX 非クレジットカード決済有効化フラグを「利用する」に設定した場合に
必要となる初期設定です。
12 O-PLUX 審査モデルマッピング O-PLUX・不正チェッカー連携を有効とする決済の審査モデルを設定します。
上記10.O-PLUX 非クレジットカード決済有効化フラグを「利用する」に設定した場合に
必要となる初期設定です。
13 O-PLUX 後払い決済ID O-PLUX・不正チェッカー連携を有効とする決済のうち、
「後払い決済」として取り扱う決済を設定します。
上記10.O-PLUX 非クレジットカード決済有効化フラグを「利用する」に設定した場合に
必要となる初期設定です。

※O-PLUX・不正チェッカー連携を有効とする決済に
 「後払い決済」が存在しない場合は、設定不要です。
14 O-PLUX 定期受注審査方式 O-PLUX・不正チェッカー連携を有効とする定期受注の審査方式を設定します。
以下の条件に合致した場合に必要となる初期設定です。

・上記10.O-PLUX 非クレジットカード決済有効化フラグを「利用する」に設定している
定期販売オプションを利用している


O-PLUX連携項目

 登録した自由項目(受注ヘッダ)の番号をカンマ区切りで12個指定します。

 例)ORDER_H のFREE_ITEM1からFREE_ITEM12に登録をした場合
  「1,2,3,4,5,6,7,8,9,10,11,12」を、初期設定「O-PLUX連携項目」に入力する。



STEP6. 準備完了

STEP5までの対応が完了すると、O-PLUX・不正チェッカーが稼働します。
審査結果のサンプルは審査結果サンプルをご参照ください。



4.運用中のポイント

任意の受注に対して、目視審査結果のステータスを登録する

受注変更画面「O-PLUX審査結果(OK/NG/REVIEW)」に対して、店舗管理者にて目視審査した結果を
「目視審査結果(OK/NG/HOLD)」に設定し、更新を行ってください。
目視審査結果の理由や特記事項については「目視審査結果メモ」に記載することが可能です。

受注変更画面にて値を変更し、受注更新を行うことでO-PLUX・不正チェッカー側へ連携されます。


任意の受注に対して、ブラックフラグを登録する

「O-PLUXブラックフラグ」は、「O-PLUX審査結果(OK/NG/REVIEW)」の内容にかかわらず、
受注登録時には未設定の状態となります。
店舗管理者にて判断した結果を、「O-PLUXブラックフラグ」に設定し、更新を行ってください。

「O-PLUXブラックフラグ」にて設定する値は以下の通りです。
ブラック:ブラック登録をする(次回審査からは NG 判定)
ブラックではない:ブラック登録解除(次回から通常審査)

受注変更画面にて値を変更し、受注更新を行うことでO-PLUX・不正チェッカー側へ連携されます。


任意の受注に対して、O-PLUX手動再連携を行う

API連携にてエラー・タイムアウトになった受注に対して、受注変更画面にてO-PLUX・不正チェッカー手動再連携が可能です。
「O-PLUX処理結果」が「審査エラー」または「更新エラー」となっている受注が、O-PLUX・不正チェッカー手動再連携の対象となります。

受注変更確認画面にて「更新」ボタンを押下することで、O-PLUXのAPI再連携を行います。