VeriTrans4G インターフェース詳細 ～キャリア決済～

VeriTrans4G インターフェース詳細～キャリア決済～
Ver. 1.1.7 （2024 年 07 月～）

Copyright © 2024 DG Financial Technology, Inc., a Digital Garage company. All rights reserved.

VeriTrans4G インターフェース詳細 ～キャリア決済～

目次
第1章

本ドキュメントについて ......................................................................................................................................................................................................... 4

1-1 本ガイドの内容 ......................................................................................................................................................................................................................................................4
1-2 関連ドキュメント .....................................................................................................................................................................................................................................................4
1-3 著作権、および問い合わせ先 .................................................................................................................................................................................................................................4
1-4 改訂履歴...............................................................................................................................................................................................................................................................5

第2章

インターフェース詳細 ............................................................................................................................................................................................................ 8

2-1 共通 ......................................................................................................................................................................................................................................................................8
2-2 申込 .................................................................................................................................................................................................................................................................... 10
2.2.1 要求電文 ： CarrierAuthorizeRequestDto ............................................................................................................................................................................................................................10
2.2.2 応答電文 ： CarrierAuthorizeResponseDto ..........................................................................................................................................................................................................................17

2-3 売上 .................................................................................................................................................................................................................................................................... 20
2.3.1 要求電文 ： CarrierCaptureRequestDto ...............................................................................................................................................................................................................................20
2.3.2 応答電文 ： CarrierCaptureResponseDto .............................................................................................................................................................................................................................21

2-4 キャンセル ........................................................................................................................................................................................................................................................... 22
2.4.1 要求電文 ： CarrierCancelRequestDto .................................................................................................................................................................................................................................222.4.2 応答電文 ： CarrierCancelResponseDto ...............................................................................................................................................................................................................................23

2-5 継続課金終了...................................................................................................................................................................................................................................................... 24
2.5.1 要求電文 ： CarrierTerminateRequestDto ...........................................................................................................................................................................................................................24
2.5.2 応答電文 ： CarrierTerminateResponseDto .........................................................................................................................................................................................................................26

2-6 再与信 ................................................................................................................................................................................................................................................................ 28
2.6.1 要求電文 ： CarrierReAuthorizeRequestDto ........................................................................................................................................................................................................................28
2.6.2 応答電文 ： CarrierReAuthorizeResponseDto ......................................................................................................................................................................................................................29

2-7 消費者ブラウザから店舗側の完了画面へリダイレクトする時のクエリパラメータ ...................................................................................................................................................... 30
2-8 結果通知............................................................................................................................................................................................................................................................. 31

2

VeriTrans4G インターフェース詳細 ～キャリア決済～

第3章

その他 補足事項 .............................................................................................................................................................................................................. 33

3-1 キャリア決済........................................................................................................................................................................................................................................................ 33
3.1.1 （重要）au かんたん決済の与信が KDDI 側で取り消される問題について.....................................................................................................................................................................................33
3.1.2 機種依存文字について .............................................................................................................................................................................................................................................................33
3.1.3 キャリアから消費者への配信メールについて ..............................................................................................................................................................................................................................34
3.1.4 随時決済：au かんたん決済/auPAY（ネット支払い）の itemInfo 設定について .............................................................................................................................................................................423

VeriTrans4G インターフェース詳細 ～キャリア決済～

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

1-2 関連ドキュメント
タイトル

概要

VeriTrans4G 開発ガイド

VeriTrans4G の概要と、MDK（Merchant Development Kit）の導入方法等が記載されています。

VeriTrans4G インターフェース詳細～（サービス名）～

VeriTrans4G で利用可能な各決済サービスのインターフェース詳細が記載されています。

キャリア決済サービス 補足資料

VeriTrans4G キャリア決済サービスのキャリアごとの仕様や補足事項、各種特記事項、検索機
能の補足、結果通知テストツール等が記載されています。
重要な資料となりますので、必ずご確認ください。

ソフトバンクまとめて支払い表記ガイドライン

ソフトバンクまとめて支払いの表記に関する注意事項などが記載されています。
※「ソフトバンクまとめて支払い」「ワイモバルまとめて支払い」のロゴファイルも併せて格納されています。
ソフトバンクまとめて支払いを利用する場合は必ずご確認ください。

1-3 著作権、および問い合わせ先[著作権]
本ドキュメントの著作権は株式会社 DG フィナンシャルテクノロジーが保有しています。
Copyright © 2024 DG Financial Technology, Inc., a Digital Garage company. All rights reserved.
[お問い合わせ先]株式会社 DG フィナンシャルテクノロジー ベリトランス テクニカルサポート
電子メール：

tech-support@veritrans.jp

4VeriTrans4G インターフェース詳細 ～キャリア決済～

1-4 改訂履歴
2017/04 ：Ver1.0.0 リリース
※ 以下、「VeriTrans3G インターフェース詳細 ～キャリア決済～」 Ver 2.0.3 からの更新分を記載します。
「3.1.3 キャリアから消費者への配信メールについて」・キャリア毎のメール送信表で与信取消時の項目を追加
・ドコモケータイ払い
・キャリア毎のメール送信表で料金合算払いの部分返金時にメールを配信するように更新
・キャリア毎のメール送信詳細の表で、与信取消時、部分返金時のメール配信内容を追加
・au かんたん決済
・キャリア毎のメール送信詳細の表で、摘要欄の表示内容を更新
・ソフトバンクまとめて支払い（B）
・キャリア毎のメール送信詳細の表で、継続課金時の金額表示について更新
・キャリア毎のメール送信詳細の表で、連絡内容に購入内容を追加
2018/01 ：Ver1.0.1 リリース
「1-2 関連ドキュメント」を追加「2-7 結果通知（キャリア決済）」の「通知件数」の「説明」を修正（1 度に通知可能な件数を 1,000 件から 50 件に変更）
2018/02 ：Ver1.0.2 リリース
「2.4.1 要求電文 ： CarrierCancelRequestDto」の返金金額の設定を更新（au かんたん決済の×を○に変更）「3.1.3 キャリアから消費者への配信メールについて」
・au かんたん決済
・キャリアごとのメール送信詳細の表で、部分返金時のメール配信内容を追加
2018/05 ：Ver1.0.3 リリース
「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」、「2.5.1 要求電文 ： CarrierTerminateRequestDto」の端末種別の設定を更新（ドコモケータイ払いの PC の×を✔に変更）
・上記に伴い、「2-1 共通」の「設定欄の「✔」について」の例を更新

2018/09 ：Ver1.0.4 リリース
S!まとめて支払いのサービス終了に伴い、記述を削除

5

VeriTrans4G インターフェース詳細 ～キャリア決済～
2019/03 ：Ver1.0.5 リリース
「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」の継続課金日の説明を更新(ソフトバンクまとめて支払い（A）の説明を一部追加)「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」の商品情報の説明を更新(ソフトバンクまとめて支払い（B）の説明を一部追加)
2019/10 ：Ver1.0.6 リリース
サービス名の変更（ドコモケータイ払い→ドコモ払い）「2.4.1 要求電文 ： CarrierCancelRequestDto」に au かんたん決済の部分返金の注意書きを追加「2-7 結果通知（キャリア決済）」 項目の並び順について追記
2019/12 ：Ver1.0.7 リリース
「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」の itemId の継続課金の説明を更新(ソフトバンクまとめて支払い（B）の説明を修正)
2020/06 ：Ver1.1.0 リリース
随時決済追加対応
2021/02 ：Ver1.1.1 リリース
「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」のプッシュ URL の説明を修正

2022/01 ：Ver1.1.2βリリース「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」へ au PAY ネット払い_アプリ対応として以下の項目を追加
paymentAuthenticationType（決済認証方式）、storeId（店舗 ID）、termId（端末管理番号）「2.2.2 応答電文 ： CarrierAuthorizeResponseDto」へ au PAY ネット払い_アプリ対応として以下の項目を追加
redirectUrl（リダイレクト URL）
「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」の loginAuId（auID ログインフラグ）、openId（open ID）の説明を修正

2022/06 ：Ver1.1.3 リリース
サービス名の変更（ドコモ払い→d 払い）

2023/09 ：Ver1.1.4 リリース
「2-7 消費者ブラウザから店舗側の完了画面へリダイレクトする時のクエリパラメータ」に結果通知受信推奨の注意事項を追記

6

