本ガイドの内容

本ガイドは、(株)DGフィナンシャルテクノロジーが提供するVeriTrans4Gを利用するための専用ソフトウェアMDK（Merchant Development Kit）をインターネット店舗などに導入する開発者向けのガイドです。

開発の際の参考となるサンプルや、提供ライブラリの説明、電文フォーマットなどについて記載しています。

利用可能な決済手段

利用可能な決済手段は下表のとおりです。

各決済のシステムフローは、『概略システムフロー図』をご参照ください。

ワンクリック継続課金サービスについて

会員管理機能を利用することで、店舗様が運営するECサイト等の利用会員（消費者）と、決済に利用するクレジットカード情報、取引結果等を関連付けて管理することが可能です。この「会員管理機能」と「継続課金機能」を組み合わせることで、定期購入の代金やサービスの月額会費等の支払いのための、定期的な決済を行うことができます。

これらのサービスの総称を「ワンクリック継続課金サービス」と呼びます。

ワンクリック継続課金サービスを導入することで、以下の機能をご利用になれます。

• 会員管理（ID管理）

  サイトの利用会員（消費者）のIDと、クレジットカード情報、継続課金のスケジュールを登録します。
  登録した情報は変更（更新）、削除が可能です。

• 会員IDを利用した決済

  カード決済要求時に会員IDを指定し、会員IDに紐付いたクレジットカード情報で決済します。
  カード以外の決済時にも、会員IDを指定することにより、決済結果と会員IDを関連付けることができます。

• 継続課金

  定期購入の代金やサービスの月額会費等の支払いのために、定期的に決済を実行します。

• クレジットカード洗替

  クレジットカード番号や有効期限の有効性を確認し、新しい情報に更新します。

詳しくは、『ワンクリック継続課金サービス ご利用ガイド』を参照して下さい。

不正検知サービスについて

従来のクレジットカード決済に不正検知機能を統合した「完全一体型」のサービスで、店舗様の不正対策業務を支援いたします。店舗様のニーズに合わせて、複数の不正検知エンジンの中から利用するエンジンを選択可能です。

• カード会社への与信要求と並行して不正判定エンジンによる解析を実行し、与信結果（成功/失敗）と不正判定結果（許可/保留/拒否）を併せて店舗様のシステムに返戻します。
• 不正検知の判定結果は、管理ツール（MAP）の取引情報画面で確認できます。

不正検知サービスのご利用には、別途お申込みが必要です。詳しくは、『不正検知サービス ご利用ガイド』をご参照のうえ、弊社の営業担当までお問い合わせください。

MDKの導入手順

MDKの導入手順について説明します。

※開発言語ごとにMDKが動作する実行環境の要件が定められています。詳細は、弊社ホームページ、または『MDKインストールガイド』をご参照ください。
Ruby / Java / .NET / PHP8

※弊社動作確認済み環境に合致しない環境（OS等）に導入される場合にはサポートを致しかねる場合がございます。
また、以下の項目については原則としてサポートは致しかねますので、予めご了承ください。

• 独自にカスタマイズされたOS（カーネル）上での動作確認
• 独自にカスタマイズされたプログラムに関するお問い合わせ
• MDKとは関連のないサーバー環境設定等

利用可能なMDKコマンド

サービス毎に、コマンドの利用条件は異なりますので、各サービスの『インターフェース詳細』 ページをご参照ください。

Authorizeコマンド（与信、申込）

通常、決済の申込のために最初に実行するコマンドは、Authorizeです。Authorizeに失敗した場合は、決済を完了させることができませんので、消費者には決済が失敗したことをご案内し、決済の申込をやり直して頂く必要があります。

Captureコマンド（売上）

Authorizeコマンドで与信や申込が成立した場合、Captureコマンドで売上を確定する必要があります。売上を確定しないと、消費者への請求対象にはなりません。ただし、以下のケースを除きます。

• Authorizeコマンド要求時に、「同時売上」のオプションを指定した場合は、Authorizeコマンドが成功したタイミングで売上が確定します。（クレジットカード決済等）
• 表 3-2-1のCaptureコマンドの列に、△が記入されている決済サービス（コンビニ決済、電子マネー決済など）では、消費者の入金等のアクションにより、決済事業者が売上確定の処理を実施したタイミングで売上が確定します。この場合は、決済サーバーから店舗様システムに売上が確定したことを示す通知を送信します。
• キャリア決済の継続課金など、弊社または決済事業者側の処理で自動的に売上が成立するケースでは、売上を要求する必要はありません。

