Edy、Suicaのテスト仕様

決済申込のリクエスト電文要素である決済金額（"amount"）の値で応答を指定します。

※failureの場合、vResultCodeは「EE06」、「EH11」、「EG45」となります。

Waonのテスト仕様

決済申込

決済申込のリクエスト電文要素である決済金額（"amount"）の値で応答を指定します。

※failureの場合、vResultCodeは「EE06」、「EH11」、「EG45」のいずれかとなります。

返金申込

返金申込のリクエスト電文要素である返金金額（"amount"）の値で応答を指定します。

※failureの場合、vResultCodeは「EE06」、「EH11」、「EG45」のいずれかとなります。

nanacoのテスト仕様

MDK設定ファイルのDUMMY_REQUEST項目を"1"（ダミーモードON）に設定の上、テストを実施してください。
MDK、サンプルプログラムの環境設定については、『MDK インストールガイド』を参照してください。

金額、ユーザIDとエラーコードの対応

決済申込のリクエスト電文要素である決済金額（"amount"）の値を調整することで、意図した結果応答を得ることができます。
各コマンドにおいて、決済金額により返戻されるvResultCodeの対応表を以下に記載します。
尚、Remove（カード情報削除）の場合は、決済申込のリクエスト電文要素であるユーザID（"userId"）の値を調整します。

（Ａ）Authorize（決済申込）

Authorize（決済申込）の要求電文の決済金額の下3桁を下記の値に調整すると、対応するvResultCodeが返戻されます。
尚、決済金額の下3桁を下記表以外の値に調整した場合、vResultCode はE001（成功）が返戻されます。

※1：ダミー決済センターは表示されません。

尚、※1以外のダミー決済センターが表示されるケースでは、最終的にダミー決済センターより返戻されるvResultCodeの値を「vResultCode」に記載しています。

（Ｂ）ReAuthorize（再決済申込）

ReAuthorize（再決済申込）時に以下の表のvResultCodeを返戻させたい場合は、Authorize（決済申込）の要求電文の決済金額の下3桁を対応する値に調整してください。
下記表の「決済申込時の金額下3桁」に調整した決済金額を設定し、Authorize（決済申込）リクエストを行うと、決済申込では、「決済申込時のvResultCode」に記載のvResultCodeが返戻されます。Authorize（決済申込）時の取引ID（"orderId"）を指定してReAuthorize（再決済申込）リクエストを行うと、「再決済申込時のvResultCode」に記載のvResultCodeが返戻されます。
尚、Authorize（決済申込）の要求電文の決済金額の下3桁に下記表以外の値を設定した場合は、ReAuthorize（再決済申込）処理はできません。

例）「再決済申込時のvResultCode」でE001を返戻させたい場合

1. 決済金額の下3桁に「201」を指定し、Authorize（決済申込）リクエストを行います。
2. Authorize（決済申込）の応答で返戻された取引ID（"orderId"）を控えておきます。（この時、Authorize（決済申込）にて最終的にダミー決済センターから返戻されるvResultCodeは「EG61」です。）
3. 2.で控えた取引ID（"orderId"）を指定して、ReAuthorize（再決済申込）リクエストを行います。
4. ReAuthorize（再決済申込）の応答で「E001」が返戻されます。

（Ｃ）Cancel（キャンセル）

1. ダミー決済センターでの離脱以外のケース

   ダミー決済センターで離脱以外のケースにおいて、Cancel（キャンセル）処理はできません。この場合、vResultCodeはEC07が返戻されます。