VeriTrans4G インターフェース詳細 ～キャリア決済～
2023/12 ：Ver1.1.5 リリース
「2.2.2 応答電文」に、ソフトバンクまとめて支払い B への遷移時に表示されるシステムエラーについての注意事項を追記

2024/06 ：Ver1.1.6 リリース
書式等軽微な修正
随時決済の対応サービスに au かんたん決済を追加「2.2.1 要求電文 ： CarrierAuthorizeRequestDto」の successUrl、cancelUrl、errorUrl、pushUrl の書式・制限で桁数定義を 256 桁⇒1024 桁に更新
「2.5.1 要求電文 ： CarrierTerminateRequestDto」の successUrl、cancelUrl、errorUrl、pushUrl の書式・制限で桁数定義を 256 桁⇒1024 桁に更新
2024/07 ：Ver1.1.7 リリース
「2.6.1 要求電文 ： CarrierReAuthorizeRequestDto」の originalOrderId（元取引 ID）の説明に 400 日で削除されない旨を追記

7

VeriTrans4G インターフェース詳細 ～キャリア決済～

第2章 インターフェース詳細
本章では、各決済にて使用する電文（Dto）について説明します。以下の表に記載されているフィールドは、店舗様にて利用可能なフィールドです。
各電文（Dto）には、以下の表に記載されていないフィールドが定義されている場合がありますが、以下の表に記載されていないフィールドは店舗様では使用することはできません。

2-1 共通■「設定」欄の内容は以下の通りです。
要求電文 … 必須項目：○

任意項目：△

設定不可：×

応答電文 … 必ず返戻：○

処理成功時のみ返戻：△

その他条件付：※、※n（条件は説明欄、または欄外に記入）

返戻なし：×

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

■vAuthInfo および authParams を利用した改ざんチェックについて
決済サーバーから消費者ブラウザを経由して店舗側の結果画面に遷移（リダイレクト）する場合、リダイレクト時に店舗側システムが受け取ったパラメータが改ざんされていないか検証する機能を提供しています。
この改ざんチェックは、リダイレクト時に返戻される「vAuthInfo」、および「authParams」パラメータを用いて行います。
店舗側システムで算出したハッシュ値が、リダイレクト時のパラメータより取得した「vAuthInfo」と一致している場合は、パラメータは改ざんされていない、とみなすことができます。
この改ざんチェックは必須ではありませんが、悪意を持った第三者によって、不正なリダイレクト電文を受信する可能性がありますので、実装を強く推奨しています。
実装方法の詳細につきましては、弊社より提供しているサンプルプログラムをご参照ください。

■設定欄のタイトルについて
設定欄のタイトル（「DO」等）は、下記の通り各キャリアを示します。
キャリア毎に各フィールドの設定（必須項目、任意項目、設定不可等）が異なりますのでご注意ください。
DO：d 払い

AU：au かんたん決済

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

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

FL：フレッツまとめて支払い
8

VeriTrans4G インターフェース詳細 ～キャリア決済～■設定欄の「✔」について
設定欄の「✔」は、キャリア毎に当該フィールド中の各設定値が設定できるかどうかを示しています。設定できる設定値には「✔」が記載されています。
当該フィールド中に「✔」の付けられた設定値が複数ある場合は、いずれかの値を選択し設定します。
尚、当該フィールドの設定（必須項目、任意項目、設定不可等）自体は、「○」、「△」等で示されています。上記「設定」欄の内容を参照してください。
当該フィールドの設定自体が「必須項目（○）」の場合、「✔」の付けられた設定値のいずれかの値の設定が必須となります。
「任意項目（△）」の場合は、「✔」の付けられた設定値のいずれかの値を任意で設定することができます。
例）CarrierAuthorizeRequestDto のソフトバンクまとめて支払い（B）（SB）で「terminalKind（端末種別）」を設定する場合（１） CarrierAuthorizeRequestDto のソフトバンクまとめて支払い（B）（SB）の場合、「terminalKind（端末種別）」は必須項目（○）です。
（２） 「✔」の付けられた「"0"：PC」、または「"1"：スマートフォン」のどちらかを選択し、設定します。
よって、（１）（２）より、「CarrierAuthorizeRequestDto のソフトバンクまとめて支払い（B）（SB）の場合、「terminalKind（端末種別）」には、「"0"：PC」、または「"1"：スマートフォン」のどちらかを選択し、必須で設定しなければならない」となります。

9VeriTrans4G インターフェース詳細 ～キャリア決済～

2-2 申込
2.2.1 要求電文 ： CarrierAuthorizeRequestDto
要求電文 ： CarrierAuthorizeRequestDto
フィールド名orderId

項目名
取引 ID

書式・制限
半角英数字

説明

設定
DO

AU

SB

SA

FL

「2-1 共通」の「orderId（取引 ID）について」を参照

○

○

○

○

○

利用するキャリア決済のタイプを指定

○

○

○

○

○

○
○

○
○

○
○

○
○

○
○

消費者が使用している端末の種別を指定（キャリア毎に✔のいずれかの値の設定が必須）

×
○

×
○

×
○

×
○

×
○

"0"：PC

✔

✔

✔

✔

✔

"1"：スマートフォン

✔

✔

✔

✔

✔

※都度決済と継続課金のみ利用可能

△

✔

×

×

×

商品の種別を指定 （キャリア毎に✔のいずれかの値を任意で設定）

△

△

△

△

△

"0"：デジタルコンテンツ

✔

✔

✔

✔

✔

"1"：物販

✔

✔

✔

×

✔

"2"：役務

✔

✔

✔

×

✔

100 桁以内
serviceOption

サービスオプTypeションタイプ

右記参照"docomo"

：d 払い

"au"

：au かんたん決済 、auPAY（ネット支払い）※auPAY（ネット支払い）はアプリ方式、ウェブ方式に対応しています。
詳細は『キャリア決済サービス 補足資料』をご確認ください。

amount

決済金額"sb_ktai"：ソフトバンクまとめて支払い（B）"sb_matomete"：ソフトバンクまとめて支払い（A）"flets"：フレッツまとめて支払い

半角数字

キャリア毎に上限金額が規定されています。

12 桁以内詳細は『キャリア決済サービス 補足資料』をご参照ください。
都度決済

指定必須

継続課金

「ソフトバンクまとめて支払い（A）」の場合は、キャリアへのサービス申請時に設定した金額の
み指定可能

随時決済
terminalKind

端末種別

半角数字 1 桁

指定できません。

"2"：フィーチャーフォン
itemType

商品タイプ

半角数字 1 桁※未指定の場合は、マーチャント登録申請時に設定した値を使用

10VeriTrans4G インターフェース詳細 ～キャリア決済～

要求電文 ： CarrierAuthorizeRequestDto
フィールド名

項目名

書式・制限

accountingTy

都度/継続区

半角数字 1 桁

pe

分

withCapture

与信同時売

英字

上フラグ

（boolean）

説明

設定
DO

AU

SB

SA

FL

都度決済、継続課金の種別を指定（キャリア毎に✔のいずれかの値の設定が必須）

○

○

○

○

○

"0"：都度決済

✔

✔

✔

✔

✔

"1"：継続課金

✔

✔

✔

✔

✔

"4"：随時決済

✔

✔

×

×

×

都度決済

△

△

△

△

△

売上フラグを指定 （キャリア毎に✔のいずれかの値を任意で設定）※未指定の場合は、"false"
ただし、与信同時売上のみを許可するキャリアの場合は"true"とみなす。

d3Flag

本人認証（3D

半角数字 1 桁

セキュア）"true"：与信同時売上

✔

✔

✔

✔

✔

"false"

：与信のみ

✔

✔

✔

×

✔

×
×
×

×
×
×

×
×
△

×
×
×

×
×
×

継続課金

指定できません。

随時決済

指定できません。

本人認証（3D セキュア）の種別を指定 （✔のいずれかの値を任意で設定）
本パラメータは、「ソフトバンクまとめて支払い（B）」の場合にのみ利用できます。
※通信料をクレジットカードで支払う消費者の決済において、各カード会社が提供する本人認証（3D セキュア）を利用することができます。本機能はキャリア側のサービスに組み込まれているものであり、弊社提供の MPI ホスティングとは別のサービスになります。
※未指定の場合は、「"1": バイパス」"0"：無し本人認証（3D セキュア）を行わずに決済します。

×

×

✔

×

×

"1"：

本人認証（3D セキュア）が利用可能な場合は本人認証を行い、その認証結果によって決済続

×

×

✔

×

×

バイパス

