本ガイドの内容

本ガイドは、店舗様のECサイトが株式会社DGフィナンシャルテクノロジーの提供するVeriTrans4GのMDKトークンを利用して決済を行うために必要な情報について記載しています。

対象者

本ガイドは、MDKトークンを利用する店舗様ECサイトの開発者を対象としております。
MDKトークンを連携できる決済サービスについては、「2-4 対象サービス」を参照して下さい。

制限事項

消費者様がご利用いただける環境（ブラウザ）は以下の条件を満たす必要があります。

• JavaScriptが使用可能
• Cross-Origin Resource Sharingに対応している
• SHA-2証明書 及びTLS1.2以上での通信に対応している

※フィーチャー・フォンはCross-Origin Resource Sharingに対応していないため、トークンのご利用はできません。

概要

• MDKトークンサーバー（以下、トークンサーバー）は、カード情報非保持・非通過のシステムを実現するために必要な「トークン」を発行します。
• トークンサーバーに対してクレジットカード情報を送信することで、決済に利用するためのトークンを取得できます。
• トークンを取得する際は、JavaScriptを用いてクレジットカード情報を消費者ブラウザから直接トークンサーバーに送信します。決済要求時には、クレジットカード番号の代わりにトークンを送ることで、ECサイト側のシステムではクレジットカード情報を通過させることなく決済が可能です。
• トークンを利用可能な決済サービスは「2-4 トークンで利用できる決済サービス」を参照して下さい。

決済処理の流れ

トークンを利用した決済処理概略は以下の通りです。

※②以降の処理は各決済サービスの開発ガイドを参照して下さい。

注意点

• トークンサーバーから取得したトークンは一度しかご利用いただけません（ワンタイムトークン）。
• 取得したトークンには有効期限があり、有効期限を過ぎるとそのトークンはご利用いただけなくなります。
  詳しくは、「3.2.1 応答電文」の応答電文の"token_expire_date"の項目を参照して下さい。
• トークンを取得する際には、マーチャントIDに紐づくトークンAPIキーをご使用下さい。
  トークン取得時と決済時でマーチャントIDが異なる場合、クレジットカード情報の識別ができません。
• 本人認証（3-D Secure）のサービスオプションタイプを"mpi-none（認証のみ）"とした場合は、後続のクレジットカードの与信用に別のトークンが必要になります。
  • トークンの取得処理を2回実行し、取得した2つのトークンの値を加盟店様サーバに連携し、1つを3Dセキュア認証、もう 1つをカード与信の電文に設定するという実装が必要となります。

対象サービス

トークンを用いた各決済サービスの詳細は、各決済サービスの開発ガイドを参照して下さい。

要求電文

要求電文の仕様は以下の通りです。

{
    "card_number":"4111111111111111",
    "card_expire":"01/20",
    "security_code":"123",
    "cardholder_name":"TARO YAMADA",
    "token_api_key":"test-token-api-key",
    "lang":"en"
}

応答電文

応答電文の仕様は以下の通りです。

テストの実施方法

各決済サービスの取引時に、トークンサーバーから取得したMDKトークンを要求電文項目に設定し、取引が行えることを確認して下さい。
各決済のテスト仕様につきましては『導入テストガイド』を参照して下さい。

※ご利用可能なテストカード情報についても同ガイドを参照して下さい。

サンプルコードについて

MDKトークンを取得するためのJavaScriptコードサンプルを提供しておりますので、ご活用下さい。

function submitToken(e) {
    var data = {};
    data.token_api_key = document.getElementById('token_api_key').innerText;
    if (document.getElementById('cc-number')) {
        data.card_number = document.getElementById('cc-number').value;
    }
    if (document.getElementById('cc-exp')) {
        data.card_expire = document.getElementById('cc-exp').value;
    }
    if (document.getElementById('cc-csc')) {
        data.security_code = document.getElementById('cc-csc').value;
    }
    if (document.getElementById('cc-name')) {
        data.cardholder_name = document.getElementById('cc-name').value;
    }
    data.lang = "ja";

    var url = document.getElementById('token_api_url').innerText;

    var xhr = new XMLHttpRequest();
    xhr.open('POST', url, true);
    xhr.setRequestHeader('Accept', 'application/json');
    xhr.setRequestHeader('Content-Type', 'application/json; charset=utf-8');
    xhr.addEventListener('loadend', function () {
        if (xhr.status === 0) {
            alert("トークンサーバーとの接続に失敗しました");
            return;
        }
        var response = JSON.parse(xhr.response);
        if (xhr.status == 200) {
            document.getElementById('cc-number').value = "";
            document.getElementById('cc-exp').value = "";
            document.getElementById('cc-csc').value = "";
            document.getElementById('cc-name').value = "";
            document.getElementById('token').value = response.token;
            document.forms[0].submit();
        }
        else {
            alert(response.message);
        }
    });
    xhr.send(JSON.stringify(data));
}

セキュリティコードの必須チェック機能

本機能が有効化されている場合、加盟店様のECサイトやアプリケーションをご利用のお客様がセキュリティコードを入力しなかった場合に、トークンサーバーからエラーを返戻します。加盟店様の実装での必須チェックも必要ですが、加盟店様システムでのチェックと併せて本機能をご利用いただくことで、セキュリティコードが指定されていない不正な要求をトークンサーバーがエラーにしますので、より安全に決済をご利用いただけます。

本機能は、マーチャントID毎に弊社側で有効化／無効化の切替えを行います。
有効化／無効化の初期設定は、マーチャントIDの発行時期によって異なりますので、以下の内容をご確認いただきご不明な際は弊社までお問い合わせください。

• 2018年3月31日以前に発行されたマーチャントIDをご利用の場合、初期設定では本機能は無効化されています。有効化をご希望の加盟店様は、弊社までご連絡下さい。
• 2018年4月1日以降に、新規に発行されるマーチャントIDにつきましては、初期設定として本機能を有効化した状態で発行いたしますので、無効化を希望される新規の加盟店様は、弊社までご相談ください。