2. ダミー決済センターでの離脱のケース

   本番取引の場合、取引の有効期限は決済申込日より3日となります。取引有効期限内であれば、決済申込を行ったものの、決済は行っていない（取引実施前）取引をキャンセルすることが可能です。取引が有効期限切れとなった場合は、キャンセルできなくなります。この場合、vResultCodeはEG56が返戻されます。
   ダミーモードの場合は、ダミー決済センターで「OK」ボタンを押下せず離脱することにより、「決済申込を行ったものの、決済は行っていない（取引実施前）取引」の状態とすることが可能です。
   尚、ダミーモードの場合は、取引の有効期限を設定しない仕様のため、有効期限切れは発生しません。このため、本番取引とは異なり、決済申込日より3日が過ぎた場合でもキャンセル処理は可能です。

   ダミー決済センターでの離脱のケースにおいて、Cancel（キャンセル時）のvResultCodeで「E001」を返戻させたい場合は、Authorize（決済申込）時の要求電文の決済金額の下3桁を「101から107以外」の値に調整します。
   以下の表のvResultCodeを返戻させたい場合は、Authorize（決済申込）の要求電文の決済金額の下3桁を対応する値に調整します。
   ダミー決済センターでは、「OK」ボタンを押下せず、離脱します。
   Authorize（決済申込）時の取引ID（"orderId"）を指定してCancel（キャンセル）リクエストを行うと、「E001」、または下記表の「キャンセル時のvResultCode」に記載のvResultCodeが返戻されます。

   例1）「キャンセル時のvResultCode」でE001を返戻させたい場合（ダミー決済センターでの離脱のケース）

   1. 決済金額の下3桁に「108」を指定し、Authorize（決済申込）リクエストを行います。この時、取引ID（"orderId"）を控えておきます。
   2. ダミー決済センターで「OK」ボタンを押下せず、離脱します。（戻るボタンで戻る、画面を閉じる等）
   3. a.で控えた取引ID（"orderId"）を指定して、Cancel（キャンセル）リクエストを行います。
   4. Cancel（キャンセル）の応答で「E001」が返戻されます。

   例2）「キャンセル時のvResultCode」でEG46を返戻させたい場合（ダミー決済センターでの離脱のケース）

   1. 決済金額の下3桁に「400」を指定し、Authorize（決済申込）リクエストを行います。この時、取引ID（"orderId"）を控えておきます。
   2. ダミー決済センターで「OK」ボタンを押下せず、離脱します。（戻るボタンで戻る、画面を閉じる等）
   3. a.で控えた取引ID（"orderId"）を指定して、Cancel（キャンセル）リクエストを行います。
   4. Cancel（キャンセル）の応答で「EG51」が返戻されます。

   決済申込時の 金額下3桁	決済申込時の vResultCode	キャンセル時の vResultCode
   400 ※2	－	EG51

   ※2：決済申込時のダミー決済センターで「OK」ボタンを押下しないでください。

（Ｄ）Remove（カード情報削除）

Remove（カード情報削除）時に以下の表のvResultCodeを返戻させたい場合は、Remove（カード情報削除）の要求電文のユーザＩＤの先頭2桁を対応する値に調整してください。

例）Remove（カード情報削除）で「EG46」を発生させたい場合

1. ユーザIDに「01test」を指定（先頭2桁が「01」）し、Remove（カード情報削除）リクエストを行います。
2. Remove（カード情報削除）の応答で「EG46」が返戻されます。

• ダミー決済センター
  nanaco決済のテスト環境として、「ダミー決済センター」と呼ばれる決済センターの擬似環境を提供しています。
  ダミー決済センターは、実際のnanaco側決済センターでの画面遷移をシミュレートする形で実装しておりますが、必ずしも一致するとは限りませんのでご注意ください。
  また、画面のデザインは、実際のnanaco側決済センターとは異なります。

ダミー決済センター（nanaco）

ダミーモードが正しく設定されていれば、ダミー決済センターに接続されます。

「OK」ボタンを押下して、次に進みます。

※「◆ 金額、ユーザIDとエラーコードの対応」の「（Ｃ）Cancel（キャンセル）」の「（２）ダミー決済センターでの離脱のケース」にて、ダミー決済センターからの離脱を行う際は、「OK」ボタンを押下せずにブラウザの「戻る」ボタンで戻る、画面を閉じる等を行い、離脱してください。

金額とエラーコードの対応

決済申込のリクエスト電文要素である決済金額（"amount"）の値を調整することで、意図した結果応答を得ることができます。各コマンドにおける決済金額とアクションタイプ（"action"）の組み合わせに対して返戻されるvResultCodeの対応表を以下に記載します。

※以下、コマンドとアクションタイプの組合せを「コマンド（アクションタイプ）」と表記します。（例 Authorize（set） ）

• 与信（Authorize）コマンドにおける決済金額の下1桁の値と返戻されるvResultCode

  金額の 下1桁	Authorizeコマンド
  	set	get ※1	do ※1
  0	L001 （成功）	L001 （成功）	L001 （成功）
  1	LG04
  2	L001 （成功）	LG04
  3		L001 （成功）	LG04
  4			L001 （成功）
  5
  6
  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

  金額の 下1桁	Captureコマンド
  	set	get※2	do ※2	capture ※3
  0	L001 （成功）	L001 （成功）	L001 （成功）	L001 （成功）
  1	LG04
  2	L001 （成功）	LG04
  3		L001 （成功）	LG04
  4			L001 （成功）	LG02
  5				L001 （成功）
  6
  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」に調整します。

  ※3：与信処理が完了している取引に対してCapture（capture）を行い、当該取引を売上の状態にします。
  例）Capture（capture）時に「LG02」のエラーを発生させたい場合
  ⇒Capture（capture）時の決済金額の下1桁を「4」に調整します。