行/決済中止が決定されます。本人認証（3D セキュア）が利用不可の場合は本人認証を行わ
×

×

✔

×

×

ずに決済を続行します。
"2"：有り本人認証（3D セキュア）を必須とします。本人認証（3D セキュア）が利用不可の場合は決済できません。

mpFirstDate

初回課金年
月日

半角数字 8 桁

都度決済

指定できません。

×

×

×

×

×

継続課金

初回課金の年月日を指定 YYYYMMDD の形式

○

○

○

×

○

当日、または未来日付を指定可能（当日≦mpFirstDate≦180 日後）※「ソフトバンクまとめて支払い（A）」は、申込を行った日が初回課金日となり、以降は申込日を起算日として 1 ヶ月毎に自動で課金されますので、本パラメータは設定できません。
※「フレッツまとめて支払い」は、26 日～月末までの指定はできません。
11

VeriTrans4G インターフェース詳細 ～キャリア決済～

要求電文 ： CarrierAuthorizeRequestDto
フィールド名

mpDay

項目名

継続課金日

書式・制限

半角数字 2 桁

設定

説明

DO

AU

SB

SA

FL

随時決済

指定できません。

×

×

×

×

×

都度決済

指定できません。

×

×

×

×

×

継続課金

初回課金年月日の翌月以降の毎月の課金日を"1"～"28"で指定

○

○

○

×

○

×
△

×
△

×
△

×
△

×
△

※課金日が 1 桁の場合、先頭に 0 を付与するのも可（例 "01"）※月末（29 日、30 日、31 日）を指定する場合は 99 を指定※フレッツまとめて支払いについては、26 日～月末までの指定はできません。
※「ソフトバンクまとめて支払い（A）」については、本パラメータは設定できません。申込を行った日が初回課金日となり、以降は申込日を起算日として 1 ヶ月毎に自動で課金されます。月末頃（29 日、30 日、31 日）に申込みを行った場合、小の月（2、4、6、9、11 月）で日にちが存在しない月は、末日に課金されます。

itemId

商品番号

右記参照

随時決済

指定できません。

都度決済

商品またはサービスの管理用番号を指定
キャリア

書式・制限

設定値

DO

半角英数字 15 バイト以下

任意の値を指定AU

半角英数字 15 バイト以下

任意の値を指定SB

半角英数字 15 バイト以下

任意の値を指定SA

半角英数字 15 バイト以下

任意の値を指定FL

半角英数字 8 バイト以下

任意の値を指定12VeriTrans4G インターフェース詳細 ～キャリア決済～

要求電文 ： CarrierAuthorizeRequestDto
フィールド名

項目名

書式・制限

設定

説明
継続課金

商品またはサービスの管理用番号を指定
キャリア

書式・制限

DO

半角英数字 15 バイト以下

任意の値を指定AU

半角英数字 15 バイト以下

任意の値を指定。ただし、すでに継続課

DO

AU

SB

SA

FL

△

△

△

○

△

△

△

×

×

×

設定値

金登録されている、同一消費者の決済と同じ値を設定した場合は、キャリア側の重複チェックでエラーとなります。
SB

半角英数字 15 バイト以下

任意の値を指定SA

半角英数字 18 バイト以下

キャリアへのサービス申請時に発行されたサービス識別子を指定

FL
随時決済

半角英数字 8 バイト以下

任意の値を指定商品またはサービスの管理用番号を指定
キャリア

書式・制限

DO

半角英数字 15 バイト以下

任意の値を指定

設定値

AU

半角英数字 15 バイト以下

任意の値を指定13

VeriTrans4G インターフェース詳細 ～キャリア決済～

要求電文 ： CarrierAuthorizeRequestDto
フィールド名itemInfo

項目名
商品情報

書式・制限

説明

全角

商品またはサービスの情報を指定※機種依存※機種依存文字については、「3.1.2 機種依存文字について」を参照してください。

文字は利用

キャリア

設定方法

できません。

DO

キャリアが提供する消費者向けコンテンツに表示される商品情報を指定してください。

設定
DO

AU

SB

SA

FL

△

△

△

△

△

・決済時の内容確認画面
・ご利用明細画面
・購入完了通知メール（レシートメール）
最大 20 文字AU

キャリアが提供する消費者向けの確認画面や、購入完了時に送信されるメール本文
等に記載される「摘要」を設定してください。
都度決済：最大 24 文字
継続課金：最大 15 文字（摘要には、「毎月○○日に課金」に商品情報が付加されて表示されます）
随時決済：最大 24 文字（※詳細な設定内容は「3.1.4 随時決済：au かんたん決済/auPAY（ネット支払い）の itemInfo 設定について」を参照してください。）

SB

直接契約のマーチャント様のみ指定可能です。
キャリアが提供する消費者向けの確認画面や、購入完了時に送信されるメール本文
等に記載される「購入内容」を設定してください。
（包括契約の場合は、商品情報は「ご購入商品」という固定の文言が表示されます。）

SA

キャリアが提供する消費者向けの確認画面や、購入完了時に送信されるメール本文
等に記載される「購入内容」を設定してください。
最大 20 文字FL

決済時の内容確認画面に表示される商品名を指定してください。
店舗様にて itemInfo を指定された場合は、店舗様のサイト名＋itemInfo に指定された内容が、決済時の内容確認画面に表示されます。
店舗様にて itemInfo 未指定時は、店舗様のサイト名が決済時の内容確認画面に表示されます。
※「店舗様のサイト名」は、マーチャント登録申請時に設定した値（サイト名）です。
最大 20 文字14

VeriTrans4G インターフェース詳細 ～キャリア決済～

要求電文 ： CarrierAuthorizeRequestDto
フィールド名

項目名

書式・制限

説明

successUrl

決済完了時

URL に使用決済完了後に、店舗側サイトに画面遷移を戻すための URL を指定

URL

可能な半角

※未指定の場合は、マーチャント登録申請時に設定した値を使用

設定
DO

AU

SB

SA

FL

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

△

×

×

×

×

×

×

×

○

×

△

×

×

×

文字
1024 桁以内
cancelUrl

決済キャンセURL に使用

決済キャンセル時に、店舗側サイトに画面遷移を戻すための URL を指定

ル時 URL可能な半角※未指定の場合は、マーチャント登録申請時に設定した値を使用

文字
1024 桁以内
errorUrl

決済エラー時URL に使用

決済エラー時に、店舗側サイトに画面遷移を戻すための URL を指定

URL

可能な半角

※未指定の場合は、マーチャント登録申請時に設定した値を使用

文字
1024 桁以内
pushUrl

プッシュ URL

URL に使用

プッシュ URL を指定

可能な半角※未指定の場合は、マーチャント登録申請時に設定した値を使用

文字※ダミー取引と都度決済、随時決済の本番取引で指定可能です（継続課金の本番取引は指定不可）。

1024 桁以内
openIdOpen ID

半角英数字

キャリアより発行された消費者を識別する OpenID を指定

256 桁以内

OpenID は、決済申込完了通知により決済サーバーから店舗側システムに連携します。
※アプリ認証方式の場合は、指定できません。

fletsArea

フレッツエリア

半角数字"0"：東日本

1 桁"1"：西日本※フレッツまとめて支払いの場合は、必須※フレッツまとめて支払い以外の決済の場合は、指定できません。

loginAuId

auID ログイン

英字auID ログインフラグを指定

フラグ（boolean）

加盟店様が独自 ID で会員管理・認証を行っている場合には、「false : ID 連携」をご利用ください。
加盟店様が独自に会員管理・認証を行わず、auID を利用して加盟店様のサービスにログインする場合には、「true : auID ログイン」をご利用ください。
※未指定の場合は、"false"※アプリ認証方式の場合は、指定できません。

15

VeriTrans4G インターフェース詳細 ～キャリア決済～

要求電文 ： CarrierAuthorizeRequestDto
フィールド名

項目名

書式・制限

paymentAuth

決済認証方

半角数字

アプリ決済の利用を判定する認証方式フラグを指定

enticationTyp式

1 桁※未指定の場合は、「”0”：ID 認証方式」

e

説明

DO

AU

SB

SA

FL

×

△

×

×

×

✔

×

×

×

※auPAY（ネット支払い）アプリ方式を利用する場合は、"1"を指定してください。
都度決済

storeId

設定

店舗 ID

"0"

：ID 認証方式

×"1"：アプリ認証方式

×

✔

×

×

×

継続課金

指定できません。

×

×

×

×

×

随時決済

指定できません。

×

×

×

×

×

×