Cancel／Refundコマンド（キャンセルおよび返金）

決済のキャンセル（取消）または返金を実行する場合、CancelコマンドとRefundコマンドの２つのコマンドを利用するサービスでは、各サービスの仕様に従い、Cancelコマンド（取消）とRefundコマンド（返金）を使い分ける必要があります。

Cancelコマンドのみを利用するサービスでは、コマンド要求時の取引の状態によって、決済サーバーまたは決済事業者側の判断で取消または返品を適切に処理しますので、店舗様システムでは取消か返金かを意識する必要はありません。

ReAuthorizeコマンド（再取引）

クレジットカード決済（3Dセキュアを含む）では、過去の取引で利用したクレジットカード情報を利用して、与信（および与信同時売上）を再実行可能です。要求時には、過去の取引ID（元取引ID）をパラメータに指定します。

再取引は、ベリトランスに取引履歴が保管されている間は実行可能です。保管期間は、取引のステータスが最後に変化した日を起算日として400日間を標準とします。

以下に、再取引可能期間を示します。

保管期間を超えると取引履歴は削除されますので、再取引に利用する元取引IDは、直近の再取引に使用した取引IDを指定することをお勧めします。

• nanaco決済のReAuthorizeコマンドは、処理未了となった取引の復旧処理のため、クレジットカード決済の再取引とは異なります。

Searchコマンド（検索）

取引の状態を検索することが可能です。

通信エラー発生時の注意点

MDKと弊社サーバー間のネットワーク障害等で通信異常によるエラーが発生した場合、MDKは先頭が「M」で始まる結果コードを返します。このとき、決済要求が弊社サーバーに到達している可能性がありますので、該当の決済が成立しているか否かは、管理画面（MAP）の取引検索やMDKのSearchコマンド（検索）を利用してご確認ください。

• クレジットカード決済の与信同時売上のように、1回の要求で決済が成立する決済手段をご利用の場合は、消費者への請求が発生する可能性があるため、必ずご確認ください。
• 後払い型の決済手段（コンビニ決済や銀行決済など）については、決済の申込要求が成功しただけでは入金は成立しませんので、ご確認は必須ではございません。
• 決済成立の可能性がある通信エラー関連の結果コードは次のとおりです。（2017年7月現在）
  MA99、MB99、MB03、MF01、MF02、MF03、MF04、MF99
  結果コードは今後新しく追加される可能性がありますので、「M」で始まるエラーの発生を検知し、決済成否を確認して頂くことをお勧めします。
• 結果コードの詳細は、『結果コード一覧』をご参照下さい。

決済インターフェース詳細

決済結果通知

コンビニ決済や銀行決済のように、申込を行ってから決済が完了するまでにタイムラグが発生するサービスでは、結果の確定後に、決済サーバーから店舗様システムに向けて決済結果通知を送信します。

テスト実施にあたっての注意事項

テスト仕様の詳細につきましては、『導入テストガイド』を参照してください。
以下にテスト実施の際の主な注意事項を記載します。

• テスト取引を行う場合はMDK設定ファイルのダミーモードを必ず"１"に設定してください
  

  #ダミーモート (テスト時のみ指定)
  DUMMY_REQUEST = 1

• テスト取引を行うには決まった設定条件（所定のカード番号、所定の決済金額など）が必要です。
  テスト時の設定条件につきましては、『導入テストガイド』を参照してください。
• 取引テスト時には、下記の事項に注意してください。
  • 取引ID（orderId）：任意に設定してください。重複しないように設定する必要があります。また、テスト取引で使用した取引IDを、本番取引で再度使用することはできません。
  • 金額：有効な金額データをセットしてください。（"-"（マイナス）や、小数点の入った数値は使用できません）
  • ダミーモードで実行した取引に対する本番モードでの処理要求や、本番モードで実行した取引に対するダミーモードでの処理要求は、必ずエラーになります。

MAPを利用したテスト取引の結果確認

店舗様サイトから行ったテスト取引の処理結果は、弊社が提供する管理ツールMAPにログインし、検索・参照することが可能です。
MAPのご利用方法の詳細は、MAPのヘルプ機能から『ご利用ガイド』を参照してください。