• キャンセル（Cancel）コマンド、返金（Refund）コマンドにおける決済金額の下1桁の値と返戻されるvResultCode

  金額の 下1桁	Cancel コマンド ※4	Refund コマンド ※5
  			0	L001 （成功）	L001 （成功）
  			1
  2
  3
  4
  5	LG02
  6	L001 （成功）	LG06
  7		L001 （成功）
  8
  9

  ※4：与信処理が完了している取引に対してキャンセルを行います。（キャンセル処理は、Authorize（do）が完了している処理に対してのみ実施可能です）
  例）Cancel時に「LG02」のエラーを発生させたい場合
  ⇒Cancel時の決済金額の下1桁を「5」に調整します。

  ※5：売上処理が完了している取引に対して返金を行います。（返金処理は、Capture（do）、またはCapture（capture）が完了している取引に対して実施可能です。）
  例）Refund時に「LG06」のエラーを発生させたい場合
  ⇒Refund時の決済金額の下1桁を「6」に調整します。

ダミー決済センター

PayPal決済のテスト環境として、「ダミー決済センター」と呼ばれる決済センターの擬似環境を提供しています。
ダミー決済センターは、実際のPayPal側決済センターでの画面遷移をシミュレートする形で実装しておりますが、必ずしも一致するとは限りませんのでご注意ください。
また、画面のデザインは、実際のPayPal側決済センターとは異なります。

• ダミー決済センター ログイン画面（PayPal）

  ダミーモードが正しく設定されていれば、PayPalダミー決済センター ログイン画面に接続されます。

  

  「ログイン」ボタンを押下して、次に進みます。

  ※ダミー決済センターのログイン画面では、PayPalのアカウントIDとパスワードの入力は不要です。
  ※実際のPayPal側決済センターでは、PayPalのアカウントIDとパスワードの入力を求められる場合があります。

• ダミー決済センター 確認画面（PayPal）

  ダミー決済センター ログイン画面にて「ログイン」ボタンを押下すると、ダミー決済センター 確認画面に進みます。

  

  「継続」ボタンを押下して、次に進みます。サンプルプログラムの設定ファイルに指定した戻り先URLに画面が遷移します。
  「キャンセル」ボタンを押下した場合、サンプルプログラムの設定ファイルに指定した取消URLに画面が遷移します。
  

  ※サンプルプログラムの設定ファイルの設定方法は、『MDK インストールガイド』を参照してください。

Alipayオンライン決済

決済申込

Alipayダミーセンターにおいて、決済申込成功、決済申込失敗（期限切れ）を選択できます。
これによりAlipayダミーセンターより、それぞれ決済申込成功、決済申込失敗が返戻され、店舗にて成功、失敗時の確認を行うことができます。
下記は決済画面例となります。

• 決済品目選択画面

  

• Alipay決済の開始画面

  

  ダミーモードが正しく設定されていれば、Alipayダミーセンターに接続されます。

• Alipayダミーセンター

  

  下記の情報でAlipayダミーセンターにログインできます。

  ユーザーID：dummy@veritrans.jp
  パスワード：Dummy123

• 決済結果選択画面

  

  Alipay側から消費者へ戻り、加盟店サイトに結果を戻します。
  成功、失敗（期限切れ）の折り返しができます。

• 決済結果画面

  

返金申込

返金申込とは、成功した売上取引に対する返金処理となります。
Alipayダミーセンターによる返金申込のテストにおいては、「返金理由」に「fail」を指定し返金申込を行うと、「返金申込失敗」の応答がAlipayダミーセンターより返戻されます。
また、「返金理由」に「fail」以外の文字列を指定し返金申込を行うと、「返金申込成功」の応答がAlipayダミーセンターより返戻されます。
店舗では、「返金理由」の値により返金申込成功・失敗をそれぞれ確認することができます。

• 返金申込結果画面

  

Alipayバーコード決済（店舗スキャン型）

Alipayバーコード決済（店舗スキャン型）の決済申込および確認では、申込時の決済金額の値を調整することで、意図した結果応答を得ることができます。
尚、申込/確認時のレスポンスタイプの指定によって金額に対して返戻されるvResultCodeが異なる為、その対応表を以下に記載します。

※1：このケースでは、弊社システムに設定している「決済待ち時間（秒）」経過後に返却します。
MAP（Merchant Administration Portal）で「決済待ち時間」を変更した後の確認にもご利用いただけます。
（実際に設定している時間よりも、数秒遅く返戻される場合があります。）

※2：決済申込でYG12(承認待ち)の結果を取得した場合、
後続の確認コマンドは以下のパターンがありそれぞれで返戻コードが異なります。
1） 決済ステータスが未確定の場合
2） 確認コマンドで決済ステータスの確定結果が得られた場合
3） 決済ステータスが確定済みの場合
尚、決済ステータスがYG12（承認待ち）のまま残っている取引は弊社の決済ステータス確定リカバリ処理にて、決済申込から一定時間が経過するとステータスの確定を行います。

Alipayバーコード決済の返金のテストにおいては、「返金理由」に「fail」を指定し返金申込を行うと、「返金失敗」の応答が返戻されます。（vResultCodeは、「YG10」が返戻されます。）
また、「返金理由」に「fail」以外の文字列を指定し返金を行うと、「返金成功」の応答が返戻されます。