△

×

×

×

×

△

×

×

×

半角数字

決済を行う店舗 ID を指定

8 桁※アプリ認証方式の場合に指定可能※未指定の場合はマーチャント登録申請時に設定した値を使用

termId

端末管理番

半角英数字

端末管理番号を指定

号

128 桁以内※アプリ認証方式の場合に指定可能

16

VeriTrans4G インターフェース詳細 ～キャリア決済～

2.2.2 応答電文 ： CarrierAuthorizeResponseDto
応答電文 ： CarrierAuthorizeResponseDto
フィールド名
serviceType

項目名
決済サービスタイプ

書式・制限

説明

設定

要求電文を送信した決済サービスタイプ

○

半角英数字

"success" ： 正常終了○

32 文字以内"failure"

半角英数字
10 桁以内mstatus

処理結果コード： 異常終了"pending" ： 保留vResultCode

詳細結果コード

半角英数字

処理の結果を詳細に表すコード

16 文字

4 桁ずつ 4 つのブロックで構成され、各ブロックでサービス毎の処理結果を表します。

○

詳細は別途『結果コード一覧』をご参照ください。
merrMsg

エラーメッセージ

処理結果を日本語で表示します。

○

文字列

決済サーバーにて決済処理電文（内部処理も含む）毎に付与する ID○

100 桁以内

１つの取引 ID に対して、複数の ID が付与されます。

半角英数字

決済要求時に店舗様にて任意に採番し送信された取引 ID○

決済サーバーがオーダー（取引 ID）と紐付ける為に採番する ID○

電文のバージョン○

文字列1024 バイト以内

marchTxn
orderId

電文 ID
取引 ID

100 文字以内
custTxn

取引毎に付く ID

文字列
100 桁以内

txnVersion

MDK バージョン

半角英数字 5 桁

問題発生時などに用いますが、通常ご利用になることはありません。

17

VeriTrans4G インターフェース詳細 ～キャリア決済～

応答電文 ： CarrierAuthorizeResponseDto
フィールド名
responseContents

項目名
レスポンス

書式・制限
文字列

コンテンツ

説明

設定

※

店舗様側でコンシューマに対して返戻する HTML コンテンツ
本パラメータを利用して、消費者の端末からキャリアの提供する画面への遷移を制御して頂く必要があります。
自動でキャリアの画面に遷移するための JavaScript を含みます。本パラメータが返戻された場合は、そのままの内容を消費者のブラウザに返戻します。
返戻するコンテンツの文字コードはキャリアによって異なりますので、正しい文字コードでレスポンスする必要があります。
キャリア

PC/スマートフォンの場合

フィーチャーフォンの場合

DO

Shift-JIS

Shift-JIS

AU

UTF-8

SB

Shift-JIS

SA

UTF-8

FL

UTF-8

－

※JavaScript を利用可能な端末では自動でキャリアの画面に遷移します。フィーチャーフォンなどの JavaScript が利用できな
い端末では、ボタン押下によりキャリアの画面に遷移します。
redirectUrl

リダイレクト URL

文字列HTTP レスポンスヘッダ（Location ヘッダ）にセットするキャリアの URL です※

2000 桁以内※serviceOptionType で "au " を指定し、かつ アプリ認証方式 を指定した際に応答します。

（重要）ソフトバンクまとめて支払い B への遷移時に表示されるシステムエラーについて

ソフトバンクまとめて支払い B の場合、決済申込（Authorize）のレスポンスに含まれる responseContents は、必ず Shift-JIS でブラウザに返戻してください。
Shift-JIS 以外の文字コードで返戻した場合、以下のようなシステムエラー画面が表示され、決済に進むことができません。

18

VeriTrans4G インターフェース詳細 ～キャリア決済～

なお、このエラーは、ダミーモード（テストモード）では表示されません。
必ず本番環境での本番動作確認を行っていただきますようお願いいたします。

※ｄ払いも同様に Shift-JIS で扱う必要があります。d 払いでは上記のようなエラーは表示されませんが、画面表示が文字化けとなる可能性があります。

19

VeriTrans4G インターフェース詳細 ～キャリア決済～

2-3 売上2.3.1 要求電文 ： CarrierCaptureRequestDto
要求電文 ： CarrierCaptureRequestDto
フィールド名orderId

項目名
取引 ID

serviceOption

サービスオプTypeションタイプ

書式・制限

説明

設定
DO

AU

SB

SA

FL

半角英数字

都度決済

決済申込時に採番した取引 ID

○

○

○

×

○

100 桁以内

継続課金

決済申込時に採番した取引 ID

随時決済

再与信時に採番した取引 ID

○
○
○

○
○
○

○
×
○

×
×
×

○
×
○

×
○

×
×

×
○

×
×

×
○

×

×

×

×

×

右記参照

利用するキャリア決済のタイプを指定"docomo"

：d 払い

"au"

：au かんたん決済、auPAY（ネット支払い）"sb_ktai"：ソフトバンクまとめて支払い（B）"flets"：フレッツまとめて支払い※"sb_matomete"は指定できません。
captureMonth

課金売上月

半角数字

都度決済

指定できません。

6桁

継続課金

売上に失敗している過去の課金月か当月を指定
YYYYMM 形式

随時決済

指定できません。

20

VeriTrans4G インターフェース詳細 ～キャリア決済～

2.3.2 応答電文 ： CarrierCaptureResponseDto
応答電文 ： CarrierCaptureResponseDto
フィールド名
serviceType

項目名
決済サービスタイプ

書式・制限

説明

設定

要求電文を送信した決済サービスタイプ

○

半角英数字

“success” ： 正常終了○

32 文字以内“failure”

半角英数字
10 桁以内mstatus

処理結果コード： 異常終了“pending” ： 保留vResultCode

詳細結果コード

半角英数字

処理の結果を詳細に表すコード

16 文字

4 桁ずつ 4 つのブロックで構成され、各ブロックでサービス毎の処理結果を表します。

○

詳細は別途『結果コード一覧』をご参照ください。
merrMsg

エラーメッセージ

marchTxn

電文 ID

処理結果を日本語で表示します。

○

文字列

決済サーバーにて決済処理電文（内部処理も含む）毎に付与する ID○

100 桁以内

１つの取引 ID に対して、複数の ID が付与されます。

半角英数字

決済要求時に店舗様にて任意に採番し送信された取引 ID○

文字列1024 バイト以内

orderId

取引 ID

100 文字以内
custTxn

取引毎に付く ID

文字列 100 桁以内

決済サーバーがオーダー（取引 ID）と紐付ける為に採番する ID○

txnVersion

MDK バージョン

半角英数字 5 桁

電文のバージョン○問題発生時などに用いますが、通常ご利用になることはありません。
captureDatetime

売上日時

文字列 14 桁

YYYYMMDDhhmmss 形式○■与信有効期限について
キャリア毎に与信有効期限が決まっています。この期限内に売上要求を行わない場合は期限切れとなり、売上確定ができなくなりますのでご注意ください。各キャリアの与信有効期限については、『キャリア決済サービス 補足資料』を参照してください。

■継続課金の売上について
継続課金の売上は、課金日の売上処理に失敗した場合にリカバリのために使用します。課金日前にはご利用できません。詳細は、『キャリア決済サービス 補足資料』を参照してください。

21

VeriTrans4G インターフェース詳細 ～キャリア決済～

2-4 キャンセル
2.4.1 要求電文 ： CarrierCancelRequestDto
要求電文 ： CarrierCancelRequestDto
フィールド名orderId

項目名
取引 ID

serviceOption

サービスオプTypeションタイプ

書式・制限

説明

半角英数字

都度決済

決済申込時に採番した取引 ID

100 桁以内

継続課金

決済申込時に採番した取引 ID

随時決済

再与信時に採番した取引 ID

右記参照

利用するキャリア決済のタイプを指定"docomo"

：d 払い

"au"

：au かんたん決済、auPAY（ネット支払い）"sb_ktai"：ソフトバンクまとめて支払い（B）"flets"：フレッツまとめて支払い

設定
DO

AU

SB

SA

FL

○
○

○
○

○
○

×
×

○
○

○
○

○
○

×
○

×
×

×
○

※上記以外のキャリアは指定できません。
cancelMonth

課金取消月

半角数字

都度決済

指定できません。

×

×

×

×

×

6桁

継続課金

すでに処理済みの過去の課金月か、当月を指定

○

○

○

×

○

YYYYMM 形式

amount

返金金額

半角数字

随時決済

