OricoPayment Plus Simple Web 開発ガイド OricoPayment Plus Simple Web 開発ガイド Ver. 1.0.5 （2016 年 6 月～） Copyright (c) 2013-2016 VeriTrans Inc., a Digital Garage company. All rights reserved. 1 OricoPayment Plus Simple Web 開発ガイド 目次 第1章 Simple Web 導入の前に .................................................................................................................................................................. 4 1-1 本ガイドの内容........................................................................................................................................................................................................................... 4 1-2 対象者 ............................................................................................................................................................................................................................................ 4 1-3 制限事項 ....................................................................................................................................................................................................................................... 4 1-4 著作権、および問い合わせ先 ............................................................................................................................................................................................. 5 1-5 改定履歴 ....................................................................................................................................................................................................................................... 5 第2章 Simple Web 概要 .................................................................................................................................................................................. 7 2-1 Simple Web で利用できる決済サービス .......................................................................................................................................................................... 7 2-2 サンプルプログラムについて ............................................................................................................................................................................................... 7 2-3 サンプルプログラム処理概要 .............................................................................................................................................................................................. 8 2-4 Simple Web で利用できる決済サービスの処理概要 ............................................................................................................................................... 10 2.4.1 クレジットカード決済 ............................................................................................................................................................................................................................. 10 2.4.2 クレジットカード決済（本人認証有り） ............................................................................................................................................................................................. 11 2.4.3 コンビニ決済............................................................................................................................................................................................................................................ 12 2.4.4 電子マネー決済 ..................................................................................................................................................................................................................................... 13 2.4.5 銀行決済................................................................................................................................................................................................................................................... 17 2.4.6 ショッピングクレジット決済 .................................................................................................................................................................................................................. 20 第3章 結果通知受信処理 ...........................................................................................................................................................................22 3-1 結果通知受信処理の対象 .................................................................................................................................................................................................. 22 3.1.1 Simple Web からの結果通知受信処理 ........................................................................................................................................................................................... 22 3.1.2 OricoPayment Plus からの結果通知受信処理............................................................................................................................................................................ 22 第4章 インターフェイス詳細 ........................................................................................................................................................................24 4-1 アクセス URL ............................................................................................................................................................................................................................. 24 4-2 要求・応答電文（カード/コンビニ/電子マネー/銀行） ............................................................................................................................................ 25 4.2.1 暗号鍵取得.............................................................................................................................................................................................................................................. 25 4.2.2 Simple Web 転送 ..................................................................................................................................................................................................................................... 30 4.2.3 決済結果照合 ......................................................................................................................................................................................................................................... 31 4.2.4 Simple Web からの結果通知電文..................................................................................................................................................................................................... 31 4.2.5 OricoPayment Plus からの結果通知電文 ..................................................................................................................................................................................... 33 4-3 要求・応答電文（ショッピングクレジット決済） ............................................................................................................................................................. 34 4.3.1 暗号鍵取得.............................................................................................................................................................................................................................................. 34 4.3.2 Simple Web 転送 ..................................................................................................................................................................................................................................... 37 4.3.3 決済結果照合 ......................................................................................................................................................................................................................................... 38 4.3.4 Simple Web からの結果通知電文..................................................................................................................................................................................................... 38 4.3.5 OricoPayment Plus からの結果通知電文 ..................................................................................................................................................................................... 39 第5章 その他補足事項 .................................................................................................................................................................................40 2 OricoPayment Plus Simple Web 開発ガイド 5-1 テスト実施にあたっての注意事項 ................................................................................................................................................................................... 40 5-2 MAP を利用したテスト取引の結果確認 ......................................................................................................................................................................... 41 3 OricoPayment Plus Simple Web 開発ガイド 第1章 Simple Web 導入の前に 1-1 本ガイドの内容 本ガイドは、加盟店様の EC サイトより（株）オリエントコーポレーション（以下、弊社）が提供する Simple Web へ接続し、利用する際 に参考となるサンプルプログラム、電文フォーマットなどについて記載しています。 1-2 対象者 本ガイドは、Simple Web へ接続し利用する加盟店様 EC サイトの開発者を対象としております。 タイトル 概要 Simple Web 加盟店様の EC サイトより Simple Web へ接続し、 開発ガイド 利用する方法について記載されています。 企画者 開発者 運用者 ◎ 表 1-2-1 ドキュメント一覧 1-3 制限事項 加盟店様の EC サイトより Simple Web へ接続し、利用するにあたり、以下制限がございます。 【消費者様環境】 消費者様がご利用いただける環境（ブラウザ）は以下となります。 （ご利用の環境によっては、正常に動作しない場合もございます。） ■ PC ・ Internet Explorer11 以上 ・ Microsoft Edge 最新安定版 ・ Google Chrome 最新安定版 ・ Mozilla Firefox 最新安定版 ・ Safari 最新安定版 ■ スマートフォン ・ 標準ブラウザ ■ フィーチャー・フォン ・i モード（docomo）、EZweb（au）、Yahoo!ケータイ（SoftBank）の SSL/TLS 通信対応従来型携帯電話 注） TLS1.1 以上の通信に未対応の端末をサポートする際は、4-1 を参照のうえ、適切な制御を行ってください。 【JavaScript】 消費者様が PC・スマートフォンをご利用の場合、Simple Web は画面遷移等に JavaScript を使用しておりますので、 JavaScript が OFF になっている Web ブラウザではご利用頂けません。 消費者様がフィーチャー・フォンをご利用の場合は、JavaScript を利用していない画面を表示致します。 【その他】 その他制限事項につきましては Simple Web 導入資料をご確認下さい。 4 OricoPayment Plus Simple Web 開発ガイド 1-4 著作権、および問い合わせ先 [著作権] 本ドキュメントの著作権はベリトランス株式会社が保有しています。 Copyright © 2016 VeriTrans Inc., a Digital Garage company. All rights reserved. [お問い合わせ先] ベリトランス株式会社 テクニカルサポート 電子メール： [email protected] 1-5 改定履歴 2013/08 ：Ver1.0.0 リリース VeriTrans3G VTWeb の OEM 版である OricoPayment Plus_Simple Web をリリース 2014/01 ：Ver.1.0.1 リリース 「第 4 章 インターフェイス詳細」に文字コードに関する記載を追記 「4-1 暗号鍵取得」の「⑤要求電文 ： EC サイト → Simple Web」の「SETTLEMENT_SUB_TYPE」について、ミニスト ップを"204"（その他）から"205"（イーコン）へ変更 「4-1 暗号鍵取得」の「 ⑤要求電文 ： EC サイト → Simple Web」の「MERCHANTHASH」の説明を追記 「4.2.1 暗号鍵取得」 の「No.1 暗号鍵取得 要求電文 ： EC サイト → Simple Web」の「会員番号（加盟店）」のフィ ールド名のスペルミスを修正 2014/11 ：Ver.1.0.2 リリース 「2-1 Simple Web で利用できる決済サービス」のクレジットカード決済の注意事項として、加盟店様の持つ 1 つのマー チャント ID に対して、クレジットカード会社が指定する加盟店番号は 1 つしか設定できない旨を追記 「2-1Simple Web で利用できる決済サービス」にフィーチャー・フォンが本人認証に対応していないことを追記 「表 2-4-1 Simple Web 導入時処理概要（クレジットカード決済）」、「表 2-4-3 Simple Web 導入時処理概要（コンビニ 決済）」、「表 2-4-4 Simple Web 導入時処理概要（電子マネー決済（PC Edy／PC Suica／PC WAON））」、「表 2-4-5 Simple Web 導入時処理概要（電子マネー決済（モバイル Edy／モバイル Suica））」、「表 2-4-6 Simple Web 導入時 処理概要（電子マネー決済（モバイル WAON））」、「表 2-4-7 Simple Web 導入時処理概要（銀行決済（ATM））」、 「表 2-4-8 Simple Web 導入時処理概要（銀行決済（ネットバンク・PC））」、「表 2-4-9 Simple Web 導入時処理概要 （銀行決済（ネットバンク・モバイル））」の「決済申込完了通知」の説明を修正 「2.4.2 クレジットカード決済(本人認証有り) 」の表下にフィーチャー・フォンが本人認証に対応していないことを追記 「表 2-4-10 Simple Web 導入時処理概要（ショッピングクレジット決済 ショッピングクレジット申込処理）」の「完了通 知」の説明を修正 「3.1.1 OricoPayment Plus からの結果通知受信処理」に結果通知電文の受信部分に関する記載を追記 「3.1.2 Simple Web からの結果通知受信処理」の説明を修正、また、決済結果通知受信部分に関する記載を追記 「4.1.1 暗号鍵取得」の「⑤要求電文 ： EC サイト → Simple Web」の表にて以下を追記 ・URL を追記 ・「FINISH_PAYMENT_ RETURN_URL」「UNFINISH_PAYMENT_RETURN_URL」 「ERROR_PAYMENT_RETURN_URL」の説明に URL パラメータ、およびアンカーの指定はできない旨を追記 ・「FINISH_PAYMENT_ACCESS_URL」の説明に URL パラメータの指定はできない旨を追記 ・「UNFINISH_PAYMENT_RETURN_URL」の説明を修正 「4.1.1 暗号鍵取得」の「⑤要求電文 ： EC サイト → Simple Web 」の表から「郵便番号」「住所 1～3」「生年月日」 「性別」を削除。また、【要求電文設定項目一覧】についても同項目を削除 サークル K サンクスの econ 仕向けに伴い、「4.1.1 暗号鍵取得」の「⑤要求電文 ： EC サイト → Simple Web 」の 「SETTLEMENT_SUB_TYPE」でコンビニ選択時の決済方法を修正 「4.1.1 暗号鍵取得」の「⑤要求電文 ： EC サイト → Simple Web 」の「MERCHANT_ID」､「CARD_CAPTURE_FLAG」、 「SHOP_NAME」、「SCREEN_TITLE」、「CONTENTS」、「CONTENTS_KANA」に説明を追加 「4.1.1 暗号鍵取得」の【要求電文設定項目一覧】の「TIMELIMIT_OF_PAYMENT」の「銀行」の欄を「□」から「◇」へ修 正 「4.1.1 暗号鍵取得」の「⑥応答電文 Simple Web-> EC サイト」に注釈として「マーチャント暗号鍵」が決済処理で使 用できないことを追記 「4.1.2 Simple Web 転送」の「⑨転送電文 ： EC サイト → 消費者ブラウザ」の表に URL を追記 「4.1.3 取引情報」の項目を削除、以下項番が繰り下がります。 「4.1.3 決済結果照合」に、戻り URL に関する記載を追記 「4.1.3 決済結果照合」の「⑭送信情報 ：消費者ブラウザ → EC サイト」の「mStatus」、「vResultCode」、「sessionId」 について設定欄を修正、設定の条件を説明欄に追記 「4.1.5 Simple Web からの結果通知電文」の「A) 結果通知電文の概要」の「結果通知受信処理結果について」の「決 5 OricoPayment Plus Simple Web 開発ガイド 済報告リトライ回数上限」を「決済結果通知リトライ回数上限」に修正 「4.1.5 Simple Web からの結果通知電文」の「B) 決済申込結果受信」に使用可能なフィールドに関する注意事項を追 記 「4.1.5 Simple Web からの結果通知電文」の「B) 決済申込結果受信」の「mErrMsg（エラーメッセージ）」の「説明」、「設 定」欄を修正 「4.1.5 Simple Web からの結果通知電文」の「B) 決済申込結果受信」の「⑪受信情報 ：Simple Web → EC サイト」 の表から「住所」「性別」「郵便番号」「誕生日」を削除 2015/07 ：Ver.1.0.3 リリース 「2-3 サンプルプログラム処理概要」⑥内の「EC サイト用暗号鍵」に「(以下、マーチャント暗号鍵)」を追加 「4.1.1 暗号鍵取得」の「⑤要求電文 ： EC サイト → VTWeb 」の表を修正 「4.1.1 暗号鍵取得」の「購入金額」に決済金額の上限と下限の説明を追加 「4.1.1 暗号鍵取得」の「支払期限」と「支払取消期限」に説明を追加 「4.2.1 暗号鍵取得」の「現金価格合計（税込）」に決済金額の上限と下限の説明を追加 「4.2.1 暗号鍵取得」 の「会員番号（加盟店）」のフィールド名のスペルミスを修正 2016/04 ：Ver.1.0.4 リリース 「1-3 制限事項」を修正 「結果通知」に関連する用語の統一 「2.4.2 クレジットカード決済（本人認証有り）」の「表 1-5-1 Simple Web 導入時処理概要（クレジットカード決済（本人 認証有り））の「5 決済申込」の処理説明を修正（本人認証不可の場合は、エラー画面に遷移する旨を記載） 「2.4.2 クレジットカード決済（本人認証有り）」の「図 2-4-2 Simple Web 利用時システム処理概要図（クレジットカード 決済（本人認証有り）」に「結果通知」のフローを追加 「2.4.4 電子マネー決済」の「図 2-4-4 Simple Web 利用時システム処理概要図（電子マネー決済（PC Edy／PC Suica／PC WAON））」を修正 「2.4.4 電子マネー決済」のモバイル WAON の※1 の説明内容を修正 結果通知の説明を分かりやすくするため、「OricoPayment Plus からの結果通知受信処理」の説明を、「Simple Web からの結果通知受信処理」の説明の後ろに移動 「4-1 アクセス URL」を追加（以降の章は項番が繰り下がります） 「4-1 Simple Web 共通」の章タイトルを、「4-2 要求・応答電文（カード/コンビニ/電子マネー/銀行）」に変更 「4.2.1 暗号鍵取得」の「⑤要求電文」の「CARD_NUMBER_OF_ INSTALLMENT（カード分割回数）」の説明を追記 「4.2.3 決済結果照合」の説明内容の見直しと、「⑭送信情報 ： 消費者ブラウザ → EC サイト」の表内の参照先を 修正 「4.2.4 3G-Web からの結果通知電文」の 「⑪受信情報」の「mErrMsg」の項目名を「メッセージ」に修正、また、「漢字 氏名」「カナ氏名」「メールアドレス」「電話番号」の説明欄を追記 「4-2 ショッピングクレジット決済」の章タイトルを、「4-3 要求・応答電文（ショッピングクレジット決済）」に変更 「4.3.1 暗号鍵取得」の「No.1 暗号鍵取得 要求電文」の「SESSION_ID」および「MERCHANTHASH（マーチャント生成 ハッシュ値）」の説明を追加 「4.2.2 取引情報」の章は不要のため削除 章タイトルを「4.3.3 決済結果照合」に修正し、説明内容を見直し （元のタイトルは決済結果受信電文） 「4.3.4 Simple Web からの結果通知電文」の「⑪受信情報」の表の体裁を、「4.2.4」に合わせて調整 「第 5 章 その他補足事項」を追加 2016/06 ：Ver.1.0.5 リリース 「4.2.1 暗号鍵取得」の「⑤要求電文」の「CARD_INSTALLMENT_JPO（カード支払区分）」と 「CARD_INSTALLMENT_JPO_CNT（カード分割回数）」を追記 6 OricoPayment Plus Simple Web 開発ガイド 第2章 Simple Web 概要 2-1 Simple Web で利用できる決済サービス 加盟店様は、弊社の提供するサンプルプログラムをカスタマイズして EC サイトへ導入する事により、弊社 Simple Web へ接続し、 下記の各種オンライン決済サービスを利用することができます。 決済サービス名 クレジットカード決済 説明 クレジットカードによる決済が利用できるサービスです。 各種ブランド、カード会社等発行のクレジットカードでのお支払いが可能です。※1 クレジットカード決済 本人認証（3-D Secure）機能付きのクレジットカード決済が利用できるサービスです。 （本人認証有り） 当社本人認証機能は、Visa/MasterCard/JCB の 3 つの国際カードブランドの本人 認証（3-D Secure）に対応しています。 ※ フィーチャー・フォンは本人認証に対応しておりません。フィーチャー・フォンでの アクセスの場合、通常のクレジットカード決済処理となります。 コンビニ決済 コンビニエンスストアにおける決済が利用できるサービスです。 セブンイレブン、ローソン、ファミリーマート、サークル K サンクス等の加盟店様でのお 支払いの申込が可能です。 電子マネー決済 電子マネーによる決済が利用できるサービスです。 楽天 Edy、Suica、WAON でのお支払いの申込が可能です。 銀行決済 銀行等の金融機関における決済が利用できるサービスです。 ATM（ペイジー）、ネットバンキングでの支払いの申込が可能です。 ショッピングクレジット決済※2 ショッピングクレジットによる決済が利用できるサービスです。 Orico Web クレジットでのお支払いの申込が可能です。 表 2-1-1 決済サービス一覧 ※1：加盟店様の持つ 1 つのマーチャント ID に対して、クレジットカード会社が指定する加盟店番号は 1 つしか設定できません。 ※2： Simple Web のサンプルプログラムにて提供するサービスは、ショッピングクレジット決済の申込までとなります。 審査結果通知は、OricoPayment Plus より送信いたします。 加盟店様によるショッピングクレジットの審査状況の確認、および出荷完了後の代金請求処理は Orico Web クレジットの管理画面 （Orico B’Plaza）より行います。 2-2 サンプルプログラムについて Simple Web では、加盟店様側より Simple Web へ接続し、利用する EC サイトの機能一式をサンプルプログラムとして提供しています。 サンプルプログラムは、画面などを加盟店様の EC サイトにあわせてカスタマイズいただき、ご利用いただくことが可能です。（カスタマイ ズは加盟店様にて実施していただきます） サンプルプログラムは Java、PHP 等複数言語別にご用意しています。 加盟店様はご契約の Simple Web のサービスにて決済を行うことができます。Simple Web のサービスは複数同時利用が可能です。 サンプルプログラムのインストールについては各言語別の【インストールガイド】をご参照ください。 7 OricoPayment Plus Simple Web 開発ガイド 2-3 サンプルプログラム処理概要 以下にサンプルプログラムの動作を図示します。 加盟店様サーバ （ECサイト） 消費者様 ① 購入商品 確認画面 ② 決済情報 入力画面 Click Click OricoPayment Plus SimpleWeb サーバ （SimpleWeb） マーチャント 情報 ④ ⑤ ③ 暗号鍵取得 暗号鍵作成 SimpleWeb 転送画面 遷移 ⑨ ⑥ ⑧ ⑦ 取引情報 ⑩ 決済 Click ⑬ ⑪ 決済結果 受信 ⑫ 取引情報 ⑮ ⑭ 処理結果 比較 ⑯ 結果比較 OK 結果 結果比較 NG 図 2-3-1 サンプルプログラム動作全体図 8 OricoPayment Plus Simple Web 開発ガイド 以下に「図 2-3-1 サンプルプログラム動作全体図」の説明を記載します。図中の番号と照らし合わせてご確認下さい。 ① 本画面（購入商品確認画面）は消費者様が購入する商品の選択を終了し、決済前の最終確認を行う画面を想定しています。 ② 手順①の画面で「購入決定」ボタンを押下すると、決済情報入力画面に遷移します。 ③ 決済情報入力画面で決済種別(支払方法)及び個人情報を入力しお支払方法を選択すると、「暗号鍵取得」の処理に移ります。 ※ここで消費者様に決済種別や個人情報を入力頂くか否かにつきましては導入前に加盟店様にて決定頂き、弊社にお知らせ下 さい。 ④ 「暗号鍵取得」では、設定ファイルに記載されているマーチャント ID、決済後の戻り先 URL などの情報を取得します。 ※設定ファイルにて定義する項目につきましては、【インストールガイド】を参照してください。 ※またこの段階で、EC サイトにて取引 ID を採番して頂きます。 ⑤ EC サイトから Simple Web に暗号鍵取得を要求します。送受信パラメータにつきましては「第 4 章 インターフェイス詳細」を参照し てください。 ⑥ EC サイトは Simple Web からの返戻として、消費者様用の暗号鍵（以下、ブラウザ暗号鍵）と EC サイト用暗号鍵(以下、マーチャン ト暗号鍵)を受信します。送受信パラメータにつきましては「第 4 章 インターフェイス詳細」を参照してください。 ⑦ EC サイトは取引 ID を取得キーとして、マーチャント暗号鍵を取引情報に保存します。取引情報に格納される項目につきましては 「第 4 章 インターフェイス詳細」を参照して下さい。 ※サンプルプログラムでは簡易性を重視して HashMap(Java)やテキストファイル(PHP)として保存していますが、実際の運用では Database 等に保存される事を推奨します。 ⑧ Simple Web 転送画面に決済結果受信情報を渡します。 ⑨ 消費者ブラウザは Simple Web 転送画面に遷移します。送受信パラメータにつきましては「第 4 章 インターフェイス詳細」を参照し てください。 ⑩ 消費者ブラウザは Simple Web 転送画面から Simple Web に遷移します。ここで手順⑧で渡されたパラメータは全て Simple Web に 渡されます。 遷移後、消費者様は Simple Web にて必要な情報を入力し、決済を行います。 ⑪ Simple Web は決済終了後、EC サイトへ決済結果を通知します。送受信パラメータにつきましては「第 4 章 インターフェイス詳細」 を参照して下さい。 ⑫ EC サイトは、受信した決済結果の取引 ID をキーとして取引情報から該当取引の情報を取得し、受信した決済結果情報を保存し ます。 ※図の都合上、別に記載してありますが、ここでの取引情報は手順⑦の取引情報と同じ情報です。 ⑬ Simple Web は消費者ブラウザへ決済結果を返戻します。この時返戻される決済結果情報は、手順⑪と同じ情報です。この情報 は手順⑮における比較で使用されます。 ⑭ 消費者ブラウザは EC サイトの戻り URL へ遷移します。この戻り URL は手順⑤で Simple Web に送信した URL となります。この時 手順⑬で Simple Web から渡されたパラメータは、そのまま全て渡されます。送受信パラメータにつきましては「第 4 章 インターフ ェイス詳細」を参照してください。 ⑮ EC サイトは、処理結果比較を行います。処理結果比較では、取引 ID をキーとして取引情報から該当取引の情報を取得し、渡さ れたパラメータの照合を行います。 ⑯ 処理結果比較の結果、問題なければ「比較結果 OK」を、問題があれば「比較結果 NG」を消費者ブラウザへ返戻します。 ※サンプルプログラムでは処理結果の比較のみを行っています。実際の運用では、必要に応じて「処理結果やエラーコードの値 による分岐」を発生させる等の処理を、加盟店様にて実装して頂く事が可能です。 9 OricoPayment Plus Simple Web 開発ガイド 2-4 Simple Web で利用できる決済サービスの処理概要 2.4.1 クレジットカード決済 クレジットカード決済の処理概要を下図に示します。 消費者 ブラウザ EC サイト Simple Web OricoPayment Plus 決済センタ 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 リダイレクト 先アクセス 暗号鍵 送信処理 2.暗号鍵送信 3.リダイレクト Simple Web URL要求 決済方法 選択画面表示 決済方法選択ページ送信 決済方法選択 ページ表示 4.申込情報入力 決済方法 確認画面表示 決済方法確認ページ送信 決済方法確認 ページ表示 5.決済申込 決済要求 決済要求 決済処理 決済完了 ページ表示 ECサイト 決済完了 ページ表示 PUSH 結果通知受信 決済応答 6.結果通知 決済処理 決済応答 決済処理 決済完了ページ送信 7.決済完了 ページ送信 決済確定部 図 2-4-1 Simple Web 利用時システム処理概要図（クレジットカード決済） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 6 結果通知 Simple Web は EC サイトへ結果通知を送信します。 ※結果通知は POST 形式で行われます。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 表 2-4-1 Simple Web 導入時処理概要（クレジットカード決済） 10 OricoPayment Plus Simple Web 開発ガイド 2.4.2 クレジットカード決済（本人認証有り） クレジットカード決済（本人認証有り）の処理概要を下図に示します。（※フィーチャー・フォンは本人認証に対応しておりません） 消費者 ブラウザ EC サイト SimpleWeb OricoPayment Plus DS/ACS カードセンタ 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 リダイレクト 先アクセス Simple Web URL要求 決済方法 選択画面表示 決済方法選択ページ送信 決済方法選択 ページ表示 4.申込情報入力 決済方法 確認画面表示 決済方法確認ページ送信 決済方法確認 ページ表示 暗号鍵 送信処理 2.暗号鍵送信 3.リダイレクト 5.決済申込 本人認証要求 決済申込処理 本人認証応答 リダイレクト リダイレクト 先アクセス 本人認証 本人認証 可否確認 請求応答 認証受付 ACS URLリダイレクト アクセス制御 認証ページ送信 ACS 認証 ページ表示 パスワード入力 認証処理 リダイレクト リダイレクト 先アクセス 認証結果検証 与信要求 決済要求 リダイレクト リダイレクト 先アクセス 与信受付 結果応答 決済完了 検索要求 検索処理 決済完了 ページ表示 PUSH 結果通知受信 検索応答 6.結果通知 結果検証処理 決済完了ページ送信 7.決済完了 決済確定部 ECサイト 決済完了 ページ表示 ページ送信 図 2-4-2 Simple Web 利用時システム処理概要図（クレジットカード決済（本人認証有り） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 本人認証可能の場合、消費者ブラウザは ACS 認証画面に遷移（リダイレクト）します。 本人認証不可の場合は、エラー画面に遷移します。 6 結果通知 Simple Web は EC サイトへ結果通知を POST 形式で送信します。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 表 2-4-2 Simple Web 導入時処理概要（クレジットカード決済（本人認証有り） 11 OricoPayment Plus Simple Web 開発ガイド 2.4.3 コンビニ決済 コンビニ決済の処理概要を下図に示します。 消費者 ブラウザ EC サイト SimpleWeb OricoPayment Plus 決済センタ 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 リダイレクト 先アクセス 暗号鍵 送信処理 2.暗号鍵送信 3.リダイレクト Simple Web URL要求 決済方法選択 ページ表示 決済方法選択ページ送信 決済方法確認 ページ表示 決済方法確認ページ送信 決済方法 選択画面表示 4.申込情報入力 決済方法 確認画面表示 5.決済申込 決済申込要求 決済要求 決済申込受付 PUSH 結果通知受信 決済申込完了 ページ表示 決済申込応答 決済応答 6.結果通知 決済受付 決済申込処理 決済申込完了ページ送信 7.決済申込完了 ECサイト 決済申込完了 ページ表示 ページ送信 決済申込確定部 入金 コンビニ店舗 入金処理 入金通知受信 PUSH 入金通知受信 入金通知 入金通知 8.入金通知 図 2-4-3 Simple Web 利用時システム処理概要図（コンビニ決済） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 6 結果通知 Simple Web は EC サイトへ結果通知を POST 形式で送信します。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 8 入金通知 OricoPayment Plus にて消費者様による入金が完了したと確認された取引については、EC サ イトへ入金通知を送信します。 ※入金通知は POST 形式で行われます。 表 2-4-3 Simple Web 導入時処理概要（コンビニ決済） 12 OricoPayment Plus Simple Web 開発ガイド 2.4.4 電子マネー決済 【電子マネー決済（PC Edy／PC Suica／PC WAON）】 電子マネー決済（PC Edy／PC Suica／PC WAON）の処理概要を下図に示します。 消費者 ブラウザ EC サイト SimpleWeb OricoPayment Plus 決済センタ 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 リダイレクト 先アクセス Simple Web URL要求 決済方法 選択画面表示 決済方法選択ページ送信 決済方法選択 ページ表示 4.申込情報入力 決済方法 確認画面表示 決済方法確認ページ送信 決済方法確認 ページ表示 暗号鍵 送信処理 2.暗号鍵送信 3.リダイレクト 5.決済申込 決済申込要求 決済要求 決済申込受付 PUSH 結果通知受信 6.結果通知 決済申込処理 決済申込応答 決済応答 決済受付 リダイレクト リダイレクト 先アクセス 入金画面表示要求 アクセス制御 ページ送信 決済センタ 入金 ページ表示 入金 リダイレクト リダイレクト 先アクセス 決済完了 ページ表示 決済完了 決済完了ページ送信 入金処理 入金通知受信 決済完了 画面表示 入金通知 7.決済完了 決済申込確定部 ECサイト 決済申込完了 ページ表示 ページ送信 PUSH 入金通知受信 入金通知 8.入金通知 図 2-4-4 Simple Web 利用時システム処理概要図（電子マネー決済（PC Edy／PC Suica／PC WAON）） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではなく、同 一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 決済申込の実行を行うと、消費者ブラウザは決済センタの入金画面に遷移（リダイレクト）します。 6 結果通知 Simple Web は EC サイトへ結果通知を POST 形式で送信します。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、EC サイトの完了画面へ遷移します。 8 入金通知 OricoPayment Plus にて消費者様による入金が完了したと確認された取引については、EC サイト へ入金通知を POST 形式で送信します。 表 2-4-4 Simple Web 導入時処理概要（電子マネー決済（PC Edy／PC Suica／PC WAON）） 13 OricoPayment Plus Simple Web 開発ガイド 【電子マネー決済（モバイル Edy／モバイル Suica）】 電子マネー決済（モバイル Edy／モバイル Suica）の処理概要を下図に示します。 消費者 ブラウザ EC サイト SimpleWeb 決済センタ 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 3.リダイレクト リダイレクト 先アクセス 2.暗号鍵送信 Simpls Web URL要求 決済方法選択 ページ表示 決済方法選択ページ送信 決済方法確認 ページ表示 決済方法確認ページ送信 暗号鍵 送信処理 決済方法 選択画面表示 4.申込情報入力 決済方法 確認画面表示 5.決済申込 決済申込要求 PUSH 結果通知受信 決済申込完了 ページ表示 OricoPayment Plus 6.結果通知 決済申込処理 決済申込応答 決済要求 決済申込受付 決済応答 決済受付 決済申込完了ページ送信 7.決済申込完了 ECサイト 決済申込完了 ページ表示 決済申込確定部 ページ送信 決済メール送信 決済メール送信 メール受信 アプリ起動 アクセス制御 決済センタ 入金 ページ表示 ページ送信 決済センタ 入金完了 ページ表示 ページ送信 入金 入金処理 入金通知受信 PUSH 入金通知受信 入金通知 入金通知 8.入金通知 図 2-4-5 Simple Web 利用時システム処理概要図（電子マネー決済（モバイル Edy／モバイル Suica）） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 6 結果通知 Simple Web は EC サイトへ POST 形式で結果通知を送信します。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 8 入金通知 OricoPayment Plus にて消費者様による入金が完了したと確認された取引については、EC サ イトへ POST 形式で入金通知を送信します。 表 2-4-5 Simple Web 導入時処理概要（電子マネー決済（モバイル Edy／モバイル Suica）） 14 OricoPayment Plus Simple Web 開発ガイド 【電子マネー決済（モバイル WAON）】 電子マネー決済（モバイル WAON）の処理概要を下図に示します。 消費者 ブラウザ EC サイト SimpleWeb 決済センタ 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 2.暗号鍵送信 3.リダイレクト リダイレクト 先アクセス Simple Web URL要求 決済方法選択 ページ表示 決済方法選択ページ送信 決済方法確認 ページ表示 決済方法確認ページ送信 暗号鍵 送信処理 決済方法 選択画面表示 4.申込情報入力 決済方法 確認画面表示 5.決済申込 決済申込要求 PUSH 結果通知受信 6.結果通知 決済申込応答 決済要求 決済申込受付 決済応答 決済受付 決済申込処理 決済メール送信 ※1 メール受信 決済申込完了 ページ表示 OricoPayment Plus 決済申込完了ページ送信 7.決済申込完了 ECサイト 決済申込完了 ページ表示 決済申込確定部 ページ送信 アプリ起動 メール確認 アクセス制御 決済センタ 入金 ページ表示 ページ送信 決済センタ 入金完了 ページ表示 ページ送信 入金 入金処理 入金通知受信 PUSH 入金通知受信 入金通知 入金通知 8.入金通知 図 2-4-6 Simple Web 利用時システム処理概要図（電子マネー決済（モバイル WAON）） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 6 結果通知 Simple Web は EC サイトへ POST 形式で結果通知を送信します。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 8 入金通知 OricoPayment Plus にて消費者様による入金が完了したと確認された取引については、EC サ イトへ POST 形式で入金通知を送信します。 表 2-4-6 Simple Web 導入時処理概要（電子マネー決済（モバイル WAON）） 15 OricoPayment Plus Simple Web 開発ガイド ※1：WAON 決済では、Simple Web より消費者様へ決済メールを送信します。（その他の電子マネー決済では、各決済事業者から直接 消費者にメールが送信されます。） 16 OricoPayment Plus Simple Web 開発ガイド 2.4.5 銀行決済 【銀行決済（ATM）】 銀行決済（ATM）の処理概要を下図に示します。 消費者 ブラウザ EC サイト SimpleWeb OricoPayment Plus 決済センタ 金融機関 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 リダイレクト 先アクセス 暗号鍵 送信処理 2.暗号鍵送信 3.リダイレクト Simple Web URL要求 決済方法選択 ページ表示 決済方法選択ページ送信 決済方法確認 ページ表示 決済方法確認ページ送信 決済方法 選択画面表示 4.申込情報入力 決済方法 確認画面表示 5.決済申込 決済申込要求 決済要求 決済申込受付 決済申込完了 ページ表示 ECサイト 決済申込完了 ページ表示 PUSH 結果通知受信 6.結果通知 決済申込処理 決済申込応答 決済応答 決済受付 決済申込完了ページ送信 7.決済申込完了 ページ送信 決済申込確定部 入金 ATM端末 入金処理 入金通知受信 PUSH 入金通知受信 8.入金通知 入金通知 入金通知 入金通知 入金通知 図 2-4-7 Simple Web 利用時システム処理概要図（銀行決済（ATM）） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 6 結果通知 Simple Web は EC サイトへ POST 形式で結果通知を送信します。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 8 入金通知 OricoPayment Plus にて消費者様による入金が完了したと確認された取引については、EC サ イトへ POST 形式で入金通知を送信します。 表 2-4-7 Simple Web 導入時処理概要（銀行決済（ATM）） 17 OricoPayment Plus Simple Web 開発ガイド 【銀行決済（ネットバンク・PC）】 銀行決済（ネットバンク・PC）の処理概要を下図に示します。 消費者 ブラウザ ECサイト 決済開始 ページ表示 リダイレクト 先アクセス EC サイト SimpleWeb OricoPayment Plus 決済センタ 金融機関 決済導入部 ページ送信 1.暗号鍵取得 決済選択 3.リダイレクト 決済請求部 暗号鍵 送信処理 2.暗号鍵送信 Simple Web URL要求 決済方法選択 ページ表示 決済方法選択ページ送信 決済方法確認 ページ表示 決済方法確認ページ送信 決済方法 選択画面表示 4.申込情報入力 決済方法 確認画面表示 5.決済申込 決済申込要求 PUSH 結果通知受信 6.結果通知 決済申込応答 決済申込処理 決済申込受付 リダイレクト リダイレクト 先アクセス 金融機関選択画面表示要求 アクセス制御 金融機関選択ページ送信 金融機関選択 ページ表示 決済要求 金融機関選択 決済要求 入金確認ページ送信 決済応答 決済受付 入金画面表示要求 入金確認 ページ表示 金融機関 入金 ページ表示 アクセス制御 入金ページ送信 入金 入金処理 入金通知受信 入金通知 入金通知 入金通知 入金確認 決済完了 ページ表示 入金確認 リダイレクト リダイレクト 先アクセス 決済完了 決済完了ページ送信 決済 完了画面表示 7.決済完了 決済確定部 ページ送信 入金通知受信 PUSH ECサイト 決済完了 ページ表示 8.入金通知 入金通知 図 2-4-8 Simple Web 利用時システム処理概要図（銀行決済（ネットバンク・PC）） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 6 結果通知 Simple Web は EC サイトへ POST 形式で結果通知を送信します。 7 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 8 入金通知 OricoPayment Plus にて消費者様による入金が完了したと確認された取引については、EC サ イトへ POST 形式で入金通知を送信します。 表 2-4-8 Simple Web 導入時処理概要（銀行決済（ネットバンク・PC）） 18 OricoPayment Plus Simple Web 開発ガイド 【銀行決済（ネットバンク・モバイル）】 銀行決済（ネットバンク・モバイル）の処理概要を下図に示します。 消費者 ブラウザ EC サイト SimpleWeb OricoPayment Plus 決済センタ 金融機関 決済導入部 ECサイト 決済開始 ページ表示 ページ送信 1.暗号鍵取得 決済選択 決済請求部 リダイレクト 先アクセス 暗号鍵 送信処理 2.暗号鍵送信 3.リダイレクト Simple Web URL要求 決済方法 選択画面表示 決済方法選択ページ送信 決済方法選択 ページ表示 4.申込情報入力 決済方法 確認画面表示 決済方法確認ページ送信 決済方法確認 ページ表示 5.決済申込 決済申込要求 決済申込受付 PUSH 結果通知受信 6.結果 通知 決済申込応答 決済申込処理 決済申込完了ページ送信 決済申込完了 ページ表示 金融機関選択画面表示要求 アクセス制御 金融機関選択ページ送信 金融機関選択 ページ表示 決済要求 金融機関選択 決済要求 決済受付 決済応答 金融機関確認ページ送信 金融機関確認 ページ表示 入金画面表示要求 アクセス制御 入金ページ送信 金融機関 入金 ページ表示 入金 入金処理 入金通知受信 PUSH 入金通知受信 7.入金通知 入金通知 入金通知 入金通知 入金通知 図 2-4-9 Simple Web 利用時システム処理概要図（銀行決済（ネットバンク・モバイル）） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を消費者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 申込情報入力 消費者様は決済方法を選択し、申込情報を入力します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 決済申込の実行を行うと、消費者ブラウザは OricoPayment Plus の金融機関選択画面に遷 移（リダイレクト）します。 6 結果通知 Simple Web は EC サイトへ POST 形式で結果通知を送信します。 7 入金通知 OricoPayment Plus にて消費者様による入金が完了したと確認された取引については、EC サ イトへ POST 形式で入金通知を送信します。 表 2-4-9 Simple Web 導入時処理概要（銀行決済（ネットバンク・モバイル）） 19 OricoPayment Plus Simple Web 開発ガイド 2.4.6 ショッピングクレジット決済 ショッピングクレジット決済の処理概要を下図に示します。 消費者ブラウザ ECサイト 決済開始 ページ表示 リダイレクト 先アクセス EC サイト SimpleWeb OricoPayment Plus Orico Webクレジット 決済導入部 ページ送信 1.暗号鍵取得 決済選択 3.リダイレクト 決済申込部 暗号鍵 送信処理 2.暗号鍵送信 Simple Web URL要求 決済方法 選択画面表示 ページ送信 決済方法選択 ページ表示 4.決済方法選択 決済方法 確認画面表示 ページ送信 決済方法確認 ページ表示 5.決済申込 決済 開始処理 リダイレクト リダイレクト 先アクセス 画面取得 リダイレクト情報 決済 開始処理 リダイレクト先アクセス トップ画面表示 ページ送信 決済センタ トップ画面 ページ表示 画面表示 6.決済センタでの画面操作 決済センタ 最終確認 ページ表示 申込実行 申込受付処理 リダイレクト リダイレクト 先アクセス リダイレクト 決済 完了処理 リダイレクト リダイレクト 先アクセス リダイレクト PUSH 結果通知受信 7.結果通知 決済 完了処理 決済完了画面ページ送信 決済完了 ページ表示 8.決済完了 ECサイト 決済完了 ページ表示 決済確定部 ページ送信 結果通知受信 PUSH 審査結果通知受信 審査結果通知 与信審査処理 結果通知 9.審査結果通知 図 2-4-10 Simple Web 利用時システム処理概要図（ショッピングクレジット決済 ショッピングクレジット申込処理） No. 基本機能 処理説明 1 暗号鍵取得 EC サイト上の決済申込部に渡された決済申込情報を電文化し、Simple Web に送信します。 2 暗号鍵送信 Simple Web は EC サイトからのリクエストを受け、消費者様の暗号鍵(以下ブラウザ暗号鍵)と EC サイト用の暗号鍵をそれぞれ作成し、EC サイトに返却します。 3 リダイレクト EC サイトは取引 ID、ブラウザ暗号鍵及び Simple Web の URL を購入者様に送信し、Simple Web 決済画面に遷移するように促します。 ※Simple Web 決済画面を表示させる際は、ポップアップなど別画面上で表示させるのではな く、同一画面上に表示させるようにしてください。 4 決済方法選択 消費者様は決済方法を選択します。 決済方法の選択を行うと、消費者ブラウザは決済方法確認画面に遷移します。 5 決済申込 消費者様は決済申込を実行します。 決済申込の実行を行うと、消費者ブラウザは Orico Web クレジットの申込トップ画面に遷移（リ ダイレクト）します。 6 申込情報入力 消費者様は Orico Web クレジットの申込トップ画面で申込情報の入力を行います。 リダイレクトによる連携により、Simple Web は消費者様の Orico Web クレジットでの申込が完 了したことを確認します。 20 OricoPayment Plus Simple Web 開発ガイド 7 結果通知 Simple Web は EC サイトへ POST 形式で結果通知を送信します。 8 決済完了 消費者様が「EC サイトへ戻る」ボタンを押下すると、Simple Web は EC サイトが用意する完了 画面へ遷移します。 9 審査結果通知 OricoPayment Plus にて審査が完了したと確認された取引については、EC サイトへ POST 形 式で審査結果通知を送信します。 表 2-4-10 Simple Web 導入時処理概要（ショッピングクレジット決済 ショッピングクレジット申込処理） 21 OricoPayment Plus Simple Web 開発ガイド 第3章 結果通知受信処理 3-1 結果通知受信処理の対象 3.1.1 Simple Web からの結果通知受信処理 Simple Web は、決済結果（または決済申込結果）のステータス判明後、加盟店様（EC サイト）へ結果通知を PUSH 送信します。 この結果通知では、決済結果にかかわらず全ての取引が通知の対象となります。 結果通知の送信は HTTP の POST メソッドを使用しています。 Simple Web からの結果通知は、加盟店様から Simple Web への要求電文で指定した「決済結果通知先 URL」に送信されます。要求電 文で URL を指定しなかった場合には、ご利用申請時に登録した「決済結果通知先 URL」に送信されます。 Simple Web からの結果通知を受信するために必要な処理（ソースコード）は、サンプルプログラム内に用意しています。サンプルプログ ラムを加盟店様の EC サイトにあわせてカスタマイズいただき、ご利用いただくことが可能です。（カスタマイズは加盟店様にて実施して いただきます） ※プロトコルは HTTP（Port：80）、HTTPS（Port：443）に対応しております。 これ以外のプロトコル・ポートの組み合わせには対応しておりません。 HTTPS での結果通知受信を希望される場合は、加盟店様側設置サーバにて SSL 通信環境をご用意ください。SSL 証明書は認証局発 行のものをご使用ください。 ※自己署名（Self-Sign）の SSL 証明書はご利用できませんので、ご注意ください。 Simple Web からの接続時、証明書チェックでエラー扱いとなり結果通知データの送信が中止されます。 結果通知受信後の応答は、HTTP プロトコルのレスポンスメッセージの書式に準じ、HTTP ステータスコード"200"を返戻してください。 ※HTTP ステータスコード"200"以外のステータス、またはサーバから応答がない場合は、通知エラーとして処理され、マーチャント登 録時に登録したリトライ回数上限（決済報告リトライ回数上限）までリトライを行います。 3.1.2 OricoPayment Plus からの結果通知受信処理 特定のサービスにおいて、Simple Web からの結果通知とは別に、OricoPayment Plus から加盟店様（EC サイト）へ消費者アクションの 結果、または OricoPayment Plus における取引のステータスの変化を通知することが可能です。 OricoPayment Plus は、各決済センタから結果通知電文を受信後、加盟店様へ通知を PUSH 送信します。 決済サービス名 結果通知 説明 クレジットカード決済 － － OricoPayment Plus はコンビニ決済センタより消費者の入金完了情報を コンビニ決済 入金通知 受信した後に、加盟店様側へ入金完了を通知します。 この入金通知を売上の確定情報とし、発送処理等は、入金通知を受取 ったタイミングで行ってください。 22 OricoPayment Plus Simple Web 開発ガイド OricoPayment Plus は電子マネー決済センタより消費者の入金完了情 電子マネー決済 入金通知 報を受信した後に、加盟店様側へ入金完了を通知します。 この入金通知を売上の確定情報とし、発送処理等は、入金通知を受取 ったタイミングで行ってください。 OricoPayment Plus は銀行決済センタより消費者の入金完了情報を受 銀行決済 入金通知 信した後に、加盟店様側へ入金完了を通知します。 この入金通知を売上の確定情報とし、発送処理等は、入金通知を受取 ったタイミングで行ってください。 ショッピングクレジット 決済※1 審査結果通知 OricoPayment Plus は、Orico Web クレジットから審査結果情報を受信 した後に、加盟店様側へ審査結果を通知します。 表 3-1-1 結果通知対象サービス一覧（OricoPayment Plus から PUSH 送信） ※1： ショッピングクレジット決済においては、ショッピングクレジット申込の審査結果を結果通知電文として PUSH 送信します。 OricoPayment Plus は、Orico Web クレジットから審査結果電文を受信後、加盟店様へ PUSH 送信します。 ショッピングクレジット決済における結果通知受信処理については、他の決済サービスと一部考え方が異なります。 消費者の入金を示す通知電文ではなく、ショッピングクレジット申込の審査結果通知であることにご注意ください。 OricoPayment Plus からの結果通知受信処理の詳細につきましては、【OricoPayment Plus 開発ガイド】をご参照ください。 なお、受信処理は加盟店様（EC サイト）に実装していただきますが、サンプルソースコードは、OricoPayment Plus（Standard MDK）のサ ンプルプログラム内にありますので、サポートサイトよりダウンロードして頂きますようお願いします。 23 OricoPayment Plus Simple Web 開発ガイド 第4章 インターフェイス詳細 本章では、Simple Web で使用する電文について説明します。 各項目は文字コード UTF-8 で URL エンコードされているものとします。 4-1 アクセス URL アクセス URL （セキュア環境） 暗号鍵取得用 https://pay.veritrans.co.jp/web1/commodityRegist.action Simple Web 転送用 https://pay.veritrans.co.jp/web1/deviceCheck.action ※ この URL にアクセスするためには、TLS1.1 または TLS1.2 をサポートするクライアントが必要です。 ※ TLS1.1 または TLS1.2 をサポートしていないクライアントではご利用できません。 フィーチャー・フォン等の TLS1.1 または TLS1.2 に対応していない端末をサポートする場合は、以下の暫定環境の URL をご利用下さい。 ただし、この URL は、2018 年 5 月に停止を予定しておりますので、それまでにセキュア環境に接続を切り替えて頂く必要があります。 アクセス URL （暫定環境 SSL3.0/TLS1.0 有効） 暗号鍵取得用 https://3gs.veritrans.co.jp/web1/commodityRegist.action Simple Web 転送用 https://3gs.veritrans.co.jp/web1/deviceCheck.action ※ この URL へのアクセスでは、SSL3.0/TLS1.0 が有効です。 ※ この環境は 2018 年 5 月に停止を予定しています。 注） 既に Simple Web サービスをご利用の加盟店様で、旧環境の URL（https://3g.veritrans.co.jp/）をご利用の加盟店様は、2016 年 8 月までに上記の新しい URL に接続を切り替えて頂く必要があります。 本件に関する詳細は、以下のアドレスまでメールにてお問い合わせください。 [お問い合わせ先] ベリトランス株式会社 SSL-SHA2 切替窓口 電子メール：[email protected] または ベリトランス株式会社 テクニカルサポート 電子メール：[email protected] 24 OricoPayment Plus Simple Web 開発ガイド 4-2 要求・応答電文（カード/コンビニ/電子マネー/銀行） Simple Web 各決済（クレジットカード決済／クレジットカード決済（本人認証有り）／コンビニ決済／電子マネー決済／銀行決済）のインター フェイス詳細を以下に示します。 尚、ショッピングクレジット決済のインターフェイス詳細は、「4-3 要求・応答電文（ショッピングクレジット決済）」を参照してください。 4.2.1 暗号鍵取得 「図 2-3-1 サンプルプログラム動作全体図」の手順⑤⑥で送受信する内容は以下の通りです。 ※個人情報は支払者様の情報です。消費者様と支払者様が異なる場合はご注意ください。 Simple Web では全決済方法の情報を統合しているため、決済方法／決済方法サブタイプによって必須／任意項目が異なります（後述）。 「設定」欄の内容は以下の通りとなります。 要求電文 … 必須項目：○ 後述：※（決済方法／決済方法サブタイプにより異なる。【要求電文設定項目一覧】を参照してください。） ⑤要求電文 ： EC サイト → Simple Web URL ： https://*.veritrans.co.jp/web1/commodityRegist.action 項目名 フィールド名 MERCHANT_ID ORDER_ID マーチャント ID 取引 ID 書式・制限 説明 設 定 半角英数字 22 桁以内 弊社より通知する加盟店サイト用マーチャント ○ 半角英数字記号 100 桁以内 ID を指定します。 加盟店様にて任意に採番してください。申込 ○ 処理毎につける必要があります。他の取引 ID と重複しないよう採番して下さい。決済手段が 異なっても重複できません。 ※記号は"-"（ハイフン）、"_"（アンダースコア） のみ使用可能です。 MERCHANTHASH マーチャント生成ハッシ － ュ値 ハッシュシード・マーチャント ID・決済タイプ・取 ○ 引 ID・金額をカンマ区切りで連結し SHA512 で ハッシュした値。 SESSION_ID SessionID 半角英数字 50 桁以内 加盟店様にて任意に発番する乱数。 ○ AMOUNT 購入金額 半角数字 9 桁以内 ※1 ○ FINISH_PAYMENT_ACCES 決済結果通知先 URL 半角英数字記号 256 桁以内 「図 2-3-1 サンプルプログラム動作全体図」 △ S_URL の手順⑪における、EC サイトへの決済通知先 URL を電文毎に変更する為の URL 設定項目。 URL パラメータの指定はできません。 FINISH_PAYMENT_ 決済完了後戻り URL 半角英数字記号 256 桁以内 RETURN_URL 決済が成功した後の EC サイト側への戻り先 △ の URL。 URL パラメータ、およびアンカーの指定はでき ません。 UNFINISH_PAYMENT_RET URN_URL 未決済時戻り URL 半角英数字記号 256 桁以内 消費者が決済を行わなかった場合の EC サイ △ ト側への戻り先 URL。 URL パラメータ、およびアンカーの指定はでき ません。 25 OricoPayment Plus Simple Web 開発ガイド ERROR_PAYMENT_RETUR 決済エラー時戻り URL 半角英数字記号 256 桁以内 N_URL 決済が失敗した後の EC サイト側への戻り先 △ URL。 URL パラメータ、およびアンカーの指定はでき ません。 DUMMY_PAYMENT_FLAG ダミー取引フラグ 半角数字 1 桁 Simple Web のダミー取引の実施可否を設定し △ ます。未設定の場合”0”となります。 "0"：本番取引 "1"：ダミー取引 SETTLEMENT_TYPE 決済方法 半角数字 2 桁 "00"：決済方法指定なし ○ "01"：カード決済 "02"：コンビニ決済 "03"：電子マネー決済 "04"：銀行決済 SETTLEMENT_SUB_TYPE 決済方法サブタイプ 半角数字 3 桁 決済方法にてコンビニ選択時 ※ "201"：セブンイレブン "205"：イーコン（ローソン、ファミリーマート、ミ ニストップ、セイコーマート、サークル K サンク ス） "204"：その他（デイリーヤマザキ） 決済方法にて電子マネー決済選択時 "311"：PC Edy "312"：モバイル Edy "321"：PC Suica "322"：モバイル Suica "331"：PC WAON "332"：モバイル WAON 決済方法にて銀行決済選択時 "411"：ATM 決済 "420"：ネットバンク決済 LANG_ENABLE_FLAG 言語選択可否フラグ 半角数字 1 桁 "0"：選択不可 "1"：選択可 △ LANG 使用言語 備考参照 下記の使用可能言語をカンマ区切りで入力 △ "ja"：日本語 "en"：英語 "zh"：中国語 CARD_INSTALLMENT_JP O カード支払区分 半角数字 2 桁以内 マーチャント様のご利用できる支払区分 ※ 例： "10"：一括 "21"：ボーナス一括 "23"：ボーナス一括(ボーナス月指定)" "61"：分割 "80"：リボルビング 26 OricoPayment Plus Simple Web 開発ガイド CARD_INSTALLMENT_JP カード分割回数 半角数字 2 桁以内 O_CNT ※ マーチャント様のご利用できる分割回数 例： "03":3 回 "06":6 回 "10":10 回 "12":12 回 "15":15 回 "16":16 回 "18":18 回 "20":20 回 "24":24 回 ※CARD_INSTALLMENT_JPO は 61 場合のみ 指定可能。 CARD_CAPTURE_FLAG カード売上フラグ 半角数字 1 桁 "0"：与信のみ "1"：与信・売上 ※ DDD_ENABLE_FLAG 本人認証有効フラグ 半角数字 1 桁 クレジットカード決済にて本人認証が利用可 ※ 能な場合に、電文毎に利用可否を設定する項 目。未設定の場合は"1"となります。 "0"：本人認証利用しない "1"：本人認証利用する（登録済みの場合の み） SHOP_NAME モバイル Edy 用ショップ 文字列 48 バイト以内 名 ※ 決済依頼メール、決済完了メールで使用する 店舗名 SCREEN_TITLE Suica 用商品名 文字列 40 バイト以内 CONTENTS 請求内容 全角 12 文字以内 CONTENTS_KANA 請求内容カナ 全角カナ 24 文字以内 ※ 決済完了画面・決済確認画面等で「商品・サ ービス名」に表示される文字列 ※ インフォメーションとして ATM 等に表示され る文字列 ※ インフォメーションとして ATM 等に表示され る文字列 TIMELIMIT_OF_PAYMENT 支払期限 半角数字 8 桁 YYYYMMDD 形式 ※2 ※ TIMELIMIT_OF_CANCEL 支払取消期限 半角数字 8 桁 YYYYMMDD 形式 ※3 ※ 以下、商品の数だけ繰り返し設定 COMMODITY_ID 商品 ID 半角英数字記号 15 桁以内 単価、個数、商品名入力有りの場合は必須 △ COMMODITY_UNIT 単価 半角数字 9 桁以内 未設定の場合、Simple Web 決済確認画面に △ 表示されないため、設定が望ましい △ COMMODITY_NUM 個数 半角数字 4 桁以内 COMMODITY_NAME 商品名 文字列 50 バイト以内 JAN_CODE JAN コード 半角英数字記号 30 桁以内 △ 単価、個数、商品名入力有りの場合に、必要 △ に応じて JAN コードを指定できます。 ※1： 決済金額の上限と下限の詳細を以下に示します。決済方法と種別を指定している場合は、下記の制限となります。 ただし、決済方法の指定がない場合や電子マネー決済指定で serviceOptionType（決済サービスオプション）の指定がない場合は、 利用可能決済の中で一番小さい上限が使用されます。 ■クレジットカード決済 1 以上 99,999,999 以下 ■コンビニ決済 1 以上 299,999 以下 27 OricoPayment Plus Simple Web 開発ガイド ■電子マネー決済 Edy： 1 以上 50,000 以下 Suica： 1 以上 20,000 以下 WAON： 1 以上 50,000 以下 ■銀行決済 1 以上 999,999,999 以下 ※2： 支払期限の詳細を以下に示します。決済方法と種別を指定している場合は、下記の制限となります。 ただし、決済方法の指定がない場合やコンビニ決済指定で種別の指定がない場合は、一番短い当日～60 日の制限になります。 ■コンビニ決済 セブンイレブン： 当日～150 日後 ローソン・ファミマ・セイコーマート： 当日～60 日後 その他： 当日～365 日後 ■電子マネー決済 当日～90 日後 ■銀行決済 当日～60 日後 ※3： WAON の場合、キャンセル（Cancel）の期限ではなく返金（Refund）の期限となり、返金期限は決済日から 365 日後の 23:59:59 です。 例えば、1/1 日中の取引に関しては、YYYY1231 が上限となります。 28 OricoPayment Plus Simple Web 開発ガイド 【要求電文設定項目一覧】 必須項目：○ 任意項目（決済時必須）：□（要求電文では任意項目ですが、設定しない場合は画面入力時に必須となります） 任意項目（決済時補完）：◇（要求電文では任意項目ですが、設定しない場合は Simple Web にて補完されます） 任意項目（決済時任意）：△（要求電文時、画面入力時共に任意項目となります） 設定不可：×（設定した際にエラーとはならず、決済に利用されない項目となります） ⑤要求電文 ： EC サイト → Simple Web 決済方法／決済方法サブタイプ カード コンビニ 指定なし PC Edy モバイル Edy PC Suica モバイル Suica PC WAON モバイル WAON 指定なし ATM ネットバンク 銀行 指定なし 電子マネー SETTLEMENT_SUB_TYPE × × △ × ○ ○ ○ ○ ○ ○ × ○ ○ CARD_INSTALLMENT_JPO × □ × × × × × × × × × × × CARD_INSTALLMENT_JPO_CNT × □ × × × × × × × × × × × CARD_CAPTURE_FLAG ◇ ◇ × × × × × × × × × × × DDD_ENABLE_FLAG ◇ ◇ × × × × × × × × × × × SHOP_NAME △ × × △ × △ × × × × × × × SCREEN_TITLE ※1 × × ※1 × × ○ ○ × × × × × CONTENTS ※2 × × × × × × × × × ○ ○ ○ CONTENTS_KANA ※2 × × × × × × × × × ○ ○ ○ TIMELIMIT_OF_PAYMENT △ × ◇ ◇ × ◇ ◇ ◇ ◇ ◇ ◇ ◇ ◇ TIMELIMIT_OF_CANCEL ※3 × × ※3 × × × × ○ ○ × × × フィールド名 ※1 ： Suica 決済（PC Suica／モバイル Suica）ご利用時は、必須項目となります。 ※2 ： 銀行決済（ATM／ネットバンク）ご利用時は、必須項目となります。 ※3 ： WAON 決済（PC WAON／モバイル WAON）ご利用時は、必須項目となります。 29 OricoPayment Plus Simple Web 開発ガイド 「設定」欄の内容は以下の通りとなります。 応答電文 … 条件付返戻：※ ⑥応答電文 ： Simple Web → EC サイト フィールド名 MERCHANT_ENCRYPTIO 項目名 マーチャント暗号鍵 書式・制限 半角英数字 120 桁以内 N_KEY 説明 EC サイトが保管する暗号鍵 設 定 ※ ※成功時のみ返戻 BROWSER_ENCRYPTION_ ブラウザ暗号鍵 半角英数字 120 桁以内 KEY ブラウザに戻される暗号鍵 ※ ※成功時のみ返戻 ERROR_MESSAGE エラーメッセージ 別紙 Simple Web が戻すエラーメッセージ ※ ※エラー時のみ返戻 ※ 「マーチャント暗号鍵」は決済処理では使用しません。決済情報照会の際に必要になる場合がございますので大切に保管してください。 4.2.2 Simple Web 転送 「図 2-3-1 サンプルプログラム動作全体図」の手順⑨で消費者ブラウザへ転送される内容は以下の通りです。 「設定」欄の内容は以下の通りとなります。 転送電文 … 必ず転送：○ ⑨転送電文 ： EC サイト → 消費者ブラウザ URL ： https://*.veritrans.co.jp/web1/deviceCheck.action フィールド名 項目名 書式・制限 説明 設 定 MERCHANT_ID マーチャント ID 半角英数字 22 桁以内 マーチャントを識別する ID ○ ORDER_ID 取引 ID 半角英数字記号 100 桁以内 マーチャントの注文を識別する ID ○ BROWSER_ENCRYPTION_ ブラウザ暗号鍵 半角英数字 120 桁以内 ブラウザに戻される暗号鍵 ○ KEY 30 OricoPayment Plus Simple Web 開発ガイド 4.2.3 決済結果照合 「図 2-3-1 サンプルプログラム動作全体図」の手順⑭で消費者ブラウザから EC サイトに送信されます。EC サイトは、この決済結果が成 功を示しており、かつ、「4.2.4 Simple Web からの結果通知電文」で受信した結果と一致する場合に、この決済は成功と判断してください。 消費者ブラウザから EC サイトへの戻り URL は、4.2.1 暗号鍵取得の要求電文で設定することができます。要求電文で設定しなかった場合 は、マーチャント登録時に指定した URL が使われます。決済が完了したか否か、エラーが発生したかにより、以下の戻り URL へ戻ります。 決済が完了した場合 ： 決済完了後戻り URL 消費者が決済を行わなかった場合 ： 未決済時戻り URL 決済がエラーで終了した場合 ： 決済エラー時戻り URL 消費者ブラウザから送信される内容は以下の通りです。 「設定」欄の内容は以下の通りとなります。 受信情報 …必ず受信：○ その他条件付き：※（条件は説明欄に記載） ⑭送信情報 ： 消費者ブラウザ → EC サイト フィールド名 項目名 書式・制限 設 説明 orderId 取引 ID 半角英数字記号 100 桁以内 EC サイトから送信された取引 ID mStatus ステータス 4.2.4 参照 4.2.4 参照 定 ○ ※ ※成功時、エラー時のみ返戻されます。未 決済時は返戻されません。 vResultCode 結果コード 4.2.4 参照 4.2.4 参照 ※ ※成功時、エラー時のみ返戻されます。未 決済時は返戻されません。 sessionId セッション ID 4.2.1 参照 4.2.1 で送信した SESSION_ID ※ ※成功時、エラー時のみ返戻されます。未 決済時は返戻されません。 4.2.4 Simple Web からの結果通知電文 A) 結果通知電文の概要 機能概要 Simple Web は決済結果（または決済申込結果）のステータス判明後、EC サイトへ結果通知を PUSH 送信します。 結果通知は、HTTP の POST で通知します。 ※ プロトコルは HTTP（Port：80）、HTTPS（Port：443）に対応しています。 処理の概要については本ガイド「第 3 章 結果通知受信処理」を参照してください。 結果通知受信処理結果について Simple Web からの通知に対して EC サイトが HTTP ステータスコード"200"を返戻した場合、受信処理が正常に終了したものと 判断します。 "200"以外のコードを返した場合は、受信失敗と判断し、マーチャント登録時に登録したリトライ回数上限（結果通知リトライ回数 31 OricoPayment Plus Simple Web 開発ガイド 上限）までリトライを行います。 ※ 規定の回数失敗した場合は、通知処理が停止しますのでご注意ください。 ※ Simple Web からの結果通知電文には、HMAC 値（content-hmac）は含まれません。 B) 結果通知受信 「図 2-3-1 サンプルプログラム動作全体図」の手順⑪で Simple Web から EC サイトへ通知される内容は以下の通りです。 ※結果通知のフィールドは、Simple Web が提供する以下の項目のみ使用可能です。加盟店様にて独自のフィールドを付加するこ とはできません。 「設定」欄の内容は以下の通りとなります。 受信情報 … 必ず受信：○ 場合により受信：△ ⑪受信情報 ： Simple Web → EC サイト フィールド名 項目名 書式・制限 説明 設 定 orderId 取引 ID 半角英数字記号 100 桁以内 EC サイトから送信された取引 ID ○ mStatus ステータス 右記 処理結果に対するステータス ○ "success"：正常終了 "failure"：異常終了 "pending"：保留 mErrMsg メッセージ 別紙 処理結果に対するメッセージ △ ※クレジットカード決済（本人認証有り）の場 合、この値は連携されません。 ※クレジットカード決済（本人認証有り）以外の 決済では必ず連携されます。 vResultCode 結果コード 別紙 処理結果を詳細に表すコード ○ userName 漢字氏名 全角 20 文字以内 VTWeb で入力した値が返戻される。 △ 全角カナ 20 文字以内 ※各情報が返戻される決済の詳細について △ userNameKana カナ氏名 mailAddress メールアドレス 半角英数字記号 50 桁以内 telephoneno 電話番号 半角数字 11 桁以内 は、下記「入力値の返戻について」を参照して ください。 △ △ 入力値の返戻について 各情報が返戻される決済は、下記の通りとなります。 ・漢字氏名 ： コンビニ決済、銀行決済 ・カナ氏名 ： コンビニ決済、銀行決済 ・メールアドレス ： 電子マネー決済 ・電話番号 ： コンビニ決済 尚、カード決済では、本人認証無しの場合、本人認証有りの場合とも返戻されません。 32 OricoPayment Plus Simple Web 開発ガイド 4.2.5 OricoPayment Plus からの結果通知電文 OricoPayment Plus からの結果通知電文送信の機能がある決済サービスは、「表 3-1-1 結果通知対象サービス一覧（OricoPayment Plus から PUSH 送信）」をご参照ください。 結果通知電文の概要、および各決済サービスの結果通知電文のインターフェイス詳細については、【OricoPayment Plus 開発ガイド】をご 参照ください。 33 OricoPayment Plus Simple Web 開発ガイド 4-3 要求・応答電文（ショッピングクレジット決済） ショッピングクレジット決済のインターフェイス詳細を以下に示します。 尚、ショッピングクレジット決済以外の各決済のインターフェイス詳細は、「4-2 要求・応答電文（カード/コンビニ/電子マネー/銀行）」を参照 してください。 4.3.1 暗号鍵取得 「図 2-4-10 Simple Web 利用時システム処理概要図（ショッピングクレジット決済 ショッピングクレジット申込処理）」の「No.1 暗号鍵取得」、 「No2 暗号鍵送信」で送受信する電文の内容を以下の表に記載します。 「設定」欄の内容は以下の通りとなります。 ○：必須項目、 △：条件付き必須項目、 ×：利用不可項目、 □：任意項目 No.1 暗号鍵取得 要求電文 ： EC サイト → Simple Web URL ： https://*.veritrans.co.jp/web1/commodityRegist.action フィールド名 SETTLEMENT_TY 項目名 決済方法 書式・制限 半角数字 2 桁 説明 “00”：決済方法指定なし 設 定 ○ PE “05”：ショッピングクレジット決済 ※ショッピングクレジット決済を指定する場合は、“05”：ショッピングクレ ジット決済を設定ください。 その他の決済もあわせて指定する場合は“00”：決済方法指定なしを設 定ください。 MERCHANT_ID マーチャント ID 半角英数字 22 桁 マーチャント ID を指定します。 ○ 加盟店様にて任意に発番する乱数。 ○ ハッシュシード・マーチャント ID・決済タイプ・取引 ID・金額をカンマ区切 ○ 以内 SESSION_ID SessionID 半角英数字 50 桁 以内 MERCHANTHASH マーチャント生成 － ハッシュ値 ORDER_ID 取引 ID りで連結し SHA512 でハッシュした値。 半角英数字 加盟店様側で取引を一意に表す注文管理 ID を指定します。 100 桁以内 申込処理ごとに一意である必要があります。 ○ ※半角英数字の他に"-"（ハイフン）、"_"（アンダースコア）も使用可能 です。 WEB_DESCRIPTI WEB 申込商品 ID ON_ID CONTRACT_DOC WEB 申込商品 ID を指定します。 □ 半角数字 契約書有無区分を指定します。 □ 1桁 "0"：契約書無し 半角英数字 4 桁以内 契約書有無区分 UMENT_KBN "1"：契約書有り HANDLING_CONT 取扱契約番号 RACT_NO 半角英数字 取扱契約番号を指定します。 □ 決済完了後のリダイレクト先 URL を指定します。 □ 決済未完了時のリダイレクト先 URL を指定します。 □ 3 桁以内 FINISH_PAYMENT 決済完了後戻り 半角英数字記号 _RETURN_URL URL 256 桁以内 UNFINISH_PAYME 未決済時戻り 半角英数字記号 NT_RETURN_URL URL 256 桁以内 34 OricoPayment Plus Simple Web 開発ガイド 決済エラー時のリダイレクト先 URL を指定します。 □ 半角英数字 加盟店様側で取引を表すショッピングクレジット用の注文番号を指定し ○ 20 桁以内 ます。 ERROR_PAYMEN 決済エラー時戻り 半角英数字記号 T_RETURN_URL URL 256 桁以内 ORICO_ORDER_N 注文番号 O Orico Web クレジットの管理画面（Orico B’Plaza）で取引を特定する番 号になります。 MEMBERSHIP_NO COMMODITY_NA 加盟店様が会員を管理したい際に指定します。 □ 商品名 1 を指定します。 ○ 半角数字 数量 1 を指定します。 ○ 3 桁以内 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン 会員番号（加盟 半角英数記号 店） 20 桁以内 商品名 1 全角 ME 半角英数記号 50 桁(バイト)以内 COMMODITY_NU 数量 1 M グクレジット決済の最大桁数（3 桁）までとします。 COMMODITY_UNI 商品価格 1（税込） T 半角数字記号 商品価格 1 を税込で指定します。 8 桁以内 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン ○ グクレジット決済の最大桁数（8 桁）までとします。 COMMODITY_NA 商品名 2 ME COMMODITY_NU 数量 2 M 全角 商品名 2 を指定します。 半角英数記号 数量 2、商品価格 2（税込）のどちらかが指定されている場合、必須項 50 桁(バイト)以内 目となります。 半角数字 数量 2 を指定します。 3 桁以内 商品名 2、商品価格 2（税込）のどちらかが指定されている場合、必須 △ △ 項目となります。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（3 桁）までとします。 COMMODITY_UNI 商品価格 2（税込） T 半角数字記号 商品価格 2 を税込で指定します。 8 桁以内 商品名 2、数量 2 のどちらかが指定されている場合、必須項目となりま △ す。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（8 桁）までとします。 COMMODITY_NA 商品名 3 ME COMMODITY_NU 数量 3 M 全角 商品名 3 を指定します。 半角英数記号 数量 3、商品価格 3（税込）のどちらかが指定されている場合、必須項 50 桁(バイト)以内 目となります。 半角数字 数量 3 を指定します。 3 桁以内 商品名 3、商品価格 3（税込）のどちらかが指定されている場合、必須 △ △ 項目となります。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（3 桁）までとします。 COMMODITY_UNI 商品価格 3（税込） T 半角数字記号 商品価格 3 を税込で指定します。 8 桁以内 商品名 3、数量 3 のどちらかが指定されている場合、必須項目となりま △ す。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（8 桁）までとします。 COMMODITY_NA 商品名 4 ME COMMODITY_NU 数量 4 M 全角 商品名 4 を指定します。 半角英数記号 数量 4、商品価格 4（税込）のどちらかが指定されている場合、必須項 50 桁(バイト)以内 目となります。 半角数字 数量 4 を指定します。 3 桁以内 商品名 4、商品価格 4（税込）のどちらかが指定されている場合、必須 △ △ 項目となります。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（3 桁）までとします。 COMMODITY_UNI 商品価格 4（税込） 半角数字記号 商品価格 4 を税込で指定します。 △ 35 OricoPayment Plus Simple Web 開発ガイド T 8 桁以内 商品名 4、数量 4 のどちらかが指定されている場合、必須項目となりま す。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（8 桁）までとします。 COMMODITY_NA 商品名 5 ME COMMODITY_NU 数量 5 M △ 全角 商品名 5 を指定します。 半角英数記号 数量 5、商品価格 5（税込）のどちらかが指定されている場合、必須項 50 桁(バイト)以内 目となります。 半角数字 数量 5 を指定します。 3 桁以内 商品名 5、商品価格 5（税込）のどちらかが指定されている場合、必須 △ 項目となります。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（3 桁）までとします。 COMMODITY_UNI 商品価格 5（税込） T △ 半角数字記号 商品価格 5 を税込で指定します。 8 桁以内 商品名 5、数量 5 のどちらかが指定されている場合、必須項目となりま す。 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（8 桁）までとします。 COMMODITY_AM 商品価格合計（税 半角数字 OUNT 込） 8 桁以内 SHIPPING_AMOU 送料合計（税込） 半角数字 NT 商品ごとの商品価格×数量の合計金額を指定します。 ○ 送料合計を税込で指定します。 □ ○ 8 桁以内 AMOUNT 現金価格合計（税 半角数字 商品価格合計（税込）＋送料合計（税込）を指定します。 込） 8 桁以内 500 以上 99,999,999 以下 ※ショッピングクレジット以外の決済を同時利用する場合は、ショッピン グクレジット決済の最大桁数（8 桁）までとします。 DEPOSIT 頭金 SHIPPING_ZIP_C 配送先郵便番号 頭金を指定します。 □ 半角数字記号 配送先の郵便番号を指定します。 ○ 8 桁以内 ハイフンを含む 999-9999 形式 にて指定します。 半角数字 8 桁以内 ODE 「設定」欄の内容は以下の通りとなります。 応答電文 … 条件付返戻：※ No.2 暗号鍵送信 応答電文 ： Simple Web → EC サイト フィールド名 MERCHANT_ENCRYPTIO 項目名 マーチャント暗号鍵 書式・制限 半角英数字 120 桁以内 N_KEY BROWSER_ENCRYPTION_ EC サイトが保管する暗号鍵 設 定 ※ ※成功時のみ返戻 ブラウザ暗号鍵 半角英数字 120 桁以内 KEY ERROR_MESSAGE 説明 ブラウザに戻される暗号鍵 ※ ※成功時のみ返戻 エラーメッセージ 別紙 Simple Web が戻すエラーメッセージ ※ ※エラー時のみ返戻 36 OricoPayment Plus Simple Web 開発ガイド 4.3.2 Simple Web 転送 「図 2-4-10 Simple Web 利用時システム処理概要図（ショッピングクレジット決済 ショッピングクレジット申込処理）」の「3.リダイレクト」で消 費者ブラウザへ転送される内容は以下の通りです。 「設定」欄の内容は以下の通りとなります。 転送電文 … 必ず転送：○ No.3 リダイレクト 転送電文 ： EC サイト → 消費者ブラウザ URL ： https://*.veritrans.co.jp/web1/deviceCheck.action フィールド名 項目名 書式・制限 説明 設 定 MERCHANT_ID マーチャント ID 半角英数字 22 桁以内 マーチャントを識別する ID ○ ORDER_ID 取引 ID 半角英数字記号 100 桁以内 マーチャントの注文を識別する ID ○ BROWSER_ENCRYPTION_ ブラウザ暗号鍵 半角英数字 120 桁以内 ブラウザに戻される暗号鍵 ○ KEY 37 OricoPayment Plus Simple Web 開発ガイド 4.3.3 決済結果照合 「図 2-3-1 サンプルプログラム動作全体図」の手順⑭、「図 2-4-10 Simple Web 利用時システム処理概要図（ショッピングクレジット決済 ショッピングクレジット申込処理）」の「No.8 決済完了」で消費者ブラウザから EC サイトに結果が送信されます。EC サイトは、この決済結果 が成功を示し、かつ、「4.3.4 Simple Web からの結果通知電文」で受信した結果と一致する場合に、この決済は成功と判断してください。 消費者ブラウザから EC サイトへの戻り URL は、4.3.1 暗号鍵取得の要求電文で設定することができます。要求電文で設定しなかった場合 は、マーチャント登録時に指定した URL が使われます。決済が完了したか否か、エラーが発生したかにより、以下の戻り URL へ戻ります。 決済が完了した場合 ： 決済完了後戻り URL 消費者が決済を行わなかった場合 ： 未決済時戻り URL 決済がエラーで終了した場合 ： 決済エラー時戻り URL 消費者ブラウザから送信される内容は以下の通りです。 「設定」欄の内容は以下の通りとなります。 受信情報 …必ず受信：○ その他条件付き：※（条件は説明欄に記載） No.8 送信情報 ： 消費者ブラウザ → EC サイト フィールド名 orderId 項目名 取引 ID mStatus ステータス 書式・制限 設 説明 半角英数字 暗号鍵取得時に指定された取引 ID を返戻し 100 桁位以内 ます。 4.3.4 参照 4.3.4 参照 定 ○ ※ ※成功時、エラー時のみ返戻されます。未 決済時は返戻されません。 vResultCode 結果コード 4.3.4 参照 4.3.4 参照 ※ ※成功時、エラー時のみ返戻されます。未 決済時は返戻されません。 sessionId セッション ID 4.3.1 参照 4.3.1 で送信した SESSION_ID ※ ※成功時、エラー時のみ返戻されます。未 決済時は返戻されません。 receiptNo 受付番号 半角数字 決済完了時にオリコから発行された受付番 10 桁以内 号を返戻します。 ※ 4.3.4 Simple Web からの結果通知電文 A) 結果通知電文の概要 機能概要 Simple Web は決済結果のステータス判明後、EC サイトへ決済結果通知を PUSH 送信します。 （「図 2-4-10 Simple Web 利用時システム処理概要図（ショッピングクレジット決済 ショッピングクレジット申込処理）」の「7.完了通 知」） 結果通知は、HTTP の POST で通知します。 ※ プロトコルは HTTP（Port：80）、HTTPS（Port：443）に対応しています。 処理の概要については本ガイド「第 3 章 結果通知受信処理」を参照してください。 38 OricoPayment Plus Simple Web 開発ガイド 結果通知受信処理結果について Simple Web からの通知に対して EC サイトが HTTP ステータスコード"200"を返戻した場合、受信処理が正常に終了したものと 判断します。 "200"以外のコードを返した場合は、受信失敗と判断し、マーチャント登録時に登録したリトライ回数上限（決済報告リトライ回数 上限）までリトライを行います。 ※ 規定の回数失敗した場合は、通知処理が停止しますのでご注意ください。 ※ Simple Web からの結果通知電文には、HMAC 値（content-hmac）は含まれません。 B) 決済結果通知 「図 2-4-10 Simple Web 利用時システム処理概要図（ショッピングクレジット決済 ショッピングクレジット申込処理）」「7.完了通知」 で送信する電文の内容を以下の表に記載します。 「設定」欄の内容は以下の通りとなります。 ○：必須項目、 △：条件付き必須項目、 ×：利用不可項目、 □：任意項目 ⑪受信情報 ： Simple Web → EC サイト 項目名 フィールド名 書式・制限 設 説明 定 orderId 取引 ID 半角英数字記号 100 桁以内 EC サイトから送信された取引 ID ○ mStatus ステータス 右記 処理結果に対するステータス ○ "success"：正常終了 "failure"：異常終了 "pending"：保留 mErrMsg メッセージ 別紙 処理結果に対するメッセージ △ ※クレジットカード決済（本人認証有り）の場 合、この値は連携されません。 ※クレジットカード決済（本人認証有り）以外の 決済では必ず連携されます。 vResultCode 結果コード 別紙 処理結果を詳細に表すコード ○ receiptNo 受付番号 半角数字 決済完了時に弊社から発行された受付番号を △ 10 桁以内 返戻します。 4.3.5 OricoPayment Plus からの結果通知電文 ショッピングクレジット決済では、ショッピングクレジット申込の審査結果を結果通知電文として OricoPayment Plus から EC サイトへ PUSH 送信します。 （「図 2-4-10 Simple Web 利用時システム処理概要図（ショッピングクレジット決済 ショッピングクレジット申込処理）」の「9.審査結果通知」） 審査結果通知電文の機能、HMAC、結果通知受信処理結果等の概要について、および審査結果通知電文のインターフェースについては、 【OricoPayment Plus Standard MDK 開発ガイド】の第 4 章を参照してください。 39 OricoPayment Plus Simple Web 開発ガイド 第5章 その他補足事項 5-1 テスト実施にあたっての注意事項 Simple Web のテストを実施する際のテスト仕様につきましては、「OricoPayment Plus 導入テストガイド」を参照してください。 以下にテスト実施の際の主な注意事項を記載します。 テスト取引を行う場合は「ダミー取引フラグ」を必ず "１" に設定してください。 「4.2.1 暗号鍵取得」の 「⑤要求電文 ： EC サイト → Simple Web」にて「DUMMY_PAYMENT_FLAG（ダミー取引フラグ）」を「"1"：ダミ ー取引」に設定してください。 テスト取引を行うには決まった設定条件（所定のカード番号、所定の決済金額など）が必要です。 テスト時の設定条件につきましては、「OricoPayment Plus 導入テストガイド」を参照してください。 取引テスト時には、下記の事項に注意してください。 取引 ID（orderId）：任意に設定してください。重複しないように設定する必要があります。また、テスト取引で使用した取引 ID を、 本番取引で再度使用することはできません。 金額：有効な金額データをセットしてください。（小数点の入った数値は使用できません） ダミー取引に対する本番リクエスト、本番取引に対するダミーリクエストはエラーとなります。 「お支払い方法選択（クレジットカード決済）」画面の「カード有効期限」の「年(西暦下 2 桁)」選択肢について 「お支払い方法選択（クレジットカード決済）」画面の「カード有効期限」の選択肢について、ダミーモードの場合は、異常系のテスト用 に「年(西暦下 2 桁)」の値で「90」～「99」が表示されます。 図 5-1-1 「お支払い方法選択」画面の「カード有効期限」の選択肢について 40 OricoPayment Plus Simple Web 開発ガイド ※ダミーモードでは、異常系のテストのために「カード有効期限」の値により特定のエラーコードを返戻します。詳細は、 「OricoPayment Plus 導入テストガイド」を参照してください。 ※本番取引では、「年(西暦下 2 桁)」の値は、「現在の年-1 年」から「現在の年を含む未来 15 年」までが選択肢として表示されます。 例）現在：2016 年 →選択肢は(20)15 年から(20)30 年が表示されます。 5-2 MAP を利用したテスト取引の結果確認 加盟店様サイトから行ったテスト取引の処理結果は、管理ツールである MAP において検索・参照することが可能です。 MAP の使用法は、「ご利用ガイド」を参照してください。 ※MAP とは Merchant Administration Portal の略で、OricoPayment Plus における管理・運用上の各種情報・機能を提供する Web 型の管理ツールで す。 URL： https://pay.veritrans.co.jp/maps/orico/ 41
© Copyright 2024 Paperzz