Alipayバーコード決済（消費者スキャン型）

Alipayバーコード決済（消費者スキャン型）の決済申込では、決済金額の値を調整することで、意図した結果応答を得ることができます。
金額に対して返戻されるvResultCodeの対応表を以下に記載します。

決済申込時に指定する「ユーザ識別コード」には、任意の半角英数字32桁以内の値を設定してください。

返金のテストについては「3.10.2Alipayバーコード決済（店舗スキャン型）」と同様です。詳細はこちらをご参照ください。

消費者スキャン型の画面遷移

決済申込

Alipayダミーセンターにおいて、決済申込成功、決済申込失敗を選択できます。
これによりAlipayダミーセンターより、それぞれ決済申込成功、決済申込失敗が返戻され、店舗にて成功、失敗時の確認を行うことができます。
下記は決済画面例となります。

• Alipay決済の開始画面

  

• 決済申込みで受信したQRコード表示

  決済申込みのレスポンスで受信したQRコードを表示します。
  QRコードをスマートフォンなどで読み込むか、「決済」ボタンを押下すると、Alipayダミーセンターに接続します。

  

• Alipayダミーセンター（決済結果選択画面）

  

  「確定」ボタンを押下すると、選択した結果の内容で結果通知を送信します。

  

  ※返金については、Alipayオンライン決済を参照ください。

金額とエラーコードの対応

申込時の決済金額（"amount"）の値を調整することで、意図した結果応答を得られます。返戻されるvResultCodeの対応表を以下に記載します。

• 決済申込における決済金額の下1桁の値と返戻されるvResultCode

  都度決済、および継続課金の共通の仕様です。

  金額の 下1桁	d払い	au かんたん決済	ソフトバンク まとめて支払い （B）	ソフトバンク まとめて支払い （A）	フレッツまとめて支払い
  0	W001(成功)	W001(成功)	W001(成功)	W001(成功)	W001(成功)
  1
  2
  3
  4
  5		WG02		WG02
  6		WG04		WG02
  7		WG02		WG02
  8		WG04		WG07
  9		W001(成功)		W001(成功)

  ダミー決済センターにて「購入中止」を選択した場合のvResultCodeは「WGU1」となります。
  ダミー決済センターの詳細については、「3.11.2ダミー決済センター仕様」をご参照ください。

  ソフトバンクまとめて支払い（A）の継続課金につきましては、商品番号(itemId)で指定可能な金額が決まります。金額には、商品番号として入力した値と対応する金額を指定してください。
  テスト用アカウントにて利用可能な商品番号と金額の組合せを以下の表に記載します。

  商品番号	金額
  dummy-sc-100000010	10
  dummy-sc-100000025	25
  dummy-sc-100000037	37
  dummy-sc-100001050	1050

  本番アカウントにてダミーモードを"1"に設定して取引を行う場合は、ソフトバンクモバイルより払い出されたサービス識別子と金額をご指定ください。

• 売上における決済金額の下1桁の値と返戻されるvResultCode

  金額の 下1桁	d払い	au かんたん決済	ソフトバンク まとめて支払い （B）	ソフトバンク まとめて支払い （A）	フレッツまとめて支払い
  0	W001(成功)	W001(成功)	W001(成功)	-	W001(成功)
  1
  2	WG02	WG02	WG02		WG02
  3	W001(成功)	W001(成功)	W001(成功)		W001(成功)
  4
  5		-
  6
  7
  8
  9		W001(成功)

  ※「ソフトバンクまとめて支払い（A）」は与信同時売上のため、売上は対象外となります。

• キャンセルにおける決済金額の下1桁の値と返戻されるvResultCode

  金額の 下1桁	d払い	au かんたん決済	ソフトバンク まとめて支払い （B）	ソフトバンク まとめて支払い （A）	フレッツまとめて支払い
  0	W001(成功)	W001(成功)	W001(成功)	-	W001(成功)
  1
  2
  3	WG02	WG02	WG02		WG02
  4	W001(成功)	W001(成功)	W001(成功)		W001(成功)
  5		-
  6
  7
  8
  9		W001(成功)

  ※「ソフトバンクまとめて支払い（A）」は、キャンセルは対象外となります。

• 継続課金終了（強制終了）における決済金額の下1桁の値と返戻されるvResultCode

  金額の 下1桁	d払い	au かんたん決済	ソフトバンク まとめて支払い （B）	ソフトバンク まとめて支払い （A）	フレッツまとめて支払い
  0	W001(成功)	W001(成功)	W001(成功)	W001(成功)	W001(成功)
  1
  2
  3
  4	WG02	WG02		WG02
  5	W001(成功)	-		-
  6
  7
  8
  9	WG06	WG02		WG06

  ※「消費者を介する継続課金終了」の場合、このエラーコードは返戻されません。