指定できません。

×

×

×

×

×

都度決済

返金する金額を指定。（決済申込時に設定した金額以下）

△

△

×

×

×

12 桁以内※未指定時は全額取消となります。
※売上が未成立の取引の場合は、全額のみ指定可です。
※au かんたん決済、auPAY ネット支払いで部分返金を行うには、KDDI への申請が必要です。
継続課金

指定できません。

×

×

×

×

×

随時決済

返金する金額を指定。（決済申込時に設定した金額以下）

×

△

×

×

×

※未指定時は全額取消となります。
※売上が未成立の取引の場合は、全額のみ指定可です。
※au かんたん決済、auPAY ネット支払いで部分返金を行うには、KDDI への申請が必要です。

22

VeriTrans4G インターフェース詳細 ～キャリア決済～

2.4.2 応答電文 ： CarrierCancelResponseDto
応答電文 ： CarrierCancelResponseDto
フィールド名
serviceType

項目名
決済サービスタイプ

書式・制限

説明

設定

要求電文を送信した決済サービスタイプ

○

半角英数字

“success” ： 正常終了○

32 文字以内“failure”

半角英数字
10 桁以内mstatus

処理結果コード： 異常終了“pending” ： 保留vResultCode

詳細結果コード

半角英数字

処理の結果を詳細に表すコード

16 文字

4 桁ずつ 4 つのブロックで構成され、各ブロックでサービス毎の処理結果を表します。

○

詳細は別途『結果コード一覧』をご参照ください。
merrMsg

エラーメッセージ

marchTxn

電文 ID

処理結果を日本語で表示します。

○

文字列

決済サーバーにて決済処理電文（内部処理も含む）毎に付与する ID○

100 桁以内

１つの取引 ID に対して、複数の ID が付与されます。

半角英数字

決済要求時に店舗様にて任意に採番し送信された取引 ID○

決済サーバーがオーダー（取引 ID）と紐付ける為に採番する ID

○

半角英数字

電文のバージョン○

5桁

問題発生時などに用いますが、通常ご利用になることはありません。

文字列1024 バイト以内

orderId

取引 ID

100 文字以内
custTxn

取引毎に付く ID

文字列
100 桁以内

txnVersion

MDK バージョン

cancelDatetime

取消日時

文字列 14 桁

YYYYMMDDhhmmss 形式○

balance

残高

半角数字

金額を指定してキャンセルを行ったときの残高△

12 桁以内例）1000 円の決済に対して、返金金額に 200 円を指定してキャンセルが成功した場合に 800 が返却される。

■キャンセル期限について
キャリア毎にキャンセルが可能な期限が決まっています。
各キャリアのキャンセル期限については、『キャリア決済サービス 補足資料』を参照してください。

23

VeriTrans4G インターフェース詳細 ～キャリア決済～

2-5 継続課金終了
継続課金を終了する、もしくは随時決済を終了するには Terminate コマンドを利用します。
Terminate コマンド要求後の処理フローには、「2 者間（強制終了）」、および「3 者間（消費者を介する終了）」の 2 つの方式があります。
各方式の詳細、フロー、およびキャリア毎の利用可否については、『キャリア決済サービス 補足資料』、および『開発ガイド別冊 概略システムフロー図』を参照してください。

2.5.1 要求電文 ： CarrierTerminateRequestDto
要求電文 ： CarrierTerminateRequestDto
設定
フィールド名

項目名

書式・制限

説明

DO

orderId

取引 ID

serviceOption

サービスオプTypeションタイプ

force

強制終了

半角英数字

継続課金

決済申込時に採番した取引 ID を設定

100 桁以内

随時決済

決済申込時に採番した取引 ID を設定

右記参照

利用するキャリア決済のタイプを指定"docomo"

：d 払い

"au"

：au かんたん決済、auPAY（ネット支払い）"sb_ktai"：ソフトバンクまとめて支払い（B）"sb_matomete"：ソフトバンクまとめて支払い（A）"flets"：フレッツまとめて支払い

英字※docomo（継続課金）、sb_matomete のみ指定可能なパラメータ（boolean）

継続課金の終了方式（3 者間または 2 者間）を指定（✔のいずれかの値を任意で設定）

AU

SB

SA

FL

○ ○

○
○
○

○
×
○

○
×
○

○
×
○

△ ×

×

×

△

×

継

随

○ ○

継 随

※au、sb_ktai の場合は強制終了で固定のため、指定できません。
※flets は 3 者間で固定のため、指定できません。

terminalKind

端末種別

半角数字
1桁

"true"：強制終了（2 者間）

✔

×

×

×

✔

×

"false"：消費者を介する継続課金終了（3 者間／デフォルト）

✔

×

×

×

✔

×

3 者間

※3 者間の継続課金終了の場合に指定可能なパラメータ

○ ×

×

×

○

○

"0"：PC

✔

×

×

×

✔

✔

"1"：スマートフォン

✔

×

×

×

✔

✔

"2"：フィーチャーフォン

✔

×

×

×

×

×

消費者が使用している端末の種別を指定

24

VeriTrans4G インターフェース詳細 ～キャリア決済～

要求電文 ： CarrierTerminateRequestDto
設定
フィールド名

項目名

書式・制限

説明

DO
継

successUrl

×

×

×

3 者間

※3 者間の継続課金終了の場合に指定可能なパラメータ

△ ×

×

×

△

△

URL に使用可

了完了時

能な半角文

継続課金終了完了後に、店舗側サイトに画面遷移を戻すための URL を指定

URL

字※未指定の場合は、Authorize 時に指定された値、またはマーチャント登録申請時に設定した
値を使用
2 者間

指定できません。

× ×

×

×

×

×

3 者間

※ 3 者間の継続課金終了の場合に指定可能なパラメータ

△ ×

×

×

△

△

継続課金終

URL に使用可

了キャンセル

能な半角文

継続課金終了キャンセル後に、店舗側サイトに画面遷移を戻すための URL を指定

時 URL

字

※未指定の場合は、Authorize 時に指定された値、またはマーチャント登録申請時に設定した
値を使用
2 者間

指定できません。

× ×

×

×

×

×

3 者間

※3 者間の継続課金終了の場合に指定可能なパラメータ

△ ×

×

×

△

△

× ×
△ ×

×
×

×
×

×
△

×
△

× ×

×

×

×

×

継続課金終

URL に使用可

了エラー時

能な半角文

継続課金終了エラー時に、店舗側サイトに画面遷移を戻すための URL を指定

URL

字※未指定の場合は、Authorize 時に指定された値、またはマーチャント登録申請時に設定したURL に使用可

FL

×

継続課金終

プッシュ URL

SA× ×1024 桁以内

pushUrl

SB

指定できません。

1024 桁以内

errorUrl

継 随

2 者間

1024 桁以内

cancelUrl

随

AU

値を使用
2 者間

指定できません。

3 者間※3 者間の継続課金終了の場合に指定可能なパラメータ

能な半角文「ダミー取引」時のプッシュ URL を指定

字※本パラメータは開発時にのみ利用されることを想定しており、ダミー取引で指定可能です。

1024 桁以内※未指定の場合は、Authorize 時に指定された値、またはマーチャント登録申請時に DB に設定された値を使用
2 者間指定できません。

25

VeriTrans4G インターフェース詳細 ～キャリア決済～

2.5.2 応答電文 ： CarrierTerminateResponseDto
応答電文 ： CarrierTerminateResponseDto
フィールド名
serviceType

項目名
決済サービスタイプ

書式・制限

説明

設定

要求電文を送信した決済サービスタイプ

○

半角英数字

"success" ： 正常終了○

32 文字以内"failure"

半角英数字
10 桁以内mstatus

処理結果コード： 異常終了"pending" ： 保留vResultCode

詳細結果コード

半角英数字

処理の結果を詳細に表すコード

16 文字

4 桁ずつ 4 つのブロックで構成され、各ブロックでサービス毎の処理結果を表します。

○

詳細は別途『結果コード一覧』をご参照ください。
merrMsg

エラーメッセージ

marchTxn

電文 ID

処理結果を日本語で表示します。

○

文字列

決済サーバーにて決済処理電文（内部処理も含む）毎に付与する ID○

100 桁以内

１つの取引 ID に対して、複数の ID が付与されます。

半角英数字

決済要求時に店舗様にて任意に採番し送信された取引 ID○

決済サーバーがオーダー（取引 ID）と紐付ける為に採番する ID

○

半角英数字

電文のバージョン○

