本ガイドの内容

本ガイドは、株式会社DGフィナンシャルテクノロジーが提供するVeriTrans4Gを利用するための専用ソフトウェアMDK（Merchant Development Kit）をインターネット店舗などに導入する開発者向けのガイドです。VeriTrans4G クレジットカード決済にて使用する電文のインターフェース詳細について記載しています。

VeriTrans4Gの詳細については、『VeriTrans4G 開発ガイド』を参照して下さい。尚、インターフェース詳細は、決済サービス毎に提供していますので、当該決済サービスのページをご参照ください。

クレジットカード決済 / ワンクリック継続課金（サブスクリプション） / コンビニ決済 / BankPay / 銀行決済 / 電子マネー決済 / キャリア決済 / ID決済 / ポイント決済 / 後払い

共通

• 「設定」欄の内容は以下の通りです。

  要求電文 ...

  必須項目：○　　任意項目：△　　設定不可：×　　その他条件付：※、※n（条件は説明欄、または欄外に記入）

  応答電文 ...

  必ず返戻：○　　処理成功時のみ返戻：△　　返戻なし：×　　その他条件付：※

• orderId（取引ID）について

  店舗で任意に採番してください。申込処理毎に付ける必要があります。他の取引IDと重複しないよう採番してください。他決済サービスとも重複できません。
  また、テスト取引で使用した取引IDを、本番取引で再度使用することはできません。
  取引IDには、半角英数字以外に"-"（ハイフン）、"_"（アンダースコア）も使用可能です。

• 応答電文について

  応答電文には、本書に記載されていないフィールド（パラメータ）も存在しますが、通常は、記載されているフィールド以外は加盟店様の方で意識する必要はございません。

与信

再取引（再与信）

過去に実行された決済の取引IDを「元取引ID」に指定することで、クレジットカード番号と有効期限を再度入力することなく決済（与信）が可能になります。

注1）過去の取引履歴は、弊社システムの仕様上400日で削除されますので、400日以上前の取引IDを「元取引ID」として指定することはできません。そのため、直近で利用された取引IDを「元取引ID」としてご利用下さい。

注2）ワンクリック継続課金サービスの会員管理機能をご利用になる場合は、「会員ID」に紐付けられたカード情報で決済が可能になりますので、「元取引ID」での再取引をご利用頂く必要はありません。
再取引では「会員ID」の指定は行わないでください。（カードの登録状態によって、想定したカードで決済が行われない場合があり、動作が保証できません）

注3）再取引（再与信）を行っても、元取引IDで取得済みの与信や売上はキャンセルされませんので、金額変更を目的として再取引を行った場合には、元取引のキャンセルを行ってください。

注4）3Dセキュア（本人認証）が成功した取引IDを元取引IDに指定することは可能ですが、再取引分は3Dセキュアの対象取引にはなりませんのでご注意ください。元取引には検証成功（mpiMstatusがsuccess）となった取引のみが使用できます。決済サービスオプションタイプを"mpi-none"に設定した取引は使用できません。

売上

キャンセル

付録

支払種別情報の指定

分割払いやリボ払いを使用される場合、弊社へ事前申請し、かつ下記の設定を行うことによりご利用頂くことが可能です。
弊社側の設定も必要となりますので､あらかじめご連絡下さい。

• 弊社への事前申請

  カード会社と直接契約をされている場合は、事前にカード会社との分割払いの契約をする必要があります。

• MDKの変更

  与信電文での支払種別（jpo）への設定が必要となります。

• 包括契約での利用制限について

  弊社と包括契約（収納代行サービス）により利用される場合は、制限がありますので以下の表をご参照ください。

• 上記お支払方法は、加盟店契約に基づいた支払方法のみ選択いただけます。

  ※ 一括払いのみ利用可能な加盟店様は、一括以外の支払方法を選択することができません。

  ※ 指定可能な分割回数は、3、5、6、10、12、15、18、20、24回のいずれかとなります。

  ※ 決済データ処理サービスの場合は、加盟店様とカード会社間の契約に準じます。

• 電文中に、jpoの指定がない場合、一括として処理されます。