• 再与信（随時決済）における決済金額の下1桁の値と返戻されるvResultCode

  金額の下1桁	d払い
  0	W001(成功)
  1
  2
  3
  4	WA02
  5	WG12
  6	WG05
  7	WG02
  8	WG04
  9	W001(成功)

  ※随時決済は、d払いのみです。

ダミー決済センター仕様

キャリア決済のテスト環境として、「ダミー決済センター」と呼ばれる決済センターの擬似環境を提供しています。
ダミー決済センターは、実際のキャリア側決済センターでの画面遷移をシミュレートする形で実装しておりますが、必ずしも一致するとは限りませんのでご注意ください。
また、ダミー決済センターは、キャリアと端末種別（PC/スマートフォン/フィーチャーフォン）で動作が異なります。

• d払い（PC/スマートフォン向け）

  ダミー決済センター - 決済申込：d払い（PC/スマートフォン向け）
  	OpenID発行画面 「OpenIDを発行する」ボタンを押下して次に進みます。 ※決済申込時、『OpenID』に正しいOpenIDを指定した場合、この画面はスキップされます。
  	お支払い方法選択画面（都度決済時のみ） 「電話料金合算支払い」または「ドコモ口座払い」をラジオボタンで選択します。 「次へ」ボタン押下で次に進みます。 「購入中止」ボタン押下で注文をキャンセルします。キャンセルすると、『決済キャンセル時URL』で指定したURLに画面が遷移します。 ※継続課金の場合、本画面はスキップされます
  	ネットワーク暗証番号入力画面 お支払方法選択画面で【ドコモ口座支払い】を選択して「次へ」ボタンを押下した場合、本画面に遷移します。 「次へ」ボタン押下で次に進みます。 「購入中止」ボタン押下で注文をキャンセルします。キャンセルすると、『決済キャンセル時URL』で指定したURLに画面が遷移します。 ※継続課金の場合、本画面はスキップされます
  	決済内容確認画面 「承諾して購入する」ボタン押下で次に進みます。 「購入中止」ボタン押下で注文をキャンセルします。キャンセルすると『決済キャンセル時URL』で指定したURLに画面が遷移します。 ※左記キャプチャは、「電話料金合算支払い」で遷移した場合のものとなります。
  	決済完了画面 「次へ」ボタンを押下すると『決済完了時URL』で指定したURLに遷移します。

  ダミー決済センター - 継続課金終了申込：d払い（PC/スマートフォン向け）
  	解除内容確認画面 「解除する」ボタン押下で次に進みます。 「解除中止」ボタン押下で『継続課金終了キャンセル時URL』で指定したURLに遷移します。
  	解除手続き完了画面。 「次へ」ボタン押下で『継続課金終了完了時URL』に指定したURLに遷移します。

• auかんたん決済

  都度決済、継続課金ともに、ダミー決済センターの画面遷移は同じです。

  ダミー決済センター - 決済申込：auかんたん決済（PC/スマートフォン向け）
  	OpenID発行画面 「OpenIDを発行する」ボタンを押下して次に進みます。 ※決済申込時、『OpenID』に何らかの文字列を指定した場合、この画面はスキップされます（OpenIDのスキップに関して、dイ払いと仕様が異なります）。
  	暗証番号入力画面 実際のauの認証画面では、セキュリティパスワードを入力する必要がありますが、ダミー決済センターではセキュリティパスワードの入力は不要です。 「キャンセル」ボタン押下で注文をキャンセルします。キャンセルすると、『決済キャンセル時URL』で指定したURLに画面が遷移します。 「購入する」ボタン押下で『決済完了時URL』で指定したURLに画面が遷移します。

• ソフトバンクまとめて支払い（B）

  ダミー決済センター - 決済申込：ソフトバンクまとめて支払い（B） （PC/スマートフォン向け）
  	ログイン画面 実際のソフトバンクの認証画面では、パスワードを入力する必要がありますが、ダミー決済センターではパスワードの入力は不要です。 「同意」ボタン押下で次に進みます。 「キャンセル」ボタン押下で取引結果画面（ログインキャンセル）に進みます。
  	取引結果画面 上段：ログインキャンセル ログイン画面にて「キャンセル」ボタンを押下すると本画面に遷移します。 下段：決済キャンセル 決済内容確認画面から「キャンセルして戻る」ボタンを押下すると本画面に遷移します。 「次へ」ボタンを押下すると、『決済キャンセル時URL』で指定したURLに画面が遷移します。
  	決済内容確認画面 「支払う」ボタン押下で次に進みます。 「キャンセルして戻る」ボタン押下で取引結果画面（決済キャンセル）に進みます。
  	取引結果画面（決済完了） 「次へ」ボタンを押下すると『決済完了時URL』で指定したURLに遷移します。