5桁

問題発生時などに用いますが、通常ご利用になることはありません。

文字列 14 桁

3 者間

返戻されません。

×

2 者間※2 者間の継続課金終了の場合に返戻されます。

○

文字列1024 バイト以内

orderId

取引 ID

100 文字以内
custTxn

取引毎に付く ID

文字列
100 桁以内

txnVersion
terminateDatetime

MDK バージョン
継続課金終了日時YYYYMMDDhhmmss 形式

26

VeriTrans4G インターフェース詳細 ～キャリア決済～

応答電文 ： CarrierTerminateResponseDto
フィールド名
responseContents

項目名
レスポンス

書式・制限
文字列

3 者間

コンテンツ

説明

設定

※3 者間の継続課金終了の場合に返戻されます。

○

店舗様側でコンシューマに対して返戻する HTML コンテンツ
本パラメータを利用して、消費者の端末からキャリアの提供する画面への遷移を制御して頂く必要があります。
自動でキャリアの画面に遷移するための JavaScript を含みます。本パラメータが返戻された場合は、そのままの内容を消費者のブラウザに返戻します。
返戻するコンテンツの文字コードはキャリアによって異なりますので、正しい文字コードでレスポンスする必要が
あります。
キャリア

PC/スマートフォンの場合

フィーチャーフォンの場合

DO

Shift-JIS

Shift-JIS

AU

－

SB

－

SA

UTF-8

－

FL

UTF-8

－

※JavaScript を利用可能な端末では自動でキャリアの画面に遷移します。フィーチャーフォンなどの JavaScriptが利用できない端末では、ボタン押下によりキャリアの画面に遷移します。
2 者間

返戻されません。

×27

VeriTrans4G インターフェース詳細 ～キャリア決済～

2-6 再与信
随時決済の取引で、再度与信を取得する際に ReAuthorize コマンドを利用します。
ReAuthorize コマンドで成立した取引に対しては、都度決済と同様に Capture／Cancel コマンドを利用することが可能です。

2.6.1 要求電文 ： CarrierReAuthorizeRequestDto
要求電文 ： CarrierReAuthorizeRequestDto
フィールド名orderId

項目名
取引 ID

書式・制限
半角英数字

説明

設定
DO

AU

SB

SA

FL

新たに与信を取得するために新規採番した取引 ID

○

○

×

×

×

利用するキャリア決済のタイプを指定

○

○

×

×

×

○

○

×

×

×

△

△

×

×

×

○

○

×

×

×

100 桁以内
serviceOption

サービスオプTypeションタイプoriginalOrderI

元取引 ID

d

右記参照

半角英数字

"docomo"

：d 払い

"au"

：au かんたん決済、auPAY（ネット支払い）

決済申込時に指定し、随時決済の利用承諾を取得した取引 ID

100 桁以内※取引 ID は通常約 400 日で決済サーバーから削除されますが、随時決済の利用承諾の取引 ID は継続して再与信に使用していれば、取得から４００日を経過しても決済サーバーから削除されません。ただし、一定期間、再与信の発生がなかった場合は、キャリア側で利用承諾終了となり、利用できなくなります。

withCapture

与信同時売

英字

売上フラグを指定

上フラグ（boolean）※未指定の場合は、"false"
ただし、与信同時売上のみを許可するキャリアの場合は"true"とみなす。
"true" ：与信同時売上"false" ：与信のみ

amount

決済金額

半角数字

キャリア毎に上限金額が規定されています。

12 桁以内詳細は『キャリア決済サービス 補足資料』をご参照ください。

28

VeriTrans4G インターフェース詳細 ～キャリア決済～

2.6.2 応答電文 ： CarrierReAuthorizeResponseDto
応答電文 ： CarrierReAuthorizeResponseDto
フィールド名
serviceType

項目名
決済サービスタイプ

書式・制限

説明

設定

要求電文を送信した決済サービスタイプ

○

半角英数字

“success” ： 正常終了○

32 文字以内“failure”

半角英数字
10 桁以内mstatus

処理結果コード： 異常終了“pending” ： 保留vResultCode

詳細結果コード

半角英数字

処理の結果を詳細に表すコード

16 文字

4 桁ずつ 4 つのブロックで構成され、各ブロックでサービス毎の処理結果を表します。

○

詳細は別途『結果コード一覧』をご参照ください。
merrMsg

エラーメッセージ

marchTxn

電文 ID

処理結果を日本語で表示します。

○

文字列

決済サーバーにて決済処理電文（内部処理も含む）毎に付与する ID○

100 桁以内

１つの取引 ID に対して、複数の ID が付与されます。

半角英数字

決済要求時に店舗様にて任意に採番し送信された取引 ID○

決済申込時に指定し、随時決済の利用承諾を取得した取引 ID○

キャリア側で取引を特定する ID○

文字列1024 バイト以内

orderId

取引 ID

100 文字以内
originalOrderId

元取引 ID

半角英数字
100 桁以内

crOrderId

キャリア側取引 ID

半角英数字 16 桁以
内

custTxn

取引毎に付く ID

文字列 100 桁以内

決済サーバーがオーダー（取引 ID）と紐付ける為に採番する ID○

txnVersion

MDK バージョン

半角英数字 5 桁

電文のバージョン○問題発生時などに用いますが、通常ご利用になることはありません。
txnTime

処理日時

文字列 14 桁

YYYYMMDDhhmmss 形式○

29

VeriTrans4G インターフェース詳細 ～キャリア決済～

2-7 消費者ブラウザから店舗側の完了画面へリダイレクトする時のクエリパラメータ
以下のパラメータはエラーおよびキャンセル時も同様。

リダイレクト受信内容：決済サーバーから消費者ブラウザ経由で店舗へリダイレクト(GET)される内容
フィールド名mstatusvResultCode

項目名
処理結果コード
詳細結果コード

書式・制限

説明

半角英数字

"success" ： 正常終了

32 文字以内"failure"

半角英数 4 桁処理の結果を詳細に表すコード

設定○： 異常終了○詳細は別途『結果コード一覧』をご参照ください。
orderId

決済要求時に店舗様にて任意に採番し送信された取引 ID○

文字列

通知対象となるコマンドが設定されます。

○

右記参照

"Authorize" または "Terminate"

改ざんチェック用

文字列

下記文字列を連結し、SHA-256 によって算出したハッシュ値

ハッシュ値

右記参照

取引 ID

半角英数字
100 桁以内

commandvAuthInfo

コマンド○

・マーチャント CCID
・パラメータ値の連結文字列（authParams が示す順序で連結）・マーチャント認証鍵
尚、パラメータ値を連結する際は、パラメータ名や区切り文字は含めず、パラメータ値のみを連結しています。連結した文字
列をバイナリに変換する際の文字エンコーディングは、UTF-8 を使用しています。

authParams

ハッシュ値算出パ

文字列

vAuthInfo のハッシュ値を算出する元とした文字列の、パラメータの連結順序を示す値

ラメータ順序右記参照

パラメータ名のカンマ区切り文字列を Base64 エンコードしています。デコードを行うと文字列が復元されます。

○

例)"mstatus,vResultCode,orderId,command""orderId,mstatus,command,vResultCode"（順序は固定ではないため、リクエスト受信のたびに動的に処理する必要があります。）（重要）

これらのパラメータはブラウザを経由して連携されるため、画面遷移が正常に行われないケースでは取得することができません。そのため、決済サーバーから直接送信される「2-8 結果通知」の受信と組み合わせて確実に結果を取得するようにしてください。

30

VeriTrans4G インターフェース詳細 ～キャリア決済～

2-8 結果通知
キャリア決済における結果通知電文の通知タイミングは、大きく分けて３つのタイミングに分かれます。
(1) 決済に消費者ブラウザが介在する場合、申込完了を通知するケース(2) 継続課金処理の結果を通知するケース(3) 随時決済の抹消を通知するケース
結果通知に関するサービス共通の仕様については、『開発ガイド』、および『キャリア決済サービス 補足資料』を併せてご参照ください。

項番
1
2
3

フィールド名numberOfNotify

項目名
通知件数

書式・制限
半角数字 4 桁以内

説明
1 度に通知可能な件数は 50 件
51 件以上は次回通知

pushTime

送信時刻

半角数字 14 桁

決済サーバーから通知した時刻 YYYYMMDDhhmmss 形式

pushId

識別 ID

半角数字 8 桁

プッシュ処理を行うたびに採番される ID
注） 他の決済サービスで使用された ID と重複する場合があります。

