OricoPayment Plus 導入テストガイド OricoPayment Plus 導入テストガイド OricoPayment Plus Test Guide Ver.1.3.0 （2015 年 8 月～） Copyright (c) 2013-2014 VeriTrans Inc., a Digital Garage company. All rights reserved. OricoPayment Plus 導入テストガイド 目次 1. 本ガイドについて ........................................................................................................................................................................................................ 4 1.1 本ガイドの内容 ................................................................................................................................................................................................ 4 1.2 著作権、および問い合わせ先 ................................................................................................................................................................... 4 1.3 改定履歴 ............................................................................................................................................................................................................. 4 2. テスト準備 ...................................................................................................................................................................................................................... 6 2.1 テストを行うまでに必要な準備.................................................................................................................................................................. 6 2.2 テスト方法について ........................................................................................................................................................................................ 6 2.3 設定項目について .......................................................................................................................................................................................... 6 3. 決済別のテスト仕様 .................................................................................................................................................................................................. 8 3.1 ダミーモードと本番取引 ............................................................................................................................................................................... 8 3.2 クレジットカード決済....................................................................................................................................................................................... 8 3.3 MPI ホスティング.............................................................................................................................................................................................. 9 3.4 コンビニ決済...................................................................................................................................................................................................... 9 3.5 電子マネー決済 .............................................................................................................................................................................................10 3.6 銀行決済 ...........................................................................................................................................................................................................10 3.7 Paypal 決済......................................................................................................................................................................................................10 3.7.1 金額とエラーコードの対応.............................................................................................................................................................10 3.7.2 ダミー決済センター ...........................................................................................................................................................................14 3.8 銀聯ネット決済（UPOP） .............................................................................................................................................................................16 3.9 Alipay 決済 .......................................................................................................................................................................................................19 3.10 キャリア決済 ....................................................................................................................................................................................................23 3.10.1 金額とエラーコードの対応.............................................................................................................................................................23 3.10.2 ダミー決済センター仕様 .................................................................................................................................................................26 3.11 4. ショッピングクレジット決済 ........................................................................................................................................................................38 その他 ............................................................................................................................................................................................................................40 4.1 決済申込後の取引ステータスの変化について ...............................................................................................................................40 4.2 結果通知の受信テストについて.............................................................................................................................................................41 4.2.1 テスト用アカウントでのテスト .......................................................................................................................................................42 4.2.2 本番アカウントでのテスト ..............................................................................................................................................................42 4.3 テスト取引の確認について.......................................................................................................................................................................43 4.4 取引 ID について ...........................................................................................................................................................................................43 4.4.1 テスト用アカウントをご利用の場合 ...........................................................................................................................................43 4.4.2 本番アカウントをご利用の場合 ..................................................................................................................................................43 5. 付録―サンプル WEB 画面の説明 ...................................................................................................................................................................44 5.1 OricoPayment Plus – サンプルアプリケーショントップページ .................................................................................................44 5.2 クレジットカード（本人認証無し）.............................................................................................................................................................45 2 OricoPayment Plus 導入テストガイド 5.3 クレジットカード（3D 認証有り） ..................................................................................................................................................................46 5.4 コンビニエンスストア ......................................................................................................................................................................................47 5.5 電子マネー .........................................................................................................................................................................................................48 5.6 銀行 .......................................................................................................................................................................................................................49 5.7 PayPal...................................................................................................................................................................................................................50 5.8 銀聯ネット決済(UPOP)..................................................................................................................................................................................52 5.9 Alipay 決済 .........................................................................................................................................................................................................53 5.10 キャリア決済 ......................................................................................................................................................................................................54 5.11 ショッピングクレジット決済 ...........................................................................................................................................................................59 5.12 取引管理メニュー ............................................................................................................................................................................................61 5.12.1 カード決済.............................................................................................................................................................................................62 5.12.2 MPI 取引 ................................................................................................................................................................................................65 5.12.3 コンビニエンスストア ........................................................................................................................................................................66 5.12.4 電子マネー ...........................................................................................................................................................................................67 5.12.5 PayPal .....................................................................................................................................................................................................69 5.12.6 銀聯ネット決済(UPOP)....................................................................................................................................................................72 5.12.7 Alipay 決済 ...........................................................................................................................................................................................75 5.12.8 キャリア決済 ........................................................................................................................................................................................76 5.12.9 銀行 .........................................................................................................................................................................................................79 5.12.10 Search 処理 .........................................................................................................................................................................................80 3 OricoPayment Plus 導入テストガイド 1. 本ガイドについて 1.1 本ガイドの内容 本ガイドは、（株）オリエントコーポレーション（以下、弊社）が提供する OricoPayment Plus を利用するインターネット店 舗等で、システム構築後に行うテストのテスト仕様について解説したものです。 1.2 著作権、および問い合わせ先 [著作権] 本ドキュメントの著作権は弊社が保有しています。 Copyright (c) 2013 VeriTrans Inc., a Digital Garage company. All rights reserved. [お問い合わせ先] 株式会社 テクニカルサポート 電子メール： [email protected] 1.3 改定履歴 2013/07 ：Ver1.0.0 リリース VeriTrans3G の OEM 版である OricoPayment Plus をリリース 2013/11 ：Ver1.0.1 リリース OricoPayment Plus 用のログイン URL およびテスト用アカウントに記載を修正 新 MAP に関する記述を削除 2013/12 ：Ver1.1.2 リリース ・キャリア決済（フレッツまとめて支払い）を追加 ・コンビニ決済 サークル K サンクスをその他（”other”）からイーコン（”econ”）仕向とするよう修正 ・3.4 電子マネー決済に、ダミーリクエスト時の決済センターからのメール送信に関する注意事項を記載 ・3.10.1. 金額とエラーコードの対応 ・決済申込における決済金額の下 1 桁の値と返戻される vResultCode au かんたん決済、ソフトバンクまとめて支払い(A)、S!まとめて支払いの返戻されるコードを修正 ・継続課金終了における決済金額の下 1 桁の値と返戻される vResultCode au かんたん決済の返戻されるコードを修正 ・5.5 電子マネーの「電子マネー -決済請求処理」の画面キャプチャを修正 2014/03 ：Ver1.1.3 リリース ・コンビニ決済 サークル K サンクスのイーコン仕向け対応が対応時期延期となったため、 4 OricoPayment Plus 導入テストガイド 「その他（”other”）」とするよう修正 ・3.7 銀聯ネット決済（UPOP）の UPOP ダミーセンターの画面キャプチャを修正 ・5.8 銀聯ネット決済(UPOP)の UPOP ダミー決済センターの画面キャプチャを修正 2014/11 ：Ver1.2.0_OR リリース ・PayPal 決済のテスト仕様を記載（ダミー決済センターを使用したテスト仕様です） ・コンビニ決済 サークル K サンクスをその他（”other”）からイーコン（”econ”）仕向とするよう修正 ・3.7 銀聯ネット決済（UPOP）、3.8 Alipay 決済、3.10 ショッピングクレジット決済の「決済品目選択画面」の 画面キャプチャを削除 ・5.10 キャリア決済の参照ガイド名を修正 ・5.11 ショッピングクレジット決済の参照ガイド名を修正 2015/07 ：Ver1.3.0_OR リリース ・ヘッダーを追加 ・3.1 ダミーモードと本番取引を追加 ・3.2 クレジットカード決済の「テスト用クレジットカード番号」に AMEX のテストカード番号を追加 ・3.2 クレジットカード決済に「AuthCode のレスポンス」を追加 ・3.4 コンビニ決済に「入金通知（ダミーモードと本番取引との差異）」を追加 ・3.10 キャリア決済にダミーモードでテストを実施するよう追記 ・3.10.1 金額とエラーコードの対応 ・継続課金終了における決済金額の下 1 桁の値 ソフトバンクまとめて支払い（A）の返戻されるコードを修正 ・4.4 取引 ID について追加 5 OricoPayment Plus 導入テストガイド 2. テスト準備 2.1 テストを行うまでに必要な準備 テストを行う際、以下の準備が完了している必要があります。 1. 各処理サーバやネットワークなどにおいて弊社と通信出来る環境が整備されている 2. 弊社が提供する OricoPayment Plus MDK が導入されている 3. テストに用いるアカウント情報（マーチャント ID など）を取得している 4. アカウント情報が MDK に正しく設定されている 2.2 テスト方法について テスト方法として、以下の 2 通りを準備しております。 1. テスト専用アカウントを用いてテストする テスト用に配布しているアカウントを用いてテストを行います。稼働前のテストは基本的にこちらの方法でご案内さ せていただきます。 ※テスト用アカウントは、「B100999609999603099996」のフォーマットとなります。 2. 本番アカウントを用いてテストする 本番稼働後もご利用いただくアカウントを用いてテストを行います。テストアカウントでのテスト完了後の本番環境 テスト、もしくは本番稼働後のテストなどはこちらで行うことも可能です。 本番アカウントのテストの場合は、実際に各決済センターに決済リクエスト電文が飛ばないように、ダミーモードを 指定いただく必要があります（後述）。 何れの方法も、OricoPayment Plus において疑似的に折返しを行い、成功、失敗レスポンスを戻します。 2.3 設定項目について テストに必要となる各値を MDK に設定します。Standard MDK の設定ファイルは「3GPSMDK.properties」です。 この設定ファイルに以下の情報を設定下さい。 ※その他設定値詳細については別資料「OricoPayment Plus MDK インストールガイド」を参照 マーチャント認証用の設定 弊社より別途マーチャント情報（マーチャント ID とパスワード）を通知致します。 それらの情報を使い、MAP から「マーチャント CCID」と「マーチャント認証鍵」を取得下さい。 ※MAP とは Marchant Administration Portal の略で、OricoPayment Plus における管理・運用上の各種情報・機能を 提供する Web 型の管理ツールです。MAP の使用法は、「ご利用ガイド」を参照してください。 URL： https://3g.veritrans.co.jp/maps/orico/ 6 OricoPayment Plus 導入テストガイド MAP にログイン後、トップページ→MDK 設定情報より MDK 設定値「マーチャント CCID」と「マーチャント認証鍵」をご 確認下さい。 ・MDK への設定 1. マーチャント CCID の設定 MERCHANT_CC_ID = xxxxxxxxxxxxx 2. マーチャント認証鍵の設定 MERCHANT_SECRET_KEY = xxxxxxxxxxxxxxxx ダミーモードの設定 ※本番アカウントを用いてテストを行う場合 テスト用にダミー決済を発生させる場合に指定します。 DUMMY_REQUEST = x 本番アカウントを用いてテストを行う場合にのみ、以下の設定を行います。 「1」：ダミーモード ON テストアカウントを用いたテストでは全てのエントリーを自動的に OricoPayment Plus で折返しますので、ダミーモー ドの指定は不要です。 7 OricoPayment Plus 導入テストガイド 3. 決済別のテスト仕様 3.1 ダミーモードと本番取引 ダミーモードは、決済のテストを行うために OricoPayment Plus にて決済事業者（コンビニ各社、キャリア等）からのレスポ ンスを疑似的に発生させる等の仕組みで取引のステータス遷移をシミュレートするものとなっております。そのため、ダミ ーモードの動作は本番取引と全く同じというわけではありません。 特に Search にて返戻される内部トランザクション情報につきましては、トランザクションが生成されるタイミングにズレが 発生することがあります。あるトランザクションの情報が、ダミーモードで取得できるタイミングと、本番取引で取得できるタ イミングが異なる場合があります。 必ず本番モードでも十分な試験を実施してください。 なお、本番と動作が異なる部分については、本番取引の動作を正とします。 3.2 クレジットカード決済 クレジットカード決済のテストを行うには、以下に指定したテスト用のカード番号を用いてテストを行います。 下記テストカード番号と任意の有効期限（一部を除く）を設定いただくと、成功レスポンスが戻ります。実在のクレジットカ ードを用いた場合はすべてエラーとなりますのでご注意ください。 テストカード以外で取引を実施された場合、vResultCode は「NH02」となります。 ◆テスト用クレジットカード番号 VISA 4111111111111111 5555555555554444 MasterCard 5105105105105100 5500000000000004 3528000000000007 JCB 3528000000000015 3528000000000023 3530111333300000 378282246310005 AMEX 371449635398431 377752749896404 341111111111111 Diners 36666666666660 その他 6950695069506958 また、出現頻度の高いエラーの異常系テストを実施できるよう、テストカード番号と合わせて下記の有効期限を入力頂く ことで、エラーレスポンスが戻ります。 8 OricoPayment Plus 導入テストガイド ◆エラーレスポンス用有効期限 vResultCode 有効期限（MMYY） vResultCode 有効期限（MMYY） AG33 0199 AG61 0999 AG41 0299 AG49 1099 AG64 0399 AG48 1199 AG39 0499 AG44 1299 AG45 0599 AG47 0198 AG70 0699 AG71 0298 AG46 0799 AG51 0398 AG72 0899 ◆AuthCode のレスポンス テスト時に返戻される承認番号(AuthCode)は固定値となっております。 <与信時> 取引成功：[000000]を返します。 取引失敗：[123456]を返します。 <キャンセル時> 取引成功：[000000] を返します。 取引失敗：与信に成功してキャンセルで失敗するパターンはありません。 3.3 MPI ホスティング MPI ホスティングにおける 3D-Secure のテストは、発行カード会社対応状況、カード保有者パスワード登録状況、マーチャ ント設定（認証実行不可のカードの決済を許可する、しないなど）により複雑なパターンが存在します。 それぞれのテストパターンについてテストカード番号を準備しております。 カード番号により、本人認証成功、失敗、認証不可、異常終了等のシナリオテストが実施可能です。 詳細は、別資料「MPI 補足資料」をご参照ください。 3.4 コンビニ決済 決済申込 決済申込のリクエスト電文要素である電話番号（”telNo”）の値で応答を指定します。 ・電話番号の上二桁が、「09」、「08」、「07」、「06」、「05」の場合 ⇒ success を戻します。 ・電話番号の上二桁が、上記以外 ⇒ failure を戻します。 ※failure の場合、vResultCode は「DG18」、「DG23」、「DG32」、「DG34」、「DG37」、「DH15」のいずれかとなりま す。 9 OricoPayment Plus 導入テストガイド 決済キャンセル 【前提条件】決済サービスオプション（”serviceOptionType”）に「other」を指定し、かつ電話番号（”telNo”）に 「06」もしくは「05」をセットした決済申込が成功している事。 上記、取引に対してキャンセル処理を行うと success を戻します。 それ以外の取引は全て failure となります。 ※failure の場合、vResultCode は「DG37」、「DH15」となります。 入金済ステータスに関するダミーモードと本番取引との差異 コンビニ種別により、OricoPayment Plus 内部での取引ステータス遷移は異なります。入金通知電文インターフェー スや MAP 上の表記につきましては横並びとなる仕様となっておりますが、Search リクエストに対して返戻するトラ ンザクション情報は、内部的なステータスとなるためコンビニ種別によって異なります。 具体的な例として、セブン－イレブン（"sej")の場合、ダミーモードの取引では、疑似入金済となるタイミングで「速報 (capture)」と「確報(fix_capture)」のトランザクションデータが作成されますが、本番取引では消費者の入金があり、 MAP 上で入金済になるタイミングでは「capture」のみが作られ、「fix_capture」のトランザクションデータは作成されま せん。「fix_capture」は後日セブン－イレブンより取得する確報データ(*1)取り込み時に作成されます。 バッチプログラムから Search で入金済みを確認する方式を検討する際には、この点を考慮して条件を設定してく ださい。 なお、イーコン（"econ")、その他（"other"）は、「capture」のデータは作成されません。消費者の入金があり、MAP 上で入金済となるタイミングで「fix_capture」のトランザクションデータが作成されます。 (*1) 確報データの反映は入金通知では通知されません。また MAP 上の表記も変化いたしません。 3.5 電子マネー決済 テストアカウント、または本番アカウントにて DUMMY_REQUEST を”1”に設定している場合、決済センターからのメール送 信は行われません。 本番アカウントにて DUMMY_REQUEST を”0”設定した本番お取引の場合のみ、OricoPayment Plus より決済センターへ要 求電文が送られます。決済センターでの処理後、要求電文の mailAddr、および merchantMailAddr に指定されたメールア ドレスへ、決済センターからのメールが送信されます。 Edy、Suica のテスト仕様 決済申込のリクエスト電文要素である決済金額（”amount”）の値で応答を指定します。 ・決済金額の下一桁が、「0」、「1」、「2」、「3」、「4」の場合 ⇒ success を戻します。 ・決済金額の下一桁が、上記以外 ⇒ failure を戻します。 ※failure の場合、vResultCode は「EE06」、「EH11」、「EG45」となります。 10 OricoPayment Plus 導入テストガイド Waon のテスト仕様 決済申込 決済申込のリクエスト電文要素である決済金額（”amount”）の値で応答を指定します。 ・決済金額の下一桁が、「1」、「4」、「5」、「8」の場合 ⇒ success を戻します。 ・決済金額の下一桁が、上記以外 ⇒ failure を戻します。 ※failure の場合、vResultCode は「EE06」、「EH11」、「EG45」のいずれかとなります。 返金申込 返金申込のリクエスト電文要素である返金金額（”amount”）の値で応答を指定します。 ・決済金額の下一桁が、「1」の場合 ⇒ success を戻します。 ・決済金額の下一桁が、上記以外 ⇒ failure を戻します。 ※failure の場合、vResultCode は「EE06」、「EH11」、「EG45」のいずれかとなります。 3.6 銀行決済 決済申込のリクエスト電文要素である決済金額（”amount”）の値で応答を指定します。 ・決済金額の下一桁が、「0」の場合 ⇒ success を戻します。 ・決済金額の下一桁が、上記以外 ⇒ failure を戻します。 （ネットバンク決済の場合、Authorize の応答は success となり金融機関選択時にエラーが発生します） ※failure の場合、vResultCode は「PG01」～「PG10」、「PH11」、「PE05」のいずれかとなります。 3.7 Paypal 決済 MDK 設定ファイルの DUMMY_REQUEST 項目を"1"（ダミーモード ON）に設定の上、テストを実施してください。 各言語のサンプルプログラムは、【OricoPayment Plus MDK インストールガイド】を参照し、環境を設定してください。 3.7.1 金額とエラーコードの対応 決済申込のリクエスト電文要素である決済金額（"amount"）の値を調整することで、意図した結果応答を得ることができ ます。各コマンドにおける決済金額とアクションタイプ（"action"）の組み合わせに対して返戻される vResultCode の対応 表を以下に記載します。 ※以下、コマンドとアクションタイプの組合せを「コマンド（アクションタイプ）」と表記します。（例 Authorize（set） ） 11 OricoPayment Plus 導入テストガイド 与信（Authorize）コマンドにおける決済金額の下 1 桁の値と返戻される vResultCode Authorize コマンド 金額の 下1桁 set 0 L001 （成功） 1 LG04 2 get ※1 do ※1 L001 （成功） L001 （成功） LG04 3 LG04 4 5 L001 （成功） 6 L001 （成功） L001 （成功） 7 8 9 L002 （ペンディング） ※1：Authorize（get）、Authorize（do）は、Authorize（set）時に指定した決済金額の値にて処理を行います。 このため、Authorize（get）、Authorize（do）にて特定の vResultCode を返戻させたい場合は、Authorize（set）時の決済 金額の下 1 桁を発生させたい vResultCode に対応する値に調整します。 例）Authorize（get）時に「LG04」のエラーを発生させたい場合 ⇒Authorize（set）時の決済金額の下 1 桁を「2」に調整します。 売上（Capture）コマンドにおける決済金額の下 1 桁の値と返戻される vResultCode Capture コマンド 金額の 下1桁 set 0 L001 （成功） 1 LG04 2 get ※2 do ※2 L001 （成功） L001 （成功） LG04 3 6 L001 （成功） LG04 4 5 capture ※3 LG02 L001 （成功） L001 （成功） L001 （成功） L001 （成功） 7 8 L002 （ペンディング） 9 L002 （ペンディング） L001 （成功） ※2：Capture（get）、Capture（do）は、Capture（set）時に指定した決済金額の値にて処理を行います。 このため、Capture（get）、Capture（do）にて特定の vResultCode を発生させたい場合は、Capture（set）時の決済金額 の下 1 桁を発生させたい vResultCode に対応する値に調整します。 例）Capture（do）時に「LG04」のエラーを発生させたい場合 ⇒Capture（set）時の決済金額の下 1 桁を「3」に調整します。 12 OricoPayment Plus 導入テストガイド ※3：与信処理が完了している取引に対して Capture（capture）を行い、当該取引を売上の状態にします。 例）Capture（capture）時に「LG02」のエラーを発生させたい場合 ⇒Capture（capture）時の決済金額の下 1 桁を「4」に調整します。 キャンセル（Cancel）コマンド、返金（Refund）コマンドにおける決済金額の下 1 桁の値と返戻される vResultCode 金額の Cancel Refund 下1桁 コマンド ※4 コマンド ※5 0 1 2 L001 （成功） 3 L001 （成功） 4 5 LG02 6 7 8 LG06 L001 （成功） L001 （成功） 9 ※4：与信処理が完了している取引に対してキャンセルを行います。（キャンセル処理は、Authorize（do）が完了している 処理に対してのみ実施可能です） 例）Cancel 時に「LG02」のエラーを発生させたい場合 ⇒Cancel 時の決済金額の下 1 桁を「5」に調整します。 ※5：売上処理が完了している取引に対して返金を行います。（返金処理は、Capture（do）、または Capture（capture）が 完了している取引に対して実施可能です。） 例）Refund 時に「LG06」のエラーを発生させたい場合 ⇒Refund 時の決済金額の下 1 桁を「6」に調整します。 13 OricoPayment Plus 導入テストガイド 3.7.2 ダミー決済センター PayPal 決済のテスト環境として、「ダミー決済センター」と呼ばれる決済センターの擬似環境を提供しています。 ダミー決済センターは、実際の PayPal 側決済センターでの画面遷移をシミュレートする形で実装しておりますが、必ずし も一致するとは限りませんのでご注意ください。 また、画面のデザインは、実際の PayPal 側決済センターとは異なります。 ダミー決済センター ログイン画面（PayPal） ダミーモードが正しく設定されていれば、PayPal ダミー決済センター ログイン画面に接続されます。 「ログイン」ボタンを押下して、次に進みます。 ※ダミー決済センターのログイン画面では、PayPal のアカウント ID とパスワードの入力は不要です。 ※実際の PayPal 側決済センターでは、PayPal のアカウント ID とパスワードの入力を求められる場合があります。 14 OricoPayment Plus 導入テストガイド ダミー決済センター 確認画面（PayPal） ダミー決済センター ログイン画面にて「ログイン」ボタンを押下すると、ダミー決済センター 確認画面に進みます。 「継続」ボタンを押下して、次に進みます。サンプルプログラムの設定ファイルに指定した戻り先 URL に画面が遷移し ます。 「キャンセル」ボタンを押下した場合、サンプルプログラムの設定ファイルに指定した取消 URL に画面が遷移します。 ※サンプルプログラムの設定ファイルの設定方法は、【OricoPayment Plus MDK インストールガイド】を参照してくださ い。 15 OricoPayment Plus 導入テストガイド 3.8 銀聯ネット決済（UPOP） ■ 決済申込 MDKをダミーモードで実施ください(MDK設定ファイルのDUMMY_REQUEST項目を”1”へ設定する)。 Java,PHPのサンプルプログラムはインストールガイドを参考に設定してください。下記は決済画面例となります。 銀聯ネット決済(UPOP)の開始画面 ダミーモードが正しく設定されていれば、UPOP ダミーセンターに接続されます。 UPOP ダミーセンター UPOP 側から消費者へ戻り、加盟店サイトに結果を戻ります。 16 OricoPayment Plus 導入テストガイド 決済結果画面 ■ 売上、取消、返金 売上申込とは、与信成功後の取引に対する売上処理を指します（与信時にwithCapture項目を”1”に 設定する事によって、与信処理と売上処理を同時に実行する事もできます）。 取消とは成功した売上と成功した与信に対する連続処理となり、返金とは成功した売上取引に対する取消処理 となります。売上の場合、当日のみ取消が可能で、翌日以降は返金処理となります。 エラー系テストにつきまして、与信のみ及び与信売上については、UPOPダミー決済センターの プルダウンメニューにてテスト可能です。 その他のコマンドにおいては、金額を下記テーブルに示した数値を指定する事によって、取消や返金時の各種 失敗ステータスを取得する事ができます。 取消においては与信時において下記の金額を指定して頂き、返金、売上においてはリクエスト時に金額 指定して頂くことで失敗ステータスが返戻されます。 17 OricoPayment Plus 導入テストガイド 金額 vResultCode 2 UG02 3 UG03 6 UG04 11 UG05 14 UG06 15 UG07 20 UG08 21 UG09 36 UG12 39 UG14 40 UG15 41 UG16 42 UG17 83 UG23 上記以外 U001 18 OricoPayment Plus 導入テストガイド 3.9 Alipay 決済 MDK をダミーモードに設定の上、テストを実施してください。(MDK 設定ファイルの DUMMY_REQUEST 項目を”1”（ダ ミーモード ON）に設定します) Java,PHP のサンプルプログラムは各インストールガイドを参照し、環境を設定してください。 Alipay 決済のテスト環境として、Alipay ダミーセンターと呼ばれる Alipay 決済の折り返し環境が提供されています。 Alipay ダミーセンターにて店舗は決済申込、返金申込の成功、失敗をテストできます。 ■ 決済申込 Alipay ダミーセンターにおいて、決済申込成功、決済申込失敗（期限切れ）を選択できます。 これにより Alipay ダミーセンターより、それぞれ決済申込成功、決済申込失敗が返戻され、店舗にて成功、失敗時の 確認を行うことができます。 下記は決済画面例となります。 Alipay 決済の開始画面 ダミーモードが正しく設定されていれば、Alipay ダミーセンターに接続されます。 19 OricoPayment Plus 導入テストガイド Alipay ダミーセンター 下記の情報で Alipay ダミーセンターにログインできます。 ユーザーID：[email protected] パスワード：Dummy123 決済結果選択画面 Alipay 側から消費者へ戻り、加盟店サイトに結果を戻します。 成功、失敗（期限切れ）の折り返しができます。 20 OricoPayment Plus 導入テストガイド 決済結果画面 ■ 返金申込 返金申込とは、成功した売上取引に対する返金処理となります。 Alipayダミーセンターによる返金申込のテストにおいては、「返金理由」に「fail」を指定し返金申込を行うと、「返金申込 失敗」の応答がAlipayダミーセンターより返戻されます。 また、「返金理由」に「fail」以外の文字列を指定し返金申込を行うと、「返金申込成功」の応答がAlipayダミーセンター より返戻されます。 店舗では、「返金理由」の値により返金申込成功・失敗をそれぞれ確認することができます。 21 OricoPayment Plus 導入テストガイド 返金申込結果画面 22 OricoPayment Plus 導入テストガイド 3.10 キャリア決済 MDK 設定ファイルの DUMMY_REQUEST 項目を"1"（ダミーモード ON）に設定の上、テストを実施してください。 各言語のサンプルプログラムは、【OricoPayment Plus MDK インストールガイド】を参照し、環境を設定してください。 3.10.1 金額とエラーコードの対応 決済申込のリクエスト電文要素である決済金額（“amount”）の値を調整することで、意図した結果応答を得ることが できます。各コマンドにおける金額とサービスオプションタイプ（キャリア決済タイプ）の組み合わせに対して返戻され る vResultCode の対応表を以下に記載します。 ■ 決済申込における決済金額の下 1 桁の値と返戻される vResultCode 都度決済、および継続課金の共通の仕様です。 金額の ドコモ au 下1桁 ケータイ払い かんたん決済 ソフトバンク ソフトバンク まとめて支払い まとめて支払い （B） （A） S!まとめて フレッツまとめて 支払い 支払い 0 1 2 W001(成功) W001(成功) W001(成功) 3 4 W001(成功) W001(成功) W001(成功) 5 WG02 WG02 WG02 6 WG04 WG02 WG02 7 WG02 WG02 WG02 8 WG04 WG07 WG07 9 W001(成功) W001(成功) W001(成功) ダミー決済センター*1 にて「購入中止」を選択した場合の vResultCode は「WGU1」となります。 ※1：キャリア決済にて使用するダミー決済センターの詳細については、「3.10.2 ダミー決済センター仕様」をご参照く ださい。 尚、ソフトバンクまとめて支払い（A）の継続課金につきましては、商品番号(itemId)で指定可能な金額が決まります。 金額には、商品番号として入力した値と対応する金額を指定してください。 テスト用アカウントにて利用可能な商品番号と金額の組合せを以下の表に記載します。 本番アカウントにてダミーモードを”1”に設定して取引を行う場合は、ソフトバンクモバイルより払い出されたサービス 識別子と金額をご指定ください。 商品番号 金額 dummy-sc-100000010 10 dummy-sc-100000025 25 23 OricoPayment Plus 導入テストガイド dummy-sc-100000037 37 dummy-sc-100001050 1050 ■ 売上における決済金額の下 1 桁の値と返戻される vResultCode 金額の ドコモ au 下1桁 ケータイ払い かんたん決済 W001(成功) W001(成功) WG02 WG02 ソフトバンク ソフトバンク まとめて支払い まとめて支払い （B） （A） S!まとめて フレッツまとめて 支払い 支払い W001(成功) W001(成功) W001(成功) WG02 WG02 WG02 0 1 2 3 W001(成功) W001(成功) 4 5 6 W001(成功) W001(成功) W001(成功) - - W001(成功) W001(成功) 7 8 9 ※「ソフトバンクまとめて支払い（A）」は与信同時売上のため、売上は対象外となります。 ■ キャンセルにおける決済金額の下 1 桁の値と返戻される vResultCode ソフトバンク ソフトバンク まとめて支払い まとめて支払い （B） （A） 金額の ドコモ au S!まとめて フレッツまとめて 下1桁 ケータイ払い かんたん決済 支払い 支払い W001(成功) W001(成功) W001(成功) W001(成功) WG02 WG02 WG02 WG02 0 1 2 3 4 W001(成功) - - 5 6 W001(成功) - W001(成功) 7 8 9 W001(成功) 24 W001(成功) OricoPayment Plus 導入テストガイド ※「ソフトバンクまとめて支払い（A）」、「S!まとめて支払い」は、キャンセルは対象外となります。 ■ 継続課金終了における決済金額の下 1 桁の値と返戻される vResultCode 金額の ドコモ au 下1桁 ケータイ払い かんたん決済 W001(成功) W001(成功) WG02 WG02 ソフトバンク ソフトバンク まとめて支払い まとめて支払い （B） （A） S!まとめて フレッツまとめて 支払い 支払い - W001(成功) 0 1 W001(成功) 2 3 4 WG02 - 5 6 W001(成功) - - WG06 WG02 WG06 7 8 9 ※「ソフトバンクまとめて支払い（B）」、および「S!まとめて支払い」は継続課金をサポートしないため、対象外となりま す。 25 OricoPayment Plus 導入テストガイド 3.10.2 ダミー決済センター仕様 キャリア決済のテスト環境として、「ダミー決済センター」と呼ばれる決済センターの擬似環境を提供しています。 ダミー決済センターは、実際のキャリア側決済センターでの画面遷移をシミュレートする形で実装しておりますが、必ず しも一致するとは限りませんのでご注意ください。 また、ダミー決済センターは、キャリアと端末種別（PC/スマートフォン/フィーチャーフォン）で動作が異なります。 ■ ドコモケータイ払い（スマートフォン向け） ダミー決済センター – 決済申込：ドコモケータイ払い（スマートフォン向け） OpenID 発行画面 「OpenID を発行する」ボタンを押下して次に進みま す。 ※決済申込時、『OpenID』に正しい OpenID を指定 した場合、この画面はスキップされます。 お支払い方法選択画面（都度決済時のみ） 「電話料金合算支払い」または「ドコモ口座払い」を ラジオボタンで選択します。 「次へ」ボタン押下で次に進みます。 「購入中止」ボタン押下で注文をキャンセルしま す。キャンセルすると、『決済キャンセル時 URL』で 指定した URL に画面が遷移します。 ※継続課金の場合、本画面はスキップされます 26 OricoPayment Plus 導入テストガイド ネットワーク暗証番号入力画面 お支払方法選択画面で【ドコモ口座支払い】を選 択して「次へ」ボタンを押下した場合、本画面に遷 移します。 「次へ」ボタン押下で次に進みます。 「購入中止」ボタン押下で注文をキャンセルしま す。キャンセルすると、『決済キャンセル時 URL』で 指定した URL に画面が遷移します。 ※継続課金の場合、本画面はスキップされます 決済内容確認画面 「承諾して購入する」ボタン押下で次に進みます。 「購入中止」ボタン押下で注文をキャンセルしま す。キャンセルすると『決済キャンセル時 URL』で 指定した URL に画面が遷移します。 ※左記キャプチャは、「電話料金合算支払い」で遷 移した場合のものとなります。 27 OricoPayment Plus 導入テストガイド 決済完了画面 「次へ」ボタンを押下すると『決済完了時 URL』で指 定した URL に遷移します。 28 OricoPayment Plus 導入テストガイド ダミー決済センター – 継続課金終了申込：ドコモケータイ払い（スマートフォン向け） 解除内容確認画面 「解除する」ボタン押下で次に進みます。 「解除中止」ボタン押下で『継続課金終了キャンセ ル時 URL』で指定した URL に遷移します。 解除手続き完了画面。 「次へ」ボタン押下で『継続課金終了完了時 URL』 に指定した URL に遷移します。 29 OricoPayment Plus 導入テストガイド ■ au かんたん決済 都度決済、継続課金ともに、ダミー決済センターの画面遷移は同じです。 ダミー決済センター – 決済申込：au かんたん決済（PC/スマートフォン向け） OpenID 発行画面 「OpenID を発行する」ボタンを押下して次に進みま す。 ※決済申込時、『OpenID』に何らかの文字列を指 定した場合、この画面はスキップされます （OpenID のスキップに関して、ドコモケータイ払 いと仕様が異なります）。 暗証番号入力画面 実際の au の認証画面では、セキュリティパスワー ドを入力する必要がありますが、ダミー決済センタ ーではセキュリティパスワードの入力は不要です。 「キャンセル」ボタン押下で注文をキャンセルしま す。キャンセルすると、『決済キャンセル時 URL』で 指定した URL に画面が遷移します。 「購入する」ボタン押下で『決済完了時 URL』で指 定した URL に画面が遷移します。 30 OricoPayment Plus 導入テストガイド ■ ソフトバンクまとめて支払い（B） ダミー決済センター – 決済申込：ソフトバンクまとめて支払い（B） （PC/スマートフォン向け） ログイン画面 実際のソフトバンクの認証画面では、パスワードを 入力する必要がありますが、ダミー決済センター ではパスワードの入力は不要です。 「同意」ボタン押下で次に進みます。 「キャンセル」ボタン押下で取引結果画面（ログイ ンキャンセル）に進みます。 取引結果画面 上段：ログインキャンセル ログイン画面にて「キャンセル」ボタンを押下すると 本画面に遷移します。 下段：決済キャンセル 決済内容確認画面から「キャンセルして戻る」ボタ ンを押下すると本画面に遷移します。 「次へ」ボタンを押下すると、『決済キャンセル時 URL』で指定した URL に画面が遷移します。 31 OricoPayment Plus 導入テストガイド 決済内容確認画面 「支払う」ボタン押下で次に進みます。 「キャンセルして戻る」ボタン押下で取引結果画面 （決済キャンセル）に進みます。 取引結果画面（決済完了） 「次へ」ボタンを押下すると『決済完了時 URL』で指 定した URL に遷移します。 32 OricoPayment Plus 導入テストガイド ■ ソフトバンクまとめて支払い（A） ダミー決済センター – 決済申込：ソフトバンクまとめて支払い（A） （PC/スマートフォン向け） OpenID 発行画面 「OpenID を発行する」ボタン押下で次に進みます。 確認画面 「キャンセル」ボタンを押下すると『決済キャンセル 時 URL』で指定した URL に遷移します。 「購入」ボタンを押下すると『決済完了時 URL』で指 定した URL に遷移します。 33 OricoPayment Plus 導入テストガイド ダミー決済センター – 継続課金終了：ソフトバンクまとめて支払い（A） （PC/スマートフォン向け） OpenID 発行画面 「OpenID を発行する」ボタン押下で次に進みます。 課金解除同意画面 「キャンセル」ボタンを押下すると『継続課金終了 キャンセル時 URL』で指定した URL に遷移します。 「解除」ボタンを押下すると『継続課金終了完了時 URL』で指定した URL に遷移します。 34 OricoPayment Plus 導入テストガイド ■ S!まとめて支払い ダミー決済センター – 決済申込：S!まとめて支払い（フィーチャーフォン向け） 利用規約同意画面 「同意する」ボタン押下で次に進みます。 「同意しない」ボタン押下で『決済キャンセル時 URL』で指定した URL に遷移します。 パスワード入力画面 「戻る」ボタン を押下する と『 決済キャンセル時 URL』で指定した URL に遷移します。 「実行」ボタンを押下すると『決済完了時 URL』で指 定した URL に遷移します。 35 OricoPayment Plus 導入テストガイド ■ フレッツまとめて支払い 都度決済、継続課金ともに、ダミー決済センターの画面遷移は同じです。 ダミー決済センター – 決済申込：フレッツまとめて支払い （PC/スマートフォン向け） ログイン画面 「ログイン」ボタン押下で次に進みます。 「キャンセル」ボタンを押下すると『決済キャンセル 時 URL』で指定した URL に遷移します。 購入依頼確認画面 「購入」ボタンを押下で次に進みます。 「キャンセル」ボタンを押下すると『決済キャンセル 時 URL』で指定した URL に遷移します。 36 OricoPayment Plus 導入テストガイド 取引結果画面 「OK」ボタンを押下すると『決済完了時 URL』で指 定した URL に遷移します。 37 OricoPayment Plus 導入テストガイド 3.11 ショッピングクレジット決済 MDK 設定ファイルの DUMMY_REQUEST 項目を”1”（ダミーモード ON）に設定の上、テストを実施してください。 各言語のサンプルプログラムは、【OricoPayment Plus MDK インストールガイド】を参照し、環境を設定してください。 ショッピングクレジット決済のテスト環境として、「ダミー Orico Web クレジット申込画面」と呼ばれる Orico Web クレジ ット申込画面のダミー環境を提供しています。 ダミー Orico Web クレジット申込画面は、オリコへの電文送信は行わず、OricoPayment Plus にて擬似的に審査結 果を返戻します。 ダミー Orico Web クレジット申込画面にて、店舗は与信審査結果の承認／否決を選択し、各ケースでの動作をテス トできます。 ■ 決済申込 下記はショッピングクレジット決済申込画面例となります。 ショッピングクレジット決済 決済申込画面 ※ダミーモードが正しく設定されていれば、ダミー Orico Web クレジット申込画面に接続されます。 38 OricoPayment Plus 導入テストガイド ダミー Orico Web クレジット申込画面 ※上記画面はダミー Orico Web クレジット申込画面です。 本番取引では、Orico Web クレジット申込画面が消費者ブラウザに表示されます。 ※ダミー Orico Web クレジット申込画面では、与信審査結果承認／否決を選択できます。 OricoPayment Plus より擬似的に与信審査結果承認／否決を返戻しますので、テストシナリオに合わせて選択して ください。店舗は返戻結果に応じたテストを行うことができます。 ショッピングクレジット決済 決済結果画面 39 OricoPayment Plus 導入テストガイド ※決済結果画面で表示される取引ステータス（”success”／”failure”）は、ショッピングクレジット決済申込の成功／失 敗を意味しています。与信審査結果の承認／否決の意味ではありませんので、注意が必要です。 ※ダミー Orico Web クレジット申込画面で与信審査結果承認／否決のどちらを選択した場合でも 決済処理結果の取引ステータスは”success”が返戻されます。 ただし、ショッピングクレジット決済 決済申込画面での入力値にバリデーションエラーや取引 ID の重複が発生した 場合は、決済処理結果の取引ステータスは” failure”が返戻されます。 40 OricoPayment Plus 導入テストガイド 4. その他 4.1 決済申込後の取引ステータスの変化について コンビニ決済、電子マネー決済、銀行決済は、通常の取引では、決済申込の後に消費者が支払い処理を行って初めて 入金済ステータスとなり、その入金確定情報をマーチャント側で確認、もしくは入金通知を受信して決済完了とします。 ダミーモード環境（MDK 設定ファイルにて「DUMMY_REQUEST = 1」を設定）では、コンビニ決済、電子マネー決済、銀行決 済で”success”となった取引は、20 秒後に自動的に入金済ステータスとなります。 また、電子マネー決済で”success”となった返金申込は、20 秒後に自動的に返金済ステータスとなります。 ただし、Edy の場合はこの限りでなくステータスが変わる迄 10 分程度かかります。 キャリア決済のドコモケータイ払いの「売上」では、ドコモ側で売上要求が“確定”されるまで売上のキャンセルを行うこと ができません。ドコモ側で売上が確定すると、OricoPayment Plus に結果が通知され、OricoPayment Plus 側のステータス も確定し、「キャンセル」を受け付けることが可能な状態となります。 ドコモ側で売上が確定するのは翌日または翌々日となります。詳細については別紙【キャリア決済サービス 補足資料】 を参照してください。 なお、ドコモケータイ払い以外のキャリア決済タイプにつきましてはこのような制限はありません。 ダミーモード環境で実行された「キャリア決済」のドコモケータイ払いの「売上」についても、本番取引と同様のタイミング （翌日または翌々日）で確定されます。 「売上」が確定する前の取引に対して「キャンセル」を実行した場合、WC08（ご指定のコマンドは現在実行できません。） が返戻されます。 4.2 結果通知の受信テストについて 「コンビニ決済」「電子マネー決済」「銀行決済」では、入金済となった取引を PUSH 電文として受信することが可能です。 「Alipay 決済」においては、与信時の決済結果（成功・失敗）、および返金申込時が失敗した場合の決済結果を PUSH 電 文として受信することが可能です。決済ステータス判明後 5 分以内に OricoPayment Plus より PUSH 電文が送信されま す。 尚、Alipay 決済センターでの返金自体の処理は、返金申込を行った翌日以降となります。返金自体の処理結果（成功・失 敗）が判明した後に、OricoPayment Plus より PUSH 電文が送信されます。 Alipay 決済センターから届く清算データと弊社の取引データを比較し、差異が生じた場合に送信される訂正報の通知機 能については、テスト環境ではテストできません。 「キャリア決済」では、決済申込／継続課金終了申し込みを完了させた場合、継続課金結果／継続課金抹消情報を PUSH 電文として受信することが可能です。 キャリア決済では、キャリア側での認証（キャリア側での決済申込確定）の後、店舗様システムに戻る画面遷移の途中で 何らかの理由で離脱してしまう可能性があるため、結果通知の受信は強く推奨させていただいております。 41 OricoPayment Plus 導入テストガイド 「ショッピングクレジット決済」では、オリコ側の与信審査完了後、審査結果がオリコより OricoPayment Plus へ通知されま す。 OricoPayment Plus は審査結果を受信後、店舗様システムへ審査結果通知の PUSH 送信を行います。 ダミーモード環境（MDK 設定ファイルにて「DUMMY_REQUEST = 1」を設定）では、決済完了の 30 秒後にダミー Orico Web クレジット申込画面で選択した与信審査結果に合わせて、OricoPayment Plus から審査結果通知を店舗側へ送信します。 （承認、否決のどちらを選択した場合でも審査結果通知は送信されます） 受信テストを行う場合は、以下のいずれかの方法にてテストを実施してください。 4.2.1 テスト用アカウントでのテスト テスト用アカウントを使用した取引は、すべてダミーモード環境での動作となります。 テスト用アカウントは共用アカウントとなるため、結果通知先 URL に特定の店舗様の URL を登録することはできません。 結果通知受信のテストは、本番アカウントにて実施してください。詳細は、「4.2.2 本番アカウントでのテスト」を参照してくだ さい。 キャリア決済においては、ダミーモード環境では、決済申込電文の「プッシュ URL（pushUrl）」項目で結果通知 URL を指定 することができます。テスト用アカウントを使用する場合、決済申込電文の「プッシュ URL」に店舗様の結果通知受信 URL を設定して決済申込を行ってください。 取引が成功した場合、該当取引に関する結果通知は、決済申込時に指定した URL に対して行われます。 決済申込電文に「プッシュ URL」を指定しなかった場合、結果通知が受信できませんのでご注意ください。 また、本番モード（DUMMY_REQUEST = 0）にて「プッシュ URL」を指定した場合はエラーとなりますのでご注意ください。 4.2.2 本番アカウントでのテスト OricoPayment Plus からの PUSH 電文の送信は、マーチャント ID に紐付いて設定される URL に対して行われます。 店舗にて結果通知の受信テストを行いたい場合は、以下を設定し、テストを実施して下さい。 ① MDK にて本番アカウントを設定 ※ 本番アカウントの発行については弊社営業担当にご連絡下さい。 ② MDK にてダミーモード環境を設定 ③ 本番アカウントでの結果通知受信 URL を、事前に登録申請する ※ テストアカウントは複数のマーチャントが共有しておりますので、個別 URL の設定は出来ません。 ※ 結果通知受信 URL は、MAP の契約情報確認・変更のページより登録申請することが可能です。 ※ ここで登録する URL は本番運用開始後もそのまま適用されます。本番運用開始時に URL を変更 する場合は、別途申請してください。 ※ 登録頂ける URL は HTTP（Port：80）、HTTPS（Port：443）のプロトコル・ポートのみとなります。 ④ 取引を実施する。成功した場合、自動的に取引ステータスが変化し、該当する通知データを送信します。 42 OricoPayment Plus 導入テストガイド 4.3 テスト取引の確認について テストを行った取引は、管理ツールである MAP（https://3g.veritrans.co.jp/maps/orico/）において検索・参照することが 可能です。 4.4 取引 ID について 4.4.1 テスト用アカウントをご利用の場合 共用のテストアカウントは、複数の店舗様にて共用でご利用いただいております。 このため、設定した取引 ID が、他の店舗様が利用した取引 ID と重複し、エラーが発生する場合があります。 取引 ID の重複を避けるため、取引 ID に店舗様を特定する文字列（社名、サイト名等）を含めていただくことを推奨してい ます。 4.4.2 本番アカウントをご利用の場合 テスト取引（本番アカウントにて DUMMY_REQUEST = 1 の設定）で使用した取引 ID は、本番取引（本番アカウントにて DUMMY_REQUEST = 0 の設定）で再度使用することはできません。 本番取引開始の際は、取引 ID の採番にご注意ください。 43 OricoPayment Plus 導入テストガイド 5. 付録―サンプル WEB 画面の説明 サンプルプログラムの導入により各決済処理の一連の流れをご確認いただくことができます。 以下にブラウザ用画面サンプルでの入力内容と画面遷移を掲載しますのでご参照下さい。 注）掲載画面は PHP 版のサンプルプログラムを例にしています。 他言語版のサンプルプログラムの場合、画面上の文言に若干差異がある可能性があります。 5.1 OricoPayment Plus – サンプルアプリケーショントップページ OricoPayment Plus – サンプルアプリケーショントップページ 【URL】http://お客様 EC-Site/PaymentMethodSelect.php サンプルアプリケーションのトップ画面です。 各サービスのラジオボタンを選択して各決済の画面に 遷移します。 ※Paypal 決済のテスト実施につきましては、弊社まで お問い合わせください。 44 OricoPayment Plus 導入テストガイド 5.2 クレジットカード（本人認証無し） クレジットカード（本人認証無し） - 決済請求処理 【URL】http://お客様 EC-Site/card/Authorize.php クレジットカード決済(本人認証なし)の与信処理をテス トするための画面です。 ① 取引 ID：自動生成(変更可能) ② 金額：10 円(変更可能) ③ 与信方法：「与信のみ」方式と「与信と売上同時」 方式が選択可能 ④ カード番号：テスト用カード番号を入力 ⑤ 有効期限：テスト用有効期限を入力 ⑥ 支払方法：一括/分割/リボが選択可能 ⑦ 支払回数：分割の場合は設定 ⑧ セキュリティコード：必要な場合は入力 決済処理結果画面には、MDK レスポンス値の一部を 表示しています。 画面下の方に表示されている画像は、trAd（決済連動 型広告）のサンプル画像です。 45 OricoPayment Plus 導入テストガイド 5.3 クレジットカード（3D 認証有り） クレジットカード（3D 認証有り） -決済請求処理 【URL】http://お客様 EC-Site/mpi/Authorize.php 3D-Secure をご利用の場合は当画面からテストが行え ます。 ① 取引 ID：自動生成(変更可能) ② 決済金額：10 円(変更可能) ③ 決済種別：下記４種類を選択可能 ・3D-Secure 認証のみ(決済しない) ・完全認証 ・通常認証(カード会社リスク負担) ・通常認証(カード会社か加盟店リスク負担) ④ 与信方法：与信のみか与信売上同時 ⑤ カード番号：3D-Secure 登録済のカード番号利用 ⑥ 有効期限：上記カードの有効期限 ⑦ 支払方法：一括/分割/リボが選択可能 ⑧ 支払回数：分割の場合は設定 ⑨ セキュリティコード：必要な場合は入力 テスト用の本人認証サイトにリダイレクトします。 ダミーサイトの為、本人認証の為の情報（パスワード 等）の入力は省略します。 「OK」ボタンを押下して次に進みます。 ※本番取引の場合は、この段階で消費者が本人認証 の為の情報（パスワード等）を入力します。 決済処理結果画面です。 MDK レスポンス値の一部を表示しています。 46 OricoPayment Plus 導入テストガイド 5.4 コンビニエンスストア コンビニエンスストア -決済請求処理 【URL】http://お客様 EC-Site/cvs/Authorize.php コンビニ決済請求処理画面です。 ① 取引 ID：自動生成(変更可能) ② 決済サービスオプション：セブンイレブン/イーコン/ デイリーヤマザキ etc. の 3 種類から選択可能 ③ 決済金額：10 円(変更可能) ④ 消費者姓（全角） ⑤ 消費者名（全角） ⑥ 電話番号：ハイフン区切り or ハイフンなしで入力 ⑦ 支払期限：YYYY/MM/DD or YYYYMMDD で入力 決済処理結果画面です。 MDK レスポンス値の一部を表示しています。 一部のコンビニ(この例はセブンイレブンを利用してい ます)では、受付番号とともに払込票 URL がレスポンス に含まれてきます。 ダミー取引では無効な URL が表示されますが、本番取 引の場合は、その URL をクリックすると左のような払込 票が表示されます。 47 OricoPayment Plus 導入テストガイド 5.5 電子マネー 電子マネー -決済請求処理 【URL】http://お客様 EC-Site/em/Authorize.php 電子マネーの決済請求処理画面です。 ① 取引 ID：自動生成(変更可能) ② 以下の決済サービスオプションを選択可能 サイバーEdy 決済 モバイル Edy 決済 モバイル Edy ダイレクト決済 モバイル Suica メール決済 モバイル Suica アプリ決済 Suica インターネットサービス メール決済 Suica インターネットサービス アプリ決済 WAON ネット決済 PC WAON ネット決済モバイル ③ 決済金額：10 円(変更可能) ④ 決済期限：YYYYMMDDhhmmss で指定 ⑤ 支払取消期限：WAON 決済のみ YYYYMMDDhhmmss で指定 ⑥ メールアドレス：決済用メールアドレス指定 決済処理結果画面です。 MDK レスポンス値の一部を表示しています。 48 OricoPayment Plus 導入テストガイド 5.6 銀行 銀行 -決済請求処理 【URL】http://お客様 EC-Site/bank/Authorize.php 銀行決済請求処理画面です。 ① 取引 ID：自動生成(変更可能) ② 以下の決済サービスオプションを選択可能 ATM 決済 ネットバンク（PC/docomo/Softbank/au） ③ 決済金額：10 円(変更可能) ④ 消費者姓（全角） ⑤ 消費者姓カナ（全角） ⑥ 支払期限：YYYYMMDD ⑦ 請求内容（漢字）：インフォメーションとして ATM などに表示 ⑧ 請求内容（カナ）：インフォメーションとして ATM などに表示 ※別ウィンドウに表示（ポップアップ） ＜＜ネットバンク決済を選択した場合＞＞ 金融機関選択画面に遷移します。 本番決済では、ここで選択した各金融機関のサイトが別ウィンド ウに表示されます。 ダミー決済では、ダミーの画面が別ウィンドウに表示されます。 この画面で入金確認ボタンをクリックすると、決済完了画面に遷 移します。 注）ダミー決済では、弊社システムで自動的に入金済みとして扱 いますが、本番取引ではお客様が実際に決済を行うことにより入 金済みとなり、入金完了通知が店舗サイトに送信されます。 決済処理結果画面です。 49 OricoPayment Plus 導入テストガイド 5.7 PayPal PayPal 決済 - 決済請求処理 【URL】http://お客様 EC-Site/paypal/Authorize.php PayPal 決済請求処理画面です。 ① 取引 ID：自動生成(変更可能) ② 決済金額：10 円(変更可能) ③ 決済方式：与信同時売上/与信のみから選 択可能 「購入」ボタンを押下すると、ダミー決済センター ログイン画面に遷移します。 ダミー決済センター ログイン画面です。 「ログイン」ボタンを押下して次に進みます。 ※ダミー決済センターのログイン画面では、 PayPal のアカウント ID とパスワードの入力は不 要です。 ※実際の PayPal 側決済センターでは、PayPal の アカウント ID とパスワードの入力を求められる場 合があります。 ダミー決済センター 確認画面です。 「継続」ボタンを押下して、次に進みます。サンプ ルプログラムの設定ファイルに指定した戻り先 URL に画面が遷移します。 「キャンセル」ボタンを押下した場合、サンプルプ ログラムの設定ファイルに指定した取消 URL に 画面が遷移します。 ※サンプルプログラムの設定ファイルの設定方 法は、【Standard MDK インストールガイド】を参 照してください。 50 OricoPayment Plus 導入テストガイド 決済確認画面です。 MDK レスポンス値の一部を表示しています。 確定ボタンを押すと取引が確定します。 決済処理結果画面です。 MDK レスポンス値の一部を表示しています。 51 OricoPayment Plus 導入テストガイド 5.8 銀聯ネット決済(UPOP) 銀聯ネット決済(UPOP) - 与信処理 【URL】http://お客様EC-Site/upop/Authorize.php ① 取引ID：自動生成(変更可能) ② 金額：10円(変更可能) ③ 与信方法：「与信のみ」方式と「与信と売上同時」方 式が選択可能 ダミー決済センター 決済結果の成功、失敗(失敗時のエラーコード)を指定 する事ができます。 決済処理結果画面には、与信の結果を表示していま す。 52 OricoPayment Plus 導入テストガイド 5.9 Alipay 決済 Alipay 決済- 与信処理 【URL】http://お客様EC-Site/alipay/Authorize.php ① 取引ID：自動生成(変更可能) ② 金額：10円(変更可能) ③ 貨幣タイプ：JPY と CNY（選択可能） ④ 商品名：新製品 (変更可能) ⑤ 商品詳細：新製品詳細(変更可能) ※金額はCNYの場合、100以上指定してください。 ダミー決済センター 下記の情報でAlipayダミーセンターにログインします。 ユーザID：[email protected] パスワード： Dummy123 決済結果の成功、失敗（期限切れ）を指定する事ができ ます。 決済処理結果画面には、与信の結果を表示していま す。 53 OricoPayment Plus 導入テストガイド 5.10 キャリア決済 キャリア決済 – 取引選択 【URL】http://お客様 EC-Site/carrier/Menu.php キャリア決済の消費者向けメニューを選択する画面です。 「決済申込」と「継続課金終了請求」が選択できます。 54 OricoPayment Plus 導入テストガイド キャリア決済 – 決済請求 【URL】http://お客様 EC-Site/carrier/Authorize.php 決済申込は当画面からテストが行えます。 1. 取引 ID：自動生成(変更可能) 2. キャリア選択：下記 5 種類を選択可能 ドコモ au ソフトバンクまとめて支払い（B） ソフトバンクまとめて支払い（A） S!まとめて支払い フレッツまとめて支払い 3. 決済金額：10 円(変更可能) 4. 端末種別：下記 3 種類を選択可能 5. PC スマートフォン フィーチャーフォン 商品タイプ：下記 3 種類を選択可能 デジタルコンテンツ 物販 役務 6. 都度継続区分：都度/継続が選択可能 7. 与信方法：与信のみ/与信同時売上を選択可能 8. 本人認証：無し/バイパス/有りが選択可能 9. 初回課金年月日：継続課金のときに入力（フレッツまと めて支払いの場合、DD の部分は 01～25 のみ指定可 能） 10. 継続課金日：01～28 または 99 を入力（フレッツまとめ て支払いの場合は 01～25 を入力） 11. 商品番号：キャリアに合わせた値を入力 12. 商品情報：ドコモ/ソフトバンクまとめて支払い（A）/フ レッツまとめて支払いの場合に設定可能 13. 決済完了時 URL：必要に応じて設定 14. 決済キャンセル時 URL：必要に応じて設定 15. 決済エラー時 URL：必要に応じて設定 16. プッシュ URL：ダミーモードのときのみ設定可能。 17. OpenID ： 同 一 消 費 者 様 に 関 し て 、 以 前 取 得 し た OpenID を設定することができます。 18. フレッツエリア：フレッツまとめて支払いの場合に下記 2 種類を選択可能 東日本 西日本 ※各項目の詳細については、【OricoPayment Plus 開発ガ イド】を参照してください。 55 OricoPayment Plus 導入テストガイド ダミー決済センターのサイトにリダイレクトしますので、 期待する結果に応じてラジオボタン選択、ボタン押下し て先に進みます。 ※左記画面イメージはドコモの場合のダミー決済センタ ー画面となります。ダミー決済センターの仕様につい ては「3.10.2 ダミー決済センター仕様」を参照してくだ さい。 決済処理結果画面です。 MDK レスポンス値の一部を表示しています。 56 OricoPayment Plus 導入テストガイド キャリア決済 – 継続課金終了（３者間） 【URL】http://お客様 EC-Site/carrier/Terminate.php 消費者の端末を介する継続課金終了は当画面からテスト が行えます。 1. キャリア選択：キャリアを選択可能 2. 取引 ID：自動生成(変更可能) 3. 端末種別：下記 3 種類を選択可能 PC スマートフォン フィーチャーフォン 4. 継続課金終了完了時 URL：必要に応じて設定 5. 継続課金終了キャンセル時 URL：必要に応じて設定 6. 継続課金終了エラー時 URL：必要に応じて設定 7. プッシュ URL：ダミーモードのときのみ設定可能。 ※各項目の詳細については、【OricoPayment Plus 開発ガ イド別冊 キャリア決済】を参照してください。 ダミー決済センターのサイトにリダイレクトしますので、期待 する結果に応じてボタン押下して先に進みます。 ※左記画面イメージはドコモの場合のダミー決済センター 画面となります。 57 OricoPayment Plus 導入テストガイド 継続課金終了処理結果画面です。 MDK レスポンス値の一部を表示しています。 58 OricoPayment Plus 導入テストガイド 5.11 ショッピングクレジット決済 ショッピングクレジット決済- 決済申込処理 【URL】http://お客様EC-Site/oricosc/Authorize.php ショッピングクレジット決済 決済申込画面 ① 取引ID：自動生成(変更可能) ② 注文番号：サンプルプログラムでは自動的に取引ID の値が入力されます。 ③ 会員番号：会員番号を入力 ④ 配送先郵便番号：配送先郵便番号を入力 （000-0000形式） ⑤ 取扱契約番号：取扱契約番号を入力 ⑥ 契約書有無区分：契約書有無区分を入力 "0"：契約書無し "1"：契約書有り ⑦ Web申込商品ID：Web申込商品IDを入力 ⑧ 商品1－商品名：商品名1を入力 ⑨ 商品1－数量：数量1を入力 ⑩ 商品1－商品価格（税込）：商品価格1（税込）を入力 ※商品1の入力は必須です。 必要に応じて商品2から商品5の商品名、数量、 商品価格（税込）も設定できます。 ⑪ 商品価格合計（税込）：サンプルプログラムでは自動 的に商品価格合計（税込）の値が入力されます。 ⑫ 送料合計（税込）：送料合計（税込）を入力 ⑬ 支払金額合計：サンプルプログラムでは自動的に支 払金額合計の値が入力されます。 ⑭ 頭金：頭金を入力（指定なしの場合は0円として扱い ます） ※各項目の書式・制限等の詳細は【OricoPayment Plus 開発ガイド】を参照してください。 59 OricoPayment Plus 導入テストガイド ダミー Orico Web クレジット申込画面 ① 与信審査結果：与信審査結果の承認、否決を指定 することができます。 ② 支払回数：支払回数を選択します。 " 1"，" 10"，" 100"，" 180":普通分割支払回数 " B01":ボーナス一括 " B02":ボーナスニ括 ショッピングクレジット決済 決済結果画面 決済処理結果画面には、ショッピングクレジット決済申 込の処理結果を表示します。 ※決済結果画面で表示される取引ステータス（” success”／”failure”）は、ショッピングクレジット決済 申込の成功／失敗を意味しています。与信審査結果 の承認／否決の意味ではありませんので、注意が必 要です。 60 OricoPayment Plus 導入テストガイド 5.12 取引管理メニュー 取引管理メニュー 【URL】http://お客様 EC-Site/AdminMenu.php 取引管理メニュー画面です。 各サービスの決済請求以外の処理を実行できます。 61 OricoPayment Plus 導入テストガイド 5.12.1 カード決済 カード決済 – 売上請求処理 【URL】http://お客様 EC-Site/card/Capture.php カード売上処理画面です。 ① 取引 ID：対象取引 ID を入力 ② 売上金額：与信処理金額以内の数値を入力 カード売上処理結果画面です。 MDK レスポンス値の一部を出力しています。 62 OricoPayment Plus 導入テストガイド カード決済 – 取消請求処理 【URL】http://お客様 EC-Site/card/Cancel.php カード取消処理画面です。 ① 取引 ID：キャンセル対象取引 ID ② 取消金額：取消対象取引金額以内の数値を入力 してください(指定なしの場合は全額キャンセルと なります) カード取消処理結果画面です。 MDK レスポンス値の一部を出力しています。 63 OricoPayment Plus 導入テストガイド カード決済 – 再与信請求処理 【URL】http://お客様 EC-Site /card/ReAuthorize.php カード再与信処理画面です。 ① 取引 ID：自動生成(変更可能) ② 元取引 ID：再与信対象取引 ID ③ 金額：再与信時の金額を設定 ④ 与信方法：「与信のみ」方式と「与信と売上同時」 方式が選択可能 ⑤ 支払方法：一括/分割/リボが選択可能 ⑥ 支払回数：分割の場合は設定 ⑦ セキュリティコード：必要な場合は入力 カード再与信処理結果画面です。 MDK レスポンス値の一部を出力しています。 64 OricoPayment Plus 導入テストガイド 5.12.2 MPI 取引 MPI 取引 – 再与信請求処理 【URL】http://お客様 EC-Site/mpi/ReAuthorize.php MPI 再与信処理画面です。 ① 取引 ID：自動生成(変更可能) ② 決済金額：10 円(変更可能) ③ 決済種別：下記４種類が選択できます。 ・3D-Secure 認証のみ(決済しない) ・完全認証 ・通常認証(カード会社リスク負担) ・通常認証(カード会社か加盟店リスク負担) ④ 与信方法：与信のみか与信売上同時 ⑤ 支払方法：一括/分割/リボが選択可能 ⑥ 支払回数：分割の場合は設定 ⑦ セキュリティコード：必要な場合は入力 テスト用の本人認証サイトにリダイレクトします。 ダミーサイトの為、本人認証の為の情報（パスワード 等）の入力は省略します。 「OK」ボタンを押下して次に進みます。 ※本番取引の場合は、この段階で消費者が本人認証 の為の情報（パスワード等）を入力します。 MPI 再与信処理結果画面です。 MDK レスポンス値の一部を出力しています。 65 OricoPayment Plus 導入テストガイド 5.12.3 コンビニエンスストア コンビニエンスストア – 取消請求処理 【URL】http://お客様 EC-Site/cvs/Cancel.php コンビニ取消処理画面 ① 決済サービスオプション：セブンイレブン/イーコン デイリーヤマザキ etc. の 3 種類から選択可能 ② 取引 ID: 決済請求時の取引 ID を入力してください コンビニ取消処理結果画面 MDK レスポンス値の一部を出力しています。 66 OricoPayment Plus 導入テストガイド 5.12.4 電子マネー 電子マネー – 取消請求処理 ※Suica のみ対応しています。 【URL】http://お客様 EC-Site/em/Cancel.php 電子マネー取消処理画面です。 ① 決済サービスオプション：Suica 決済の４種類が選 択可能 ② 取引 ID：取消対象取引の ID ③ オーダー種別：取消対象のオーダー種別(決済請 求/返金) 電子マネー取消結果画面です。 MDK レスポンス値の一部を出力しています。 67 OricoPayment Plus 導入テストガイド 電子マネー – 返金請求処理 【URL】http://お客様 EC-Site/em/Refund.php 電子マネー返金処理画面です。 ① 決済サービスオプション：サイバーEdy 決済/モバ イル Edy 決済/モバイル Edy ダイレクト決済/モバ イル Suica メール決済/モバイル Suica アプリ決 済/Suica インターネットサービス メール決済 /Suica インターネットサービス アプリ決済/WAON ネット決済 PC/WAON ネット決済モバイル ② 決済金額: ③ 対象取引 ID：取消対象取引の ID ④ 決済期限:YYYYMMDDhhmmss で指定可能 ⑤ 画面タイトル: 電子マネー返金結果画面 MDK レスポンス値の一部を出力しています。 68 OricoPayment Plus 導入テストガイド 5.12.5 PayPal PayPal – 売上請求処理 【URL】http://お客様 EC-Site/paypal/Capture.php PayPal 売上処理画面です。 ① 取引 ID: 売上対象取引の ID ② 売上金額: PayPal 売上処理結果画面です。 MDK レスポンス値の一部を出力しています。 69 OricoPayment Plus 導入テストガイド PayPal – 取消請求処理 【URL】http://お客様 EC-Site/paypal/Cancel.php PayPal 取消処理画面です。 ① 取引 ID: 取消対象取引の ID PayPal 取消処理結果画面です。 MDK レスポンス値の一部を出力しています。 70 OricoPayment Plus 導入テストガイド PayPal – 返金請求処理 【URL】http://お客様 EC-Site/paypal/Refund.php PayPal 返金処理画面です。 ① 返金対象取引 ID: 返金対象取引の ID ② 返金金額: PayPal 返金処理結果画面です。 MDK レスポンス値の一部を出力しています。 71 OricoPayment Plus 導入テストガイド 5.12.6 銀聯ネット決済(UPOP) 銀聯ネット決済(UPOP) - 売上処理 【URL】http://お客様EC-Site/upop/Capture.php ① 取引ID：売上対象ID ② 金額：売上金額 決済処理結果画面には、売上処理のレスポンス値を表 示しています。 72 OricoPayment Plus 導入テストガイド 銀聯ネット決済(UPOP) - 取消(キャンセル)処理 【URL】http://お客様EC-Site/upop/Cancel.php ① 取引ID：取消対象ID 決済処理結果画面には、キャンセル処理のレスポンス 値を表示しています。 73 OricoPayment Plus 導入テストガイド 銀聯ネット決済(UPOP) - 返金処理 【URL】http://お客様EC-Site/upop/Refund.php ① 取引ID：返金対象ID ② 金額：返金金額 決済処理結果画面には、返金処理レスポンス値を表示 しています。 74 OricoPayment Plus 導入テストガイド 5.12.7 Alipay 決済 Alipay 決済 -返金処理 【URL】http://お客様EC-Site/alipay/Refund.php ① 取引ID：返金対象ID(変更可能) ② 金額：返金金額(変更可能) ③ 返金理由：返金理由を記入(変更可能) 決済処理結果画面には、返金処理レスポンス値を表示 しています。 75 OricoPayment Plus 導入テストガイド 5.12.8 キャリア決済 キャリア決済 – 売上請求処理 【URL】http://お客様 EC-Site/carrier/Capture.php キャリア決済売上処理画面です。 ① キャリア選択：キャリアを選択可能 ② 取引 ID：対象取引 ID を入力 キャリア売上処理結果画面です。 MDK レスポンス値の一部を出力しています。 76 OricoPayment Plus 導入テストガイド キャリア決済 – キャンセル請求処理 【URL】http://お客様 EC-Site/carrier/Cancel.php キャリア決済キャンセル処理画面です。 ① キャリア選択：キャリアを選択可能 ② 取引 ID：対象取引 ID を入力 ③ 課金取消月：継続課金でキャンセル可能なキャリ アの場合に指定可能。 キャリア決済キャンセル処理結果画面です。 MDK レスポンス値の一部を出力しています。 77 OricoPayment Plus 導入テストガイド キャリア決済 – 継続課金終了（２者間） 【URL】http://お客様 EC-Site/carrier/Terminate_Admin.php 消費者の端末を介さない継続課金終了は当画面から テストが行えます。 1. キャリア選択：キャリアを選択可能 2. 取引 ID：対象取引 ID を入力 3. プッシュ URL：ダミーモードのときのみ設定可能。 継続課金終了処理結果画面です。 MDK レスポンス値の一部を出力しています。 78 OricoPayment Plus 導入テストガイド 5.12.9 銀行 銀行 – 決済金融機関一覧 【URL】http://お客様 EC-Site/bank/BankList.php 銀行決済金融機関一覧画面です。 銀行コード、銀行名の一覧が表示されます。 79 OricoPayment Plus 導入テストガイド 5.12.10 Search 処理 Search 処理 【URL】http://お客様 EC-Site/search/Search.php Search 処理画面です。 ① 決済サービスタイプ: カード/MPI/電子マネー/コンビニ/ 銀行/ 銀聯ネット（ UPOP）/PayPal/永久不滅ポイント /Alipay/キャリア決済/ショッピングクレジット決済から選 択できます。 ② 取引 ID: Serch 対象の取引 ID ③ リクエスト ID: Search 対象のリクエスト ID ④ コマンド: Authorize/ReAuthorize/Capture/Cancel/Refund/Retry/Verif y/Terminate から選択できます。 ⑤ ステータスコード:success/failure/pending から選択でき ます。 ⑥ オーダー決済状態: end/end_presentation/pending/expired/error/validation_error /initial から選択できます。 ⑦ 取引日時(From～To): YYYYMMDDhhmm で指定できま す。 ⑧ 金額(From～To): Serch 対象の金額 ⑨ サービス固有項目: 決済サービスタイプのチェックボッ クスをチェックすると各サービス固有の検索項目が表示 されます。 Search 処理結果画面です。 検索結果が表示されます。 ※キャリア決済のみ、取引 ID にハイパーリンクが設定されま す。 80 OricoPayment Plus 導入テストガイド Search 詳細 – キャリア決済 【URL】http://お客様 EC-Site/search/carrier/SearchExec.php?orderId=オーダーID キャリア決済検索結果詳細画面です。 該当取引のオーダー情報、固有オーダー情報、トランザクショ ン情報（決済・固有）が表示されます。 81
© Copyright 2024 Paperzz