• ソフトバンクまとめて支払い（A）

  ダミー決済センター - 決済申込：ソフトバンクまとめて支払い（A） （PC/スマートフォン向け）
  	OpenID発行画面 「OpenIDを発行する」ボタン押下で次に進みます。
  	確認画面 「キャンセル」ボタンを押下すると『決済キャンセル時URL』で指定したURLに遷移します。 「購入」ボタンを押下すると『決済完了時URL』で指定したURLに遷移します。

  ダミー決済センター - 継続課金終了：ソフトバンクまとめて支払い（A） （PC/スマートフォン向け）
  	OpenID発行画面 「OpenIDを発行する」ボタン押下で次に進みます。
  	課金解除同意画面 「キャンセル」ボタンを押下すると『継続課金終了キャンセル時URL』で指定したURLに遷移します。 「解除」ボタンを押下すると『継続課金終了完了時URL』で指定したURLに遷移します。

• フレッツまとめて支払い

  都度決済、継続課金ともに、ダミー決済センターの画面遷移は同じです。

  ダミー決済センター - 決済申込：フレッツまとめて支払い （PC/スマートフォン向け）
  	ログイン画面 「ログイン」ボタン押下で次に進みます。 「キャンセル」ボタンを押下すると『決済キャンセル時URL』で指定したURLに遷移します。
  	購入依頼確認画面 「購入」ボタンを押下で次に進みます。 「キャンセル」ボタンを押下すると『決済キャンセル時URL』で指定したURLに遷移します。
  	取引結果画面 「OK」ボタンを押下すると『決済完了時URL』で指定したURLに遷移します。

MDK利用時の会員管理機能のテスト仕様

共用テストアカウントで登録したダミー会員IDは、「30日程度」で自動削除されます。削除後に会員IDを指定して処理を行うとエラーになりますので、ご注意ください。

CSVファイル授受のテスト仕様

ワンクリック継続課金サービスの会員登録機能、洗替機能、継続課金機能、決済登録機能にて提供しているCSVファイル授受のテスト仕様について記載します。
CSVファイルの授受は、SFTP、またはMAPにて行います。
CSVファイル授受の詳細については、『ワンクリック継続課金サービス 運用ガイド』を参照して下さい。

※共用テストアカウントではsFTPはご利用いただけません。MAPからのアップロードは不可能なアカウントと可能なアカウントがあります。本番アカウントのダミーモードを利用した場合、CSVファイルの送信は可能です。また、CSVファイルが送信されても、その後の処理が実行されるものとされないものがあります。
以下の表をご確認ください。

CSVファイル授受のテスト時は、各機能のCSVファイルフォーマットの「マーチャントID」に使用しているアカウントのマーチャントIDを設定します。また、「データ種別」には、「"1"：ダミーモード」を設定します。
決済登録と会員IDコピーでは、「データ種別」に「"1"：ダミーモード」を設定している場合、SFTP、またはMAPよりアップロードされたファイルは、ダミー取引を実行します。

CSVファイル授受のテスト時に、以下の（１）～（３）に示すパターンで各項目を設定すると、特定のエラーコードが返戻されます。その他のパターンでは、全て「正常」で返戻されます。ただし、バリデーションチェックは行われている為、バリデーションに問題があればエラーが発生し、エラーCSVファイルが返却されます。

※「設定項目n」に対応する「設定値n」を設定します。（例：「設定項目1」に「設定値1」を設定）

（１）会員登録CSVファイル

1. 入会（処理種別："1"）

   設定項目1	設定値1	設定項目2	設定値2	エラー内容	vResultCode
   課金グループID	group001	－	－	未登録の課金グループ	XH08
   会員ID	user0001	－	－	入会中の会員	XH11
   会員ID	user0002	－	－	退会済みの会員	XH12

2. 変更（処理種別："2"）

   設定項目1	設定値1	設定項目2	設定値2	エラー内容	vResultCode
   会員ID	user0002	－	－	退会済の会員	XH12
   課金グループID	group001	－	－	未登録の課金グループ	XH08
   課金グループID	group002	課金グループ処理種別	1	当該課金グループには、当該会員が既に存在している	XH81
   課金グループID	group003	課金グループ処理種別	2	当該課金グループには当該会員が存在しない	XH25
   課金グループID	group004	カード番号	設定しない	決済可能なカードが登録されていない	XH24

3. 退会（処理種別："3"）

   設定項目1	設定値1	設定項目2	設定値2	エラー内容	vResultCode
   課金グループID	group001	－	－	未登録の課金グループ	XH08
   会員ID	user0005	－	－	継続課金情報が登録されているため、退会できない	XH13
   会員ID	user0002	－	－	退会済の会員	XH12

継続課金のテスト方法

2022年3月より、ダミー課金グループを使って継続課金（スケジュール課金）のテストが可能となりました。
2022年4月、固定課金グループに関する仕様を変更しました。

【テスト実施のおおまかな流れ（後続の注意点も必ずご確認ください）】

1. 課金対象の会員（ダミー会員）を用意（登録）してください。
2. テストの決済日を決めてください。

   ※非営業日はお問い合わせへの対応はできないため、平日で設定してください。