通知件数分下記の項番（4～12）を繰り返す。尚、フィールド名の後ろに 4 ケタの連番（0000～0999）を付与する。
4

orderId

取引 ID

半角英数字 100 桁以内

txnType

トランザクションタイプ

半角英数字 32 桁以内

5

取引 ID
トランザクションタイプ

都度決済

継続課金

随時決済

"Authorize"： 決済申込完了○○○"Terminate"： 継続課金終了申込完了

×

○

×

"MCapture"： 継続課金結果

×○×"Deregistration"： 継続課金抹消

×

○

○

6

txnTime

処理日時

半角数字 14 桁

YYYYMMDDhhmmss 形式

7vResultCode

詳細結果コード

半角英数字 4 桁

処理結果コードの詳細は、別冊『結果コード一覧』をご参照ください。

mstatus

処理ステータス

半角英数字 8 桁以内"success "： 正常終了"failure"： 異常終了

8

以下は、決済申込完了通知（Authorize）の場合に連携される項目です。
910

crOrderId

キャリア側取引 ID

半角英数字 16 桁以内

キャリア側で取引を特定する ID

openIdOpen ID

半角英数字 256 桁以内

docomo および au より発行された、消費者を識別する OpenID を連携します。
例） https://i.mydocomo.com/id/BG6...
31

VeriTrans4G インターフェース詳細 ～キャリア決済～
以下は、継続課金結果通知（MCapture）の場合に連携される項目です。
11

month

課金年月

半角数字 6 桁

YYYYMM 形式

半角数字 1 桁

ダミー取引を示す場合は"1"を設定

以下は、必ず連携される項目です。
12

dummy

ダミー決済フラグ（注意事項）


pushId（識別 ID）は、他の決済サービスで使用された Id と重複する場合がありますので、ユニークキーとして処理しないようにしてください。



項目の並び順は、必ずしも表の順序とは一致しません。

32

VeriTrans4G インターフェース詳細 ～キャリア決済～

第3章 その他 補足事項
3-1 キャリア決済
3.1.1 （重要）au かんたん決済の与信が KDDI 側で取り消される問題について
au かんたん決済では、売上要求時点で消費者の契約状態に変更があった場合（*）には、与信有効期限内であっても売上確定に失敗する場合があります。
この場合、決済サーバーは結果コード：WG13 を返戻します。この取引については、KDDI 側で与信自体が取消となり、該当の取引に対しては売上を立てることができませんので、消費者にご連絡のうえ、
注文の取消や代替手段での請求をご検討ください。
また、この問題によるトラブルを防ぐためには、必ず売上が成功後に商品の発送やサービスの提供を行う運用をご検討ください。
なお、ドコモおよびソフトバンクにはこのような仕様はございません。与信が成立した取引については、与信有効期限内であれば売上は成功します。
(*) 消費者の契約状態は、料金未払いによるものや回線解約等がございますが、KDDI から詳細な情報は開示されません。

3.1.2 機種依存文字について
決済サーバーに送信する電文の文字エンコーディングは UTF-8 ですが、キャリア側のインターフェースでは UTF-8、および Shift-JIS が利用されます。したがって、一部の Shift-JIS（MS932 含む）などの機種依存文字は利用できません。
利用できない文字を設定した場合は、消費者の画面での文字化けや、キャリア側での決済処理が失敗する場合がありますので、決済サーバーでは、以下の検証により許可する全角文字列の判定を行っています。
・UTF-8 から Shift-JIS に変換後、再度 UTF-8 に変換した文字が、元の文字と同一であること。

この判定によって、以下のような文字を含む場合はエラーとなりますので、ご注意ください。
利用できない文字

対処方法"―" 全角ダッシュ

利用可能な以下の文字で代用する等をご検討く"－" 全角マイナス

ださい。

"～" 全角波形"‐" 全角ハイフン"ー" 全角長音

その他の機種依存文字

利用可能な文字での代用をご検討ください。

33

VeriTrans4G インターフェース詳細 ～キャリア決済～

3.1.3 キャリアから消費者への配信メールについて
各キャリアより消費者へ OpenID 発行時、与信時等にメールが送信されます。
尚、テスト ID 及び、DUMMY_REQUEST を 1 に設定した場合は、本メールは送信されません。

各キャリア／サービスとメール送信のタイミングを下表に記載します。
送信タイミング

キャリア／サービス

OpenID 発行時
料金合算払いなし

ドコモ口座払い

なし

料金合算払いなし

ドコモ口座払いなし

sp モード
d 払い
i モード

与信時

与信取消時

○

なし

△

○

売上時

（都度／継続のみ）△（随時決済のみ）△（都度／継続のみ）

なし
なし

売上取消時
△
（部分返金のみ）
○
△

再与信時
○
なし

なし

なし

○

なし

○

なし

（部分返金のみ）○

au かんたん決済、

都度、随時

○

なし

なし

○

○

なし

auPAY（ネット支払い）

継続

○

○

-

－

○

-

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

－

○

なし

なし

なし

-

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

なし

○

-

－

－

-

フレッツまとめて支払い

－

○

○

なし

○

-

各キャリアのメール送信について、詳細を下記表に記載します。
d 払い

ISP 種別支払方法

sp モード

料金合算払い配信タイミング
単一決済時

配信メール種別
sp モードメール

連絡内容
利用内容の連絡※メール本文に、以下の情報が出力されます。
【詳細情報】
・マーチャント登録申請時にご登録頂いたサイト名
・MDK（Authorize）の商品情報（itemInfo）【ご利用代金】・MDK（Authorize）の決済金額（amount）※随時決済の場合は出力されません。
34

VeriTrans4G インターフェース詳細 ～キャリア決済～
ISP 種別支払方法

配信タイミング

配信メール種別

連絡内容【課金種別】
・MDK（Authorize）の課金種別（accountingType）

sp モードドコモ口座払い

単一決済時

メッセージ R

出金内容の連絡※メール本文に、以下の情報が出力されます。
【ご利用代金】・MDK（Authorize）の決済金額（amount）

sp モードドコモ口座払い

与信取消時

メッセージ R

購入取消し金額を連絡※メール本文に、以下の情報が出力されます。
【取消金額】
・MDK（Authorize）の決済金額（amount）

sp モード

料金合算払い

部分返金時

sp モードメール

部分返金内容の連絡※メール本文に、以下の情報が出力されます。
【ご利用代金（変更前）】
・部分返金前の決済金額【ご利用代金（変更後）】
・部分返金後の決済金額【お支払い予定月】
・変更後の金額で請求する年月

sp モードドコモ口座払い

部分返金時

メッセージ R

返金金額を連絡※メール本文に、以下の情報が出力されます。
【返金日時】
・加盟店が部分返金を行った年月日時【返金金額】
・部分返金により返金されドコモ口座に入金した金額

sp モードドコモ口座払い

決済取消時

メッセージ R

購入取消し金額を連絡※メール本文に、以下の情報が出力されます。
【取消金額】
・MDK（Authorize）の決済金額（amount）

sp モード

料金合算払い

再与信時

sp モードメール

利用内容の連絡※メール本文に、以下の情報が出力されます。
【詳細情報】
・マーチャント登録申請時にご登録頂いたサイト名
・決済申込（Authorize）時の商品情報（itemInfo）【ご利用代金】・MDK（Authorize）の決済金額（amount）
35

VeriTrans4G インターフェース詳細 ～キャリア決済～
ISP 種別支払方法

配信タイミング

配信メール種別

連絡内容※随時決済の場合は出力されません。
【課金種別】
・MDK（Authorize）の課金種別（accountingType）

i モード

料金合算払い単一決済時

i モードメール

利用内容の連絡※メール本文に、以下の情報が出力されます。
【詳細情報】
・マーチャント登録申請時にご登録頂いたサイト名
・MDK（Authorize）の商品情報（itemInfo）【課金種別】
・MDK（Authorize）の課金種別（accountingType）

i モード

ドコモ口座払い

単一決済時

メッセージ R

出金金額を連絡※メール本文に、以下の情報が出力されます。
【ご利用代金】・MDK（Authorize）の決済金額（amount）

i モード

ドコモ口座払い

与信取消時

メッセージ R

購入取消し金額を連絡※メール本文に、以下の情報が出力されます。
【取消金額】
・MDK（Authorize）の決済金額（amount）

i モード

料金合算払い部分返金時

i モードメール