• 売上・取消・返品時に前取引の支払い方法を変更することはできません。

売上に関する注意事項

クレジットカード決済では、与信を実行した金額の範囲内で売上を要求することができます。

• 与信の金額を超える金額での売上は要求できません。
• 与信全額の売上、または一部金額の売上（部分売上）を要求可能です。

１回の与信に対して、売上は1回しか要求できません。部分売上を行った場合も同様です。

※例えば10,000円の与信に対して6,000円で売上を実施後、さらに4,000円で売上を実施、のような運用はできません。

キャンセル（取消・返品）に関する注意事項

クレジットカード決済では、売上を実行した金額の範囲内でキャンセルを要求することができます。

• 通常、データ保管期限の400日間は売上のキャンセルが実行可能です。売上から期間が空いた場合、キャンセルが拒否されることがあります。この場合は、MAP（Merchant Administration Portal）から「ダイレクト返品」を実行することによって、カード会社にマイナスの売上データを連携し、キャンセルすることが可能です。
• 売上金額を超える金額でのキャンセルは要求できません。
• 売上金額（全額）、または一部金額のキャンセル（部分キャンセル）を要求可能です。
• 消費者への請求明細上では、キャンセルのタイミングが消費者への請求タイミングよりも前の場合は取消、請求タイミングよりも後の場合は返品（返金）として扱われます。

キャンセルは、売上金額が0円になるまで繰り返し要求可能です。
一度キャンセルを行った取引に対して、再度売上を要求することはできませんのでご注意ください。

部分売上、部分キャンセルご利用時のリスクについて

クレジットカード決済では、原則として、与信を取った金額で売上を立て、返品時には同じ金額を返金することになっています。そのため、通常の運用では、この原則に従った運用をお願いいたします。

ただし、3-2、3-3でもご説明したとおり、加盟店様の利便性を考慮し、異なる金額（少ない金額）での要求が可能なインターフェース（部分売上、部分キャンセル）も用意しています。

これらのインターフェースを利用しても、多くのケースでは問題になることはございませんが、以下のようなリスクがあることを踏まえたうえでのご利用をお願いいたします。

• 海外発行カードを利用された場合に、売上の金額が異なるために与信とは認められず、第三者利用が疑われる取引については無条件でチャージバックとして処理される場合があります。
• 仕向け先カード会社のシステム仕様によっては、部分キャンセルが必ずエラーとなる場合があります。

仕向け先カード会社の一覧

上記一覧は2023年1月現在のものです。

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

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

• 決済成立の可能性がある通信エラー関連の結果コードは次のとおりです。（2017年7月現在）

  MA99、MB99、MB03、MF01、MF02、MF03、MF04、MF99

  結果コードは今後新しく追加される可能性がありますので、「M」で始まるエラーの発生を検知し、決済成否を確認して頂くことをお勧めします。

• 結果コードの詳細は、『結果コード一覧』をご参照下さい。

不正アタック対策

不正利用者がカードの有効期限やセキュリティコードを確認するために行う不正アタックを防止するため、一定時間内に同一カード番号でカード会社からの拒否応答が多発した場合、該当カードによる与信リクエストはカード会社への与信処理を実施せず、決済サーバより以下のエラーを返戻するように弊社側で制限いたします。

• 不正アタックと判断するための閾値（単位時間、カード会社の拒否応答エラーコード、拒否応答回数）は、弊社にて適宜調整しますので詳細は開示いたしません。
• 対象となったカードは、弊社の決済サービスにおいて一時的に利用ができなくなります。（与信確認ができなくなります。）
  • 弊社決済サービス上の制限のため、他の店舗でのカードの利用を制限するものではありません。
• 対象となったカードは、24時間±αの時間を経過後には再度決済の要求が行えるように制限を解除いたします。
  • 具体的な時間は、弊社側で状況を見ながら調整しますので開示いたしません。
• 該当のエラーが発生し、エンドユーザー様からお問い合わせがあった際には以下の内容をご説明ください。

  複数回のカード会社拒否エラーが発生したため、一時的に該当のカードでの決済を停止させていただいております。
  1日～2日経過してから、再度お試しいただくか、別のカードでの決済を行ってください。