3. 決済日に合わせて、MAPより継続課金グループ（ダミー課金グループ）の登録を行います。

   ※データ区分で「テスト」を選択し、課金グループを登録します。

4. ダミー課金グループと課金対象の会員を紐づけます。会員の紐づけはMAP、またはMDK、または決済登録依頼CSVファイルで実行可能です（後述のテスト時の注意点を必ずご確認ください）。
5. 課金日当日の午後、ダミー継続課金グループの決済が実施され、結果ファイル出力とPUSH通知が行われます。

   ※毎日１回処理が行われます

【テスト時の注意点】

• ダミー課金グループの決済処理は決済日の午後に実施されるため、決済当日の午前中までにダミー課金グループの登録を完了させてください（実際の決済処理時間は案内なく変更する可能性があります）。
• ダミー課金グループに対して紐づけられるダミー会員ID数は10個までになります。また、作成可能なダミー課金グループ数に上限があります。
• 本番課金グループに対してダミー会員を紐付けることはできません。
• ダミー課金グループに対して本番会員を紐付けることはできません。ダミー課金グループに対して本番モードでリクエストすることもできません。
• 会員登録CSVファイルは、ダミーモードではフォーマットチェックのみが行われ、実際の登録処理は行われません。そのため、ダミー課金グループに会員を紐づける方法としてはご利用いただけません。
• 決済登録依頼CSVファイルを使ってダミー課金グループに紐づける場合、決済リクエストが失敗するケースでは課金グループへの紐づけは行われません。MDKの決済処理と同時に紐づける方法も同様となります。
• MAPでは、会員情報の詳細画面から会員IDとダミー課金グループの紐づけが行えます。具体的には、MAPにログインし、「ワンクリック継続サービス」のメニューより会員の検索を行い、会員IDのリンクから遷移した詳細画面に表示される課金グループの「追加」ボタンを押下して遷移します。ダミー会員IDの場合、課金グループIDのプルダウンにはダミー課金グループだけが選択肢として表示されます。
• ダミー課金グループは、後述の固定課金グループを除いて1週間程度で自動削除されます（不要なデータが残り続けないようにするための仕様）。そのため、月次課金のテストために決済日がN日のダミー課金グループを作成し、テストを実施しても、翌月のN日にはその課金グループ、紐づけた会員IDは残りません。定義した課金グループは実質1回しか利用できないためご注意ください。
• 決済の成功・失敗は会員IDに紐づくクレジットカード情報に従います。有効期限により失敗をシミュレート可能です。具体的な内容については「3.2 クレジットカード決済」をご参照ください。
• PUSH通知を行う場合は、決済失敗パターンの会員をご用意ください。
• 何らかのトラブル等により、当日実行予定だったダミー課金グループに対する決済が行われなかった場合でも、当日のリトライは行いません。予期せぬケースも考慮して、ダミー課金グループへの追加を再度実施できるようご準備をお願いいたします（例えば翌日決済される課金グループを定義して会員の紐付け作業がすぐに行えるように準備しておく等）。
• 課金処理は１日１回だけとなります。例外として、ダミー課金処理関連のメンテナンス（プログラム改修）を行う場合に複数回実行する場合がございます。

【共用テストアカウント利用時の注意点】

• 共用テストアカウントは、複数のマーチャント様がご利用されておりますので、会員、ダミー課金グループはマーチャント様自身で作成したものをご利用ください（他者が作成した会員ID、課金グループを無断で利用しない）。
• マーチャント様自身で作成したダミー課金グループ以外は利用しないでください。更新、削除もしないようお願いいたします。
• 共用テストアカウントでは、作成可能なダミー課金グループ数を多めに設定しておりますが、数に限りがございますので、１社（担当者）で多数の課金グループを作成することはお控えください。
• テスト決済終了後に利用したダミー課金グループの削除をお願いいたします。
• 共用テストアカウントでPUSH通知のテストは実施できません（通知先URLを指定できないため）。テストをご希望の場合は、テスト用マーチャントIDの貸し出しをお問い合わせください。貸し出し用マーチャントIDは数に限りがございます。また、ご利用可能期間にも制限がございます。予めご了承ください。

【固定課金グループに関する補足（2022年4月～）】

• 課金グループ名が「Veritrans_Dummy_01」または「Veritrans_Dummy_02」の課金グループは自動削除の対象外となります。
• 固定課金グループも最初に手動で作成する必要があります（マーチャントID発行時に自動で作成されません）。
• 固定課金グループもその他ダミー課金グループと同様にテスト決済処理を行います。課金グループが削除されない点以外については、後述の仕様を除き、ダミー課金グループと同じ仕様となります。
• 固定課金グループに紐づけた会員IDは、1週間程度で紐づけが解除されます。次の課金タイミングで決済対象としたい場合は再度課金グループとの紐づけが必要です。
• 上記動作はダミー課金グループとして作成する前提の仕様となります（同名の本番用課金グループも作成可能）。