部分返金内容の連絡※メール本文に、以下の情報が出力されます。
【ご利用代金（変更前）】
・部分返金前の決済金額【ご利用代金（変更後）】
・部分返金後の決済金額【お支払い予定月】
・変更後の金額で請求する年月

i モード

ドコモ口座払い

部分返金時

メッセージ R

返金金額を連絡※メール本文に、以下の情報が出力されます。
【返金日時】
・加盟店が部分返金を行った年月日時【返金金額】
・部分返金により返金されドコモ口座に入金した金額

i モード

ドコモ口座払い

決済取消時

メッセージ R

購入取消し金額を連絡※メール本文に、以下の情報が出力されます。
【取消金額】
36

VeriTrans4G インターフェース詳細 ～キャリア決済～
ISP 種別支払方法

配信タイミング

配信メール種別

連絡内容
・MDK（Authorize）の決済金額（amount）

i モード

料金合算払い再与信時

i モードメール

利用内容の連絡※メール本文に、以下の情報が出力されます。
【詳細情報】
・マーチャント登録申請時にご登録頂いたサイト名
・決済申込（Authorize）時の商品情報（itemInfo）【ご利用代金】・MDK（Authorize）の決済金額（amount）【課金種別】
・MDK（Authorize）の課金種別（accountingType）



au かんたん決済、auPAY（ネット支払い）
課金タイプ

都度、

継続

送信タイミング
OpenID 発行時

随時

連絡内容
ID 連携通知メール※メール本文に、以下の情報が出力されます。
【パートナー名】
・店舗様がキャリア決済のお申込時に指定した【会社名略称】

都度、
随時

－

売上確定／与信＆売上確定

売上確定メール※メール本文に、以下の情報が出力されます。
【パートナー名】
・店舗様がキャリア決済のお申込時に指定した【会社名略称】【サービス名】・店舗様がキャリア決済のお申込時に指定した【サイト名ユーザ表示用】【摘要】・MDK（Authorize）の商品情報（itemInfo）【商材種別】
・店舗様が提供する商材の種別が表示されます。
【お問合せ先】
・店舗様がキャリア決済のお申込時に指定した【お問い合わせ窓口：電話番号】【商品金額】
・MDK（Authorize）の決済金額（amount）

37

VeriTrans4G インターフェース詳細 ～キャリア決済～
課金タイプ
－

継続

送信タイミング
与信

連絡内容
継続課金利用登録メール※メール本文に、以下の情報が出力されます。
【パートナー名】
・店舗様がキャリア決済のお申込時に指定した【会社名略称】【サービス名】・店舗様がキャリア決済のお申込時に指定した【サイト名ユーザ表示用】【摘要】・「毎月○○日に課金」の旨の内容に続けて、MDK（Authorize）の商品情報（itemInfo）が表示されます。
【商材種別】
・店舗様が提供する商材の種別が表示されます。
【お問合せ先】
・店舗様がキャリア決済のお申込時に指定した【お問い合わせ窓口：電話番
号】【初回課金日】・MDK（Authorize）の初回課金年月日（mpFirstDate）【初回ご利用代金】
・MDK（Authorize）の決済金額（amount）【翌月以降課金タイミング】
・MDK（Authorize）の継続課金日（mpDay）が"99"の場合は、『月末』
それ以外の場合は、『指定日』と表示される【翌月以降課金日】
・MDK（Authorize）の継続課金日（mpDay）が"99"の場合は、表示されない
それ以外の場合は、指定した日が表示される【翌月以降ご利用代金】
・MDK（Authorize）の決済金額（amount）

38

VeriTrans4G インターフェース詳細 ～キャリア決済～
課金タイプ
都度、

継続

送信タイミング
売上取消

随時

連絡内容
売上取消メール※メール本文に、以下の情報が出力されます。
【パートナー名】
・店舗様がキャリア決済のお申込時に指定した【会社名略称】【サービス名】・店舗様がキャリア決済のお申込時に指定した【サイト名ユーザ表示用】【摘要】・MDK（Authorize）の商品情報（itemInfo）※継続課金の場合上記の前に、「毎月○○日に課金」の旨の内容を決済サーバーから指定します。
【商材種別】
・店舗様が提供する商材の種別が表示されます。
【お問合せ先】
・店舗様がキャリア決済のお申込時に指定した【お問い合わせ窓口：電話番号】【商品金額】
・MDK（Authorize）の決済金額（amount）

都度、
随時

－

部分返金時

金額変更メール※メール本文に、以下の情報が出力されます。
【パートナー名】
・店舗様がキャリア決済のお申込時に指定した【会社名略称】【サービス名】・店舗様がキャリア決済のお申込時に指定した【サイト名ユーザ表示用】【摘要】・MDK（Authorize）の商品情報（itemInfo）【お問合せ先】
・店舗様がキャリア決済のお申込時に指定した【お問い合わせ窓口：電話番号】【変更金額】
・MDK（Cancel）の返金金額（amount）※マイナス値で出力されます。
※MDK で金額を指定しなかった場合は、部分返金時の残高が出力されます。

39

VeriTrans4G インターフェース詳細 ～キャリア決済～


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

課金タイプ
都度

継続

送信タイミング

連絡内容

与信

利用内容の連絡※メール本文に、以下の情報が出力されます。
【金額】
・MDK（Authorize）の決済金額（amount）※継続課金の場合、金額は表示されません。
【購入内容】
・直接契約加盟店の場合、MDK（Authorize）の商品情報（itemInfo）、
包括契約加盟店の場合、決済代行事業者専用の固定文言になります。
【サービス名】・マーチャント登録申請時に弊社へご登録頂いたサイト名【サービス提供元】
・マーチャント登録申請時に弊社へご登録頂いたサイト名

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

課金タイプ
都度

継続

送信タイミング

連絡内容

与信

利用内容の連絡※メール本文に、以下の情報が出力されます。
【購入金額】
・MDK（Authorize）の決済金額（amount）【購入内容】
・MDK（Authorize）の商品情報（itemInfo）【サービス名】・店舗様がソフトバンクと契約した際に登録したサービス名称【サービス提供元】
・店舗様がソフトバンクと契約した際に登録した加盟店様名称

40

VeriTrans4G インターフェース詳細 ～キャリア決済～

フレッツまとめて支払い

課金タイプ
都度

継続

送信タイミング

連絡内容

与信

ご購入手続き完了のお知らせ※メール本文に、以下の情報が出力されます。
【販売事業者】
・店舗様の会社名（加盟店名）【合計（料金）】・MDK（Authorize）の決済金額（amount）【商品名】
・マーチャント登録申請時に本サービスへご登録頂いたサイト名 ＋MDK（Authorize）の商品情報（itemInfo）

都度

継続

与信または売上の取消

ご購入金額の変更のお知らせ※メール本文に、以下の情報が出力されます。
【販売事業者】
・店舗様の会社名（加盟店名）【変更前の金額】
・MDK（Authorize）の決済金額（amount）【変更後の金額】
・取消のため、0 円と表示されます。
【商品名】
・マーチャント登録申請時に弊社へご登録頂いたサイト名 ＋MDK（Authorize）の商品情報（itemInfo）

都度

継続

フレッツ回線以外からのアクセ

ご購入確認スにおける認証時※メール本文に、以下の情報が出力されます。
【販売事業者】
・店舗様の会社名（加盟店名）【合計（料金）】・MDK（Authorize）の決済金額（amount）【商品名】
・マーチャント登録申請時に弊社へご登録頂いたサイト名 ＋MDK（Authorize）の商品情報（itemInfo）【購入手続きを進めるための URL】
・この URL をクリックすると、フレッツまとめて支払いのサーバに接続し、購入手続きを続行します。

41

VeriTrans4G インターフェース詳細 ～キャリア決済～

3.1.4 随時決済：au かんたん決済/auPAY（ネット支払い）の itemInfo 設定について
au かんたん決済、auPAY（ネット支払い）ウェブ方式の随時決済を利用する場合、申込要求電文(CarrierAuthorizeRequestDto)の itemInfo(商品情報)について、決済事業者仕様に従って情報を設定してください。

書式・制限

全角、最大 24 文字

au かんたん決済
商品名（サービス名）＋課金タイミング例）旬の果物５０００円分お届け■３か月毎に１日に課金※必ず、■（全角スペース）を入れてください。

auPAY（ネット支払い）ウェブ方式
商品名（サービス名）＋お客様問合せ対応時に必要となる商品コード例）○○サービス利用料■商品コード：＊＊＊＊※■（全角スペース）の有無は任意。

42