【旧仕様からの変更点等の補足】

• 旧仕様では、ダミーモードで利用可能な課金グループは「Veritrans_Dummy_02」のみで、マーチャント様が自由に課金グループIDを指定してテストすることはできませんでした。新仕様では、加盟店様にて課金グループを指定して作成することが可能になります。
• 旧仕様では、「Veritrans_Dummy_02」課金グループへの会員IDの紐づけの処理は確認ができましたが、課金結果（ファイル、通知）を受領する部分は試験ができませんでした（通知についてはツールを利用して可能）。

テスト用アカウントでのテスト

テスト用アカウントを使用した取引は、すべてダミーモード環境での動作となります。
テスト用アカウントは共用アカウントとなるため、MAPの結果通知先URLに特定の店舗様のURLを登録することはできません。
要求電文にpushUrlが設定可能な決済の場合は、要求電文に結果通知先URLを設定してください。
要求電文にpushUrlを設定できない決済の場合は、結果通知受信のテストは、本番アカウントにて実施してください。詳細は、「4.2.2 本番アカウントでのテスト」を参照してください。

1. 3Dセキュア

   3Dセキュアにおいては、本人認証要求電文、および本人認証再取引要求電文の「プッシュURL（pushUrl）」項目で結果通知URLを指定することができます。「プッシュURL（pushUrl）」に店舗様の結果通知受信URLを指定して決済を行ってください。
   該当取引に関する結果通知は、本人認証、または本人認証再取引時に指定したURLに対して行われます。
   共用テスト用アカウントを使用し、要求電文の「プッシュURL」を指定しなかった場合は、結果通知が受信できませんのでご注意ください。

2. キャリア決済

   キャリア決済においては、決済申込電文の「プッシュURL（pushUrl）」項目で結果通知URLを指定することができます。テスト用アカウントを使用する場合、決済申込電文の「プッシュURL」に店舗様の結果通知受信URLを設定して決済申込を行ってください。
   決済申込が成功した場合、該当取引に関する結果通知は、決済申込時に指定したURLに対して行われます。
   決済申込電文に「プッシュURL」を指定しなかった場合、結果通知が受信できませんのでご注意ください。
   なお、継続課金/随時決済の本番モード（DUMMY_REQUEST = 0）では、「プッシュURL」は指定できませんのでご注意ください。

3. コンビニ決済、銀行決済

   コンビニ決済、銀行決済においては、決済申込の要求電文の「プッシュURL（pushUrl）」項目にURLを指定すると、そのURLに入金通知が送信されます。本番アカウントのダミーモードおよびテストアカウントでは決済申込成功後約20秒後に自動的に入金済みのステータスとなり、入金通知が指定のURLに送信されます。
   共用テスト用アカウントを使用し、要求電文の「プッシュURL」を指定しなかった場合は、入金通知が受信できませんのでご注意ください。

本番アカウントでのテスト

要求電文にpushUrlを設定できない決済の場合は、以下を設定し、テストを実施して下さい。

1. MDKにて本番アカウントを設定

   ※ 本番アカウントの発行については弊社営業担当にご連絡下さい。

2. MDKにてダミーモード環境を設定
3. 本番アカウントでの結果通知受信URLを、事前に登録する

   ※ テストアカウントは複数のマーチャントが共有しておりますので、個別URLの設定は出来ません。
   ※ 結果通知受信URLは、MAPの各種設定変更のページより登録することが可能です。
   ※ ここで登録するURLは本番運用開始後もそのまま適用されます。
   ※ 登録頂けるURLはHTTP（Port：80）、HTTPS（Port：443）のプロトコル・ポートのみとなります。
   ※ MDKの要求電文にURLを指定可能な決済サービスもあります。この場合は、MAPでのURL登録は必須ではありません。MAPとMDKの要求電文の両方にURLが設定されている場合、MDKの要求電文に設定されたURLが利用されます。MDKの要求電文でURLを指定可能かどうかは、各決済サービスの『インターフェース詳細』をご確認ください。

4. 取引を実施する。成功した場合、自動的に取引ステータスが変化し、該当する通知データを送信します。

テスト用アカウントをご利用の場合

共用のテストアカウントは、複数の店舗様にて共用でご利用いただいております。
このため、設定した取引IDが、他の店舗様が利用した取引IDと重複し、エラーが発生する場合があります。
取引IDの重複を避けるため、取引IDに店舗様を特定する文字列（社名、サイト名等）を含めていただくことを推奨しています。

本番アカウントをご利用の場合

テスト取引（本番アカウントにてDUMMY_REQUEST = 1の設定）で使用した取引IDは、本番取引（本番アカウントにてDUMMY_REQUEST = 0の設定）で再度使用することはできません。
本番取引開始の際は、取引IDの採番にご注意ください。