VeriTrans4G インターフェース詳細 ～検索～

VeriTrans4G インターフェース詳細～検索～Ver. 1.0.8 （2024 年 08 月～）

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

VeriTrans4G インターフェース詳細 ～検索～目次
第1章

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

1-1 本ガイドの内容 ......................................................................................................................................................................................................................................................3
1-2 著作権、および問い合わせ先 .................................................................................................................................................................................................................................3
1-3 改訂履歴...............................................................................................................................................................................................................................................................3

第2章

インターフェース詳細 ～検索～ ........................................................................................................................................................................................... 5

2-1 共通 ......................................................................................................................................................................................................................................................................5
2-2 検索 ......................................................................................................................................................................................................................................................................6
2.2.1 要求電文 ： SearchRequestDto .............................................................................................................................................................................................................................................. 6
2.2.2 応答電文 ： SearchResponseDto ...........................................................................................................................................................................................................................................15

2-3 検索 マスタ情報取得 .......................................................................................................................................................................................................................................... 28
2.3.1 要求電文 ： SearchRequestDto .............................................................................................................................................................................................................................................28
2.3.2 応答電文 ： SearchResponseDto ...........................................................................................................................................................................................................................................28

2-4 ダミーマーチャントでの検索 .................................................................................................................................................................................................................................. 29

2

VeriTrans4G インターフェース詳細 ～検索～

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

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

tech-support@veritrans.jp

1-3 改訂履歴
2017/04 ：Ver1.0.0 リリース
※ 以下、「VeriTrans3G インターフェース詳細 ～検索～」 Ver 2.0.2 からの更新分を記載します。
「2.2.1 要求電文」「2.2.2 応答電文」各パラメータの「centerTradeId」の書式・制限を”半角英数字”から”文字列”に修正「2.2.2 応答電文」銀聯ネット決済のパラメータに「resUpopOrderId(決済センターとの取引 ID)」を追記「2.2.2 応答電文」trAd に関する行を削除
2018/02 ：Ver1.0.1 リリース
「2.2.1 要求電文」の「コマンド」の説明を修正。
「2.2.1 要求電文」コンビニ決済のパラメータに「payLimitDatetime.f rom」，「payLimitDatetime.to」項目を追記
2018/07 ：Ver1.0.2 リリース
「2.2.2 応答電文」の銀行決済の受付番号の書式・制限と説明を修正
3

VeriTrans4G インターフェース詳細 ～検索～2019/03 ：Ver1.0.3 リリース
「2.2.2 応答電文」「2.3.2 応答電文」の階層を修正「2-4 ダミーマーチャントでの検索」を追加「2.2.1 要求電文」「2.2.2 応答電文」「2.3.1 要求電文」の説明内の誤字修正および表記統一「2.2.2 応答電文」「2.3.2 応答電文」から merrMsg を削除
2021/07 ：Ver1.0.4 リリース
「2.2.1 要求電文」の Alipay 決済の detailOrderType にバーコード決済の説明を追記「2.2.2 応答電文」の alipayTxnType にバーコード決済の説明を追記「2.2.2 応答電文」に serviceType を追加「2.2.1 要求電文」のクレジットカード決済に「dddDsTransactionId」「dddServerTransactionId」を追加「2.2.2 応答電文」のクレジットカード決済に「req3dDsTransactionId」「req3dServerTransactionId」を追加
2023/02 ：Ver1.0.5 リリース
「2-1 共通」に以下の説明を追加（重要）
検索条件は、決済サービス毎に様々な条件を指定可能ですが、原則として必ず「取引 ID」を条件に含めた検索を行って頂きますようお願いします。取引 ID を条件に含まない検索を実施
された場合、データ量によってはレスポンス遅延や、想定外の結果が返戻される場合がございます。取引 ID を含まない、複雑な条件での検索を実施される場合は、事前にテクニカルサ
ポートまでご相談下さい。
「2.2.1 要求電文」「2.2.2 応答電文」から、MPI（3D セキュア）の内容を削除 （別冊の 3D セキュア 2.0 ご利用ガイドに移動）「2-4 ダミーマーチャントでの検索」の説明の誤りを修正
誤：決済種別正：決済サービスタイプ（serviceTypeCd）
2023/06 ：Ver1.0.6 リリース
「2.2.1 要求電文」のコンビニ決済の cvsType に"famima"、"lawson"を追加。サークル K サンクスを削除「2.2.2 応答電文」のコンビニ決済の cvsType に"famima"、"lawson"を追加。サークル K サンクスを削除「2.2.2 応答電文」「2.3.2 応答電文」に merrMsg を追加
2023/09 ：Ver1.0.7 リリース
サービス終了のため「永久不滅ポイント決済」に関する記載を削除「2.2.1 要求電文」「2.2.2 応答電文」から、"mpi"： MPI ホスティングを削除 （別冊の 3D セキュア 2.0 ご利用ガイドに移動）
2024/08 ：Ver1.0.8 リリース
「2-4 ダミーマーチャントでの検索」ダミーマーチャントでの最大検索結果件数を追記

4VeriTrans4G インターフェース詳細 ～検索～

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

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

任意項目：△

設定不可：×

応答電文 … 必ず返戻：○

処理成功時のみ返戻：△

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

返戻なし：×

その他条件付：※■複数指定は 0～の添字を指定します。
例：exparam.serviceTypeCd[0]=card&exparam.serviceTypeCd[1]=paypal■ワイルドカードは値の一部と"*"を組み合わせて検索します。"*"のみの指定はできません。
例：exparam.searchParameters.common.orderId=123*
注） ワイルドカード検索につきましては、処理時間（応答時間）が非常に長くなる可能性がございますので、後方一致や中間一致のご指定は控えて頂きますようお願いいたします。また、他の検索
条件と組み合わせることで対象範囲が限定されるような検索条件をご検討下さい。

■FROM～TO の指定を行った際の検索は from で指定した値以上、to で指定した値未満となります。
例：paidDatetime.from <= 入金日時 < paidDatetime.to（重要）
検索条件は、決済サービス毎に様々な条件を指定可能ですが、原則として必ず「取引 ID」を条件に含めた検索を行って頂きますようお願いします。取引 ID を条件に含まない検索を実施された場合、データ量によってはレスポンス遅延や、想定外の結果が返戻される場合がございます。取引 ID を含まない、複雑な条件での検索を実施される場合は、事前にテクニカルサポートまでご相談下さい。

5VeriTrans4G インターフェース詳細 ～検索～

2-2 検索2.2.1 要求電文 ： SearchRequestDto
要求電文 ： SearchRequestDto
検索フィールド名

検索項目名

書式・制限

requestId

リクエスト ID

半角英数字記号 128 文
字以内

serviceTypeCd

決済サービスタイプ

右記参照

newerFlag

最新トランザクションフ
ラグ

右記参照

containDummyFlag

ダミー決済対象フラグ

右記参照

maxCount

検索最大件数

1～1000

複数
指定

○

ﾜｲﾙﾄﾞ
ｶｰﾄﾞ

説明

設定

リクエスト ID を指定します。指定した場合は、それ以外のパラメータは指定できません。

△

検索対象の決済を指定
未指定の場合は、全決済が検索対象です。
"card"： カード決済"cvs"： コンビニ決済"em"： 電子マネー決済"bank"：銀行決済"upop"： 銀聯ネット決済（UPOP）"paypal"： PayPal 決済"alipay"：Alipay 決済"carrier"： キャリア決済"oricosc"： ショッピングクレジット決済
成功、失敗に関係なく、最新トランザクションのみを検索する場合に使用"true"： 1 取引内の最新トランザクションのみ検索"false"： 全てのトランザクションを検索※指定しない場合は"false"になります。

△

ダミー取引も検索する場合に使用"true"： ダミー取引も検索する"false"： ダミー取引は検索しない※指定しない場合は"false"になります。
取得したい検索結果の最大件数
未指定の場合、最大値となります。
※短時間で大量の検索を繰り返すような処理はサーバに負荷が掛かりますのでご遠慮頂けますようお願いします。

△

△

△

6

VeriTrans4G インターフェース詳細 ～検索～

common共通○

検索したい取引 ID を指定△△

orderId

取引 ID

半角英数字 100 桁以内

orderStatus

取引決済状態

右記参照○

以下のいずれかを指定" initial "：初期状態" end "：終了
" end_presentation "：画面遷移正常終了" pending "：保留" validation_error "：検証エラー" expired "：期限切れ" error "：エラー

command

コマンド

右記参照

○

決済で使用するコマンドを指定※指定可能なコマンドは、決済サービス毎に異なります。
『VeriTrans4G 開発ガイド』の「利用可能な MDK コマンド」を参照して下さい。

△

mstatusステータスコード

右記参照

○

△

txnDatetime.from

取引日（From）

文字列 12 桁

txnDatetime.to

取引日（To）

文字列 12 桁

決済結果として返戻されるステータスコードを指定" success "：成功" failure "：失敗
" pending "：保留
取引日時の範囲（From）を指定
YYYYMMDDhhmm 形式
取引日時の範囲（To）を指定
YYYYMMDDhhmm 形式

amount.fromamount.to

金額（From）
金額（To）

数字 12 桁以内
数字 12 桁以内

決済金額の範囲（From）を指定
決済金額の範囲（To）を指定

△
△

△
△

7

VeriTrans4G インターフェース詳細 ～検索～card

クレジットカード決済

detailOrderType

詳細取引決済状態

右記参照

dddTransactionId

3D トランザクション ID

半角英数字、"+"、"-"、"="
28 文字 or 0 文字

dddDsTransactionId

3DDS トランザクション
ID
3D サーバトランザクシ
ョン ID

半角英数字
36 文字 or 0 文字
半角英数字
36 文字 or 0 文字

dddServerTransactio
nId○

決済個別の詳細ステータスを指定"a"：与信"ax"：与信（期限切れ）"ap"：与信（保留）"ac"：与信売上"acp"：与信売上（保留）"pa"：売上"rn"：新規返品"rnp"：新規返品（保留）"va"、"rad"、"rae"：与信→取消"vap"、"rap"：与信→取消（保留）"vac"、"racd"、"race"：与信売上→取消"vacp"、"racp"：与信売上→取消（保留）"vpa"、"rpad"、"rpae"：売上→取消"vpap"、"rpap"：売上→取消（保留）3D トランザクション ID（3d-xid）を指定△

3DDS トランザクション ID を指定△

3D サーバトランザクション ID を指定

△

△

8

VeriTrans4G インターフェース詳細 ～検索～

cvs

コンビニ決済決済個別の詳細ステータスを指定"authorize"：決済請求"cancel_authorize"：決済請求取消"capture"：決済完了（入金済）"fix_capture"：決済完了（入金確定）"cancel_capture"：決済完了（入金取消）
コンビニを指定"sej"：セブン－イレブン"econ"：イーコン（ローソン、ファミリーマート、ミニストップ、セイコーマート）"other"：その他（デイリーヤマザキ）"famima"：ファミリーマート"lawson"：ローソン(ローソン、ミニストップ、セイコーマート)△

文字列 12 桁

支払期限の範囲（From）を指定
YYYYMMDDhhmm 形式※支払期限日時(From)を指定している場合は、当項目の指定は不要△

支払期限（To）

文字列 12 桁

支払期限の範囲（To）を指定
YYYYMMDDhhmm 形式※支払期限日時(To)を指定している場合は、当項目の指定は不要△

payLimitDatetime.from

支払期限日時（From）

文字列 12 桁△

payLimitDatetime.to

支払期限日時（To）

文字列 12 桁

支払期限日時の範囲（From）を指定
YYYYMMDDhhmm 形式※決済申込時に支払期限時分を指定している場合は、指定した時分単位での絞り込みが可能※支払期限(From)を指定している場合は、当項目の指定は不要
支払期限日時の範囲（To）を指定
YYYYMMDDhhmm 形式※決済申込時に支払期限時分を指定している場合は、指定した時分単位での絞り込みが可能※支払期限(To)を指定している場合は、当項目の指定は不要

paidDatetime.from

入金受付日（From）

文字列 12 桁

入金受付日の範囲（From）を指定
YYYYMMDDhhmm 形式△

paidDatetime.to

入金受付日（To）

文字列 12 桁

入金受付日の範囲（To）を指定
YYYYMMDDhhmm 形式△

detailOrderType

詳細取引決済状態

右記参照○

cvsType

コンビニタイプ

右記参照○

payLimit.from

支払期限（From）

payLimit.to

△

△

9

VeriTrans4G インターフェース詳細 ～検索～em

電子マネー決済
決済個別の詳細ステータスを指定"authorize"：決済請求"refund"：返金請求"refund_new"：新規返金請求"cancel_authorize"：決済請求取消"cancel_refund"：返金請求取消"cancel_refund_new"：新規返金請求取消"capture"：決済完了"part_refund"：一部返金完了"fix_refund"：返金完了"fix_refund_new"：新規返金完了
電子マネーの種別を指定"edy "： Edy 決済"suica "：Suica 決済"waon"：WAON 決済"tcc"：nanaco 決済△

電子マネーの支払い種別を指定"edy-mobile"：モバイル Edy"edy-pc"：Cybey Edy"edy-direct"： Edy ダイレクト"suica-mobile-mail"：モバイル-メール決済"suica-mobile-app"：モバイル-アプリ決済"suica-pc-mail"：インターネット-メール決済"suica-pc-app"：インターネット-アプリ決済"waon-mobile"：モバイルアプリ決済"waon-pc"：Pasori 決済"tcc-redirect"：nanaco 決済△

文字列 12 桁

支払/受取期限の範囲（From）を指定
YYYYMMDDhhmm 形式△

支払/受取期限（To）

文字列 12 桁△

completeDatetime.fromcompleteDatetime.to

支払完了日時（From）

文字列 12 桁

支払完了日時（To）

文字列 12 桁

receiptNo

受付番号

文字列 32 文字以内

支払/受取期限の範囲（To）を指定
YYYYMMDDhhmm 形式
支払完了日時の範囲（From）を指定
YYYYMMDDhhmm 形式
支払完了日時の範囲（To）を指定
YYYYMMDDhhmm 形式
受付番号を指定

detailOrderType

詳細取引決済状態

右記参照○

emType電子マネー種別

右記参照○

optionType

支払い種別

右記参照

○

settlementLimit.from

支払/受取期限（From）

settlementLimit.to

△

△
△
△

10

VeriTrans4G インターフェース詳細 ～検索～

bank

銀行決済
決済個別の詳細ステータスを指定"authorize"：決済請求"bank_select"：金融機関選択"paid_confirm"：入金確認"capture"：収納情報通知
銀行毎の決済方式を指定"atm"：ATM 決済"netbank"：ネットバンク決済
支払期限の範囲（From）を指定
YYYYMMDDhhmm 形式
支払期限の範囲（To）を指定
YYYYMMDDhhmm 形式△

文字列 12 桁

収納日時の範囲（From）を指定
YYYYMMDDhhmm 形式△

収納日時（To）

文字列 12 桁

収納日時の範囲（To）を指定
YYYYMMDDhhmm 形式△

shunoKikanNo
customerNo

収納機関番号
お客様番号

半角英数字 8 桁以内
半角英数字 20 桁以内○○

収納機関番号を指定
お客様番号を指定

confirmNo

確認番号

半角英数字 6 桁以内○

確認番号を指定△△△

detailOrderType

詳細取引決済状態

右記参照○

optionType

支払い種別

右記参照

○

payLimit.from

支払期限（From）

文字列 12 桁

payLimit.to

支払期限（To）

文字列 12 桁

receivedDatetime.from

収納日時（From）

receivedDatetime.to

upop

△

△
△

銀聯ネット決済（UPOP）

detailOrderType

詳細取引決済状態

右記参照

settleDatetimeJp.from

決済日時（From）★日本時間

文字列 12 桁○

決済個別の詳細ステータスを指定"a0" :
与信請求"a":
与信請求成功"ax":
与信請求失敗"av":
与信請求の取消"pa":
売上"pav":
売上の取消"par":
返金(売上の返金，残りの返金可能金額は 1 円以上の場合)"pard":
返金(売上の返金，残りの返金可能金額は 0 円になった場合)"ac0":
与信売上請求"ac":
与信売上請求成功"acx":
与信売上請求失敗"acv":
与信売上請求の取消"acr":
返金(与信売上の返金，残りの返金可能金額は 1 円以上の場合)"acrd":
返金(与信売上の返金，残りの返金可能金額は 0 円になった場合)△

決済日時の範囲（From）を指定
YYYYMMDDhhmm 形式△

11

VeriTrans4G インターフェース詳細 ～検索～
settleDatetimeJp.to

決済日時（To)★日本時間

文字列 12 桁

決済日時の範囲（To）を指定
YYYYMMDDhhmm 形式△

settleDatetimeCn.fromsettleDatetimeCn.to

決済日時（From）★中国時間
決済日時（To)★中国時間

文字列 12 桁

決済日時の範囲（From）を指定
YYYYMMDDhhmm 形式
決済日時の範囲（To）を指定
YYYYMMDDhhmm 形式△

detailOrderType

詳細取引決済状態

右記参照

決済個別の詳細ステータスを指定"set_authorize"：決済請求(Authorize：Set)"get_authorize"：決済請求(Authorize：Get)"do_authorize"：決済請求(Authorize：Do)"set _capture"：決済請求(Capture：Set)"get_capture"：決済請求(Capture：Get)"do_capture"：決済請求(Capture：Do)"cancel_authorize"：取消"do_capture"：売上"reauthorize"：再与信"refund"：返金△

paymentDatetime.frompaymentDatetime.to

支払日時（From）

文字列 12 桁△

支払日時（To)

文字列 12 桁

invoiceId

請求番号○

payerId

顧客番号

半角英数字 127 文字以
内
半角英数字 13 文字以
内

支払日時の範囲（From）を指定
YYYYMMDDhhmm 形式
支払日時の範囲（To）を指定
YYYYMMDDhhmm 形式
請求番号を指定○

顧客番号を指定△

決済個別の詳細ステータスを指定"payment_request"：決済請求"payment"：決済請求成功"refund_request"：返金申込み請求"refund"：返金成功（オンライン決済）
返金成功（バーコード決済：残りの返金可能金額が 1 円以上の場合）"void"：返金成功（バーコード決済：残りの返金可能金額が 0 円の場合）△

paypalalipay文字列 12 桁△

PayPal 決済○△△

Alipay 決済

detailOrderType

詳細取引決済状態

右記参照○

centerTradeId

決済センターとの取引
ID

文字列 64 文字以内

決済センターとの取引 ID を指定△

paymentTime.from

支払日時（From）

半角数字 12 桁以内

支払日時の範囲（From）を指定
YYYYMMDDhhmm 形式△

12

VeriTrans4G インターフェース詳細 ～検索～
paymentTime.to

支払日時（To）

半角数字 12 桁以内

支払日時の範囲（To）を指定
YYYYMMDDhhmm 形式△

settlementTime.from

清算日時(From)

半角数字 12 桁以内△

settlementTime.to

清算日時(To)

半角数字 12 桁以内

payType

決済種別

半角数字

清算日時の範囲（From）を指定
YYYYMMDDhhmm 形式
清算日時の範囲（To）を指定
YYYYMMDDhhmm 形式
決済種別を指定"0"：オンライン決済"1"：バーコード決済（店舗スキャン型）"2"：バーコード決済（消費者スキャン型）

detailOrderType

詳細オーダー決済状態

右記参照

○

△

crServiceType

キャリアサービスタイプ

右記参照

○

決済個別の詳細ステータスを指定"Init"：決済申込"Auth"：与信"Deregistration"：抹消"Terminate"：継続終了"PostAuth"：売上"VoidPostAuth"：取消(売上)"VoidAuth"：取消(与信)"AuthCapture"：与信売上"VoidAuthCapture"：取消(与信売上)※「detailOrderType」の詳細については、『キャリア決済サービス 補足資料』を参照
決済申込時に指定したキャリア決済のタイプ（serviceOptionType）

accountingType
itemType

都度/継続区分
商品タイプ

半角数字 1 桁
半角数字 1 桁○

決済申込時に指定した都度/継続区分
決済申込時に指定した商品タイプ

mpStatus

継続状態フラグ(月額課金状態フラグ)

半角数字 1 桁○

terminalKind

端末種別

半角数字 1 桁○

carrier△△

キャリア決済以下のいずれかを指定"1"：継続中"8"：抹消"9"：終了
決済申込時に指定した端末種別

△
△
△
△

△

13

VeriTrans4G インターフェース詳細 ～検索～
detailCommandType

詳細コマンドタイプ

右記参照

mpFirstDate
mpDay

初回課金年月日
継続課金日

文字列 8 桁文字列 2 桁以内

itemId

商品番号

半角英数字 18 桁以内○○

キャリア決済の詳細コマンドを指定"PreOpenId"：OpenID 事前認証
"PostOpenId"：OpenID 認証"PreAuth"：決済認可"Auth"：与信"MAuth"：与信(継続)"Deregistration"：抹消"UserTerminatePreOpenId"：OpenID 事前認証(継続終了)"UserTerminatePostOpenId"：OpenID 認証(継続終了)"UserTerminatePreAuth"：決済認可(継続終了)"UserTerminate"：継続終了"TerminateReq"：継続終了要求(強制)"Terminate"：継続終了(強制)"PostAuthReq"：売上要求"PostAuth"：売上"VoidPostAuthReq"：取消要求(売上)"VoidPostAuth"：取消(売上)"VoidAuthReq"：取消要求(与信)"VoidAuth"：取消(与信)"AuthCapture"：与信売上"EmuAuth"：与信(与信売上エミュレート)"EmuPostAuthReq"：売上要求(与信売上エミュレート)"EmuPostAuth"：売上(与信売上エミュレート)"VoidAuthCaptureReq"：取消要求(与信売上)"VoidAuthCapture"：取消(与信売上)※「detailCommandType」の詳細については、『キャリア決済サービス 補足資料』を参照△

決済申込時に指定した初回課金年月
決済申込時に指定した継続課金日△△△

決済申込時に指定した商品番号14

VeriTrans4G インターフェース詳細 ～検索～oricosc

ショッピングクレジット決済

detailOrderType

詳細オーダー決済状態

右記参照

oricoOrderNo

注文番号

文字列 20 桁以内

amount. from

支払金額合計（from）
支払金額合計（to）商品価格合計(税込)（from）
商品価格合計(税込)（to）

文字列 8 桁以内

amount.tototalItemAmount.fromtotalItemAmount.to

○

○

△

決済個別の詳細ステータスを指定"authorize"：画面表示"verify"：決済結果取得"capture"：審査結果通知"cancel"：途中キャンセル
画面表示要求時に指定した注文番号△△

支払金額合計（from）を指定
0 以上で指定します。
支払金額合計（to）を指定
99999999 以下で指定します。
商品価格合計(税込)（from）を指定
0 以上で指定します。
商品価格合計(税込)（to）を指定
99999999 以下で指定します。

文字列 8 桁以内
文字列 8 桁以内
文字列 8 桁以内△△△

2.2.2 応答電文 ： SearchResponseDto
応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

説明

resultserviceType

処理結果
サービスタイプ－
右記参照

mstatus

処理結果コード

半角英数字 32 文字以内

vResultCode

詳細結果コード

半角英数字 16 文字

merrMsg

エラーメッセージ

文字列 1024 バイト以内

overMaxCountFlag

最大件数超えフラグ

右記参照

searchCount

検索結果件数0～1000orderInfosorderInfo

オーダー情報リスト
オーダー情報－複数のオーダー情報（orderInfo）が格納されます。
検索条件に該当した取引の情報が該当件数分繰り返されます。0～1000 件（要求電文で指定した検索最大件数まで）です。

インデックス

0～999

検索された情報のインデックス

index"search""success"：正常終了"failure"：異常終了
処理の結果を詳細に表すコード
詳細は別途『結果コード一覧』を参照下さい。
処理結果を日本語で表示します。
検索対象データが要求電文で指定した検索最大件数より多いかどうかを表示"true"： 最大件数以上 "false"： 最大件数未満
検索結果件数（オーダー件数）が格納されます。

設定

○
○
○
○
△
△
△
△
△

△

15

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

説明

設定

serviceTypeCd

決済サービスタイプ

右記参照"card"： カード決済"cvs"： コンビニ決済"em"： 電子マネー決済"bank"：銀行決済"upop"： 銀聯ネット決済（UPOP）"paypal"： PayPal 決済"alipay"：Alipay 決済"carrier"： キャリア決済"oricosc"： ショッピングクレジット決済△

orderId
orderStatus

取引 ID
取引決済状態

文字列
右記参照

取引の取引 ID" initial "：初期状態" end "：終了
" end_presentation "：画面遷移正常終了" pending "：保留" validation_error "：検証エラー" expired "：期限切れ" error "：エラー△△

lastSuccessTxnType※このフィールドは、取引 ID に関連する注文データの状態を完全に表現するものではありません。サービスタイプによっては詳細な状態遷移を別のフィールドに保持している場合がありますので、店舗側システムの用途に合わせて successDetailTxnType や、決済固有の状態フィールドを参照してください。
直近の成功したコマンド名△

最終成功トランザクショ
ンタイプ
詳細トランザクションタ
イプ

文字列
文字列

取引の詳細な状態
検索要求電文の各決済の detailOrderType 参照。

△

accountId
memo1

会員 ID
取引メモ 1

半角英数字 100 桁以内
文字列 100 文字以内△△

freeKey

キー情報

半角英数字 256 桁以内

properOrderInfo

固有オーダー情報－

検索条件に該当した取引の会員 ID
検索条件に該当した取引の取引に関するメモ情報※最新のトランザクションで指定された値が返戻されます。
検索条件に該当した取引の取引に関するキー情報※最新のトランザクションで指定された値が返戻されます。
各決済サービスの固有オーダー情報
後述の一覧参照。

transactionInfos

決済トランザクションリ
スト－

複数の決済トランザクション情報（transactionInfo）△

successDetailTxnType

△
△

16

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

transactionInfo－

検索条件に該当した取引の情報が該当件数分繰り返されます。

△

txnId

決済トランザクション情報
トランザクション管理 ID

文字列

決済サーバーが採番する管理 ID

command

コマンド

文字列

実行されたコマンド名※MDK で要求したコマンドだけではなく、決済サーバーの内部処理コマンドも含まれます。

△△

mstatus

処理結果コード

半角英数字 32 文字以内

"success"：正常終了"failure"：異常終了"pending"：保留△vResultCode

詳細結果コード

文字列 16 桁

処理の結果を詳細に表すコード
詳細は別途『結果コード一覧』を参照下さい。

△

txnDatetime
amount

取引日時
金額

文字列 23 桁
半角数字 12 桁以内

YYYY-MM-DD hh:mm:ss.mmm 形式
決済した金額properTransactionInfo

固有トランザクション情－
各決済サービスの固有トランザクション情報報
後述の一覧参照。
☆ 以下の情報は、上記 「固有オーダー情報」 「固有トランザクション情報」 内の階層にセットされます。

△△△

properOrderInfo
startTxn
requestCurrencyUnit
cardExpire
properTransactionInfo
txnKindcardTransactionType

書式・制限

説明

設定

クレジットカード決済 固有オーダー情報
電文 ID
要求通貨単位文字列
半角英数字 4 桁以内

カード有効期限
文字列 5 桁以内
クレジットカード決済 固有トランザクション情報

有効期限（全桁平文）

△
△
△
△
△

文字列
文字列 6 桁以内

gatewayRequestDate

トランザクション種類
カードトランザクションタ
イプ
ゲートウェイ要求日時

gatewayResponseDate

ゲートウェイ応答日時

文字列 14 桁以内

決済サーバーが応答電文を返した日時
YYYYMMDDhhmmss 形式△

centerRequestDate
centerResponseDate

センター要求日時
センター応答日時

文字列 14 桁以内
文字列 14 桁以内

カード決済センターが要求電文を受け取った日時。YYYYMMDDhhmmss 形式
カード決済センターが応答電文を返した日時。YYYYMMDDhhmmss 形式

centerRequestNumber
centerReferenceNumber

文字列 7 桁以内
文字列 7 桁以内

reqItemCode

センター要求番号
センターリファレンス番号
要求商品コード△△△△

文字列 7 桁以内

※現在はご利用いただくことはできません。

resItemCode
reqReturnReferenceNumber

応答商品コード
要求リターン参照番号

文字列 7 桁以内
文字列 12 桁以内※現在はご利用いただくことはできません。
※現在はご利用いただくことはできません。

△△△

文字列 14 桁以内

取引の詳細な状態
検索要求電文の各決済の detailOrderType 参照。
決済サーバーが要求電文を受け取った日時
YYYYMMDDhhmmss 形式△

17

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

説明

設定

△
△
△
△

responsedata

応答データ

文字列 20 桁以内

pendingloopback

ペンディング
ループバック

文字列 1 桁以内
文字列 1 桁以内

connectedCenterId

接続先カード接続セン
ター

文字列 5 桁以内

reqCardNumber

要求カード番号

文字列 16 桁以内

上 6 桁下 2 桁のみ数字表示され、その他は "*"（アスタリスク）１つに変換されます。
（例 "411111*11"）△

reqCardExpire

要求カード有効期限

文字列 5 桁以内

全桁"*"（アスタリスク）に変換されます。
"*****"△

reqAmount
reqCardOptionType

要求取引金額要求カードオプションタ
イプ
要求マーチャントトラン
ザクション番号

文字列 12 桁以内
文字列 5 桁以内
文字列 9 桁以内

※現在はご利用いただくことはできません。

△

reqAuthCode
reqAcquirerCode

要求承認番号
要求仕向け先コード

文字列 7 桁以内
文字列 2 桁以内

※現在はご利用いただくことはできません。

reqCardCenter
reqJpoInformation

要求カードセンター
要求支払種別情報

文字列 7 桁以内
半角英数字 83 桁以内※現在はご利用いただくことはできません。

reqSalesDay
reqCancelDay

要求売上日
要求取消日

文字列 8 桁以内
文字列 8 桁以内

※現在はご利用いただくことはできません。
※現在はご利用いただくことはできません。

reqWithCapture
reqWithDirect

要求同時売上
要求同時直接文字列 5 桁以内
文字列 5 桁以内

※現在はご利用いただくことはできません。

req3dMessageVersion

要求 3D メッセージバージョン

文字列 10 桁以内

△
△
△
△
△
△
△
△
△

req3dTransactionId

要求 3D トランザクショ
ン ID

文字列 28 桁以内△

req3dTransactionStatus

要求 3D トランザクショ
ンステータス
要求 3D CAVV アルゴリ
ズム
要求 3D CAVV

文字列 1 桁以内△

文字列 1 桁以内△

文字列 28 桁以内

要求 3D ECI
要求 3D DS トランザク
ション ID

文字列 2 桁以内
文字列 36 桁以内△△△

reqMerchantTransaction

req3dCavvAlgorithm
req3dCavv
req3dEci
req3dDsTransactionId"0"：なし"0"：なし"1"：あり"1"：あり△△18

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名
req3dServerTransactionId

検索項目名

書式・制限

説明

文字列 36 桁以内

reqSecurityCode
reqAuthFlag

要求認証番号

文字列 7 桁以内

全桁"0"（ゼロ）に変換されます。
（例 "0000"）※現在はご利用いただくことはできません。

reqBirthday
reqTel

要求誕生日
要求電話番号

文字列 4 桁以内
文字列 4 桁以内

※現在はご利用いただくことはできません。
※現在はご利用いただくことはできません。

reqFirstKanaName
reqLastKanaName

要求カナ名前（名）要求カナ名前（姓）文字列 15 桁以内
文字列 15 桁以内※現在はご利用いただくことはできません。
※現在はご利用いただくことはできません。

resMerchantTransaction

文字列 9 桁以内

resReturnReferenceNumber

応答マーチャントトラン
ザクション番号
応答リターン参照番号

resAuthCode

応答承認番号

resActionCode

アクションコード

半角英数字スペース 7 桁以内
文字列 3 桁以内

resCenterErrorCode

応答センターエラーコ
ード

文字列 3 桁以内

resAuthTerm
reqWithNew

応答与信期間
要求新規返品

文字列 3 桁以内
右記参照

properOrderInfo

文字列 4 桁以内

文字列 12 桁以内

設定△

要求 3D サーバトランザ
クション ID
要求セキュリティコード

△
△
△
△
△
△
△

カード会社との通信時にシステム内部で利用する番号
通常、店舗様が意識する必要はありません。
カード会社が発行する承認番号△

カード会社との通信時に返戻されたコード値
通常、店舗様が意識する必要はありません。

△

カード会社における結果コード(例 "G12")△"true"： 新規返品
"false"： 取消・返品※現在はご利用いただくことはできません。

△△△

コンビニ決済 固有オーダー情報

cvsType

決済サービスオプション

右記参照

amount

決済金額

半角数字 6 桁以内

name1

氏名１

全角 20 バイト以内

name2

氏名２

全角 20 バイト以内決済されたコンビニの種別。
"sej"：セブン－イレブン"econ"：イーコン（ローソン、ファミリーマート、ミニストップ、セイコーマート）"other"：その他（デイリーヤマザキ）"famima"：ファミリーマート"lawson"：ローソン(ローソン、ミニストップ、セイコーマート)
支払金額
顧客姓※全角ハイフン、全角スペース、外字は、文字化けする可能性があります
顧客名※全角ハイフン、全角スペース、外字は、文字化けする可能性があります

△

△
△
△

19

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

telNo

電話番号

free1

備考１

free2
payLimit

備考２
支払期限

receiptNo

受付番号

paidDatetime
properTransactionInfo

書式・制限

説明

半角数字 13 桁以内
右記参照
文字列 50 バイト以内

顧客電話番号、数字のみ 11 桁以内、ハイフン含み 13 桁以内例） 0311112222、03-1111-2222、09011112222、090-1111-2222
備考欄（商品詳細などに利用する）

文字列 50 バイト以内
半角数字 10 桁
右記参照
半角英数字 32 文字以内

備考欄（商品詳細などに利用する）
支払期限（YYYY/MM/DD の形式）
コンビニへ正常に決済請求が完了した際に配布される受付番号

入金受付日
文字列 14 桁以内
コンビニ決済 固有トランザクション情報

入金を受け付けた日（YYYYMMDDhhmmss 形式）

cvsTxnType

取引対象タイプ

文字列

取引の詳細な状態
検索要求電文の各決済の detailOrderType 参照。

startDatetime

取引日時

文字列

properOrderInfo
settlementMethod

設定

△
△
△
△
△
△
△
△

電子マネー決済 固有オーダー情報
決済方式
文字列

△
△
△

settlementType
amount

決済タイプ
決済金額

文字列
半角数字 5 桁以内

settlementLimit

決済期限

半角数字 14 桁

mailAddr

メールアドレス

半角英数字 256 桁以内

決済依頼メールの携帯電話メールアドレス
CyberEdy ：未使用

forwardMailFlag

転送メール送信要否

半角数字 1 桁
右記参照△

merchantMailAddr

マーチャントメールアド
レス

半角英数字 256 桁以内

決済依頼メール、決済完了メールのコピーメール又は BCC メールをマーチャントメールアド
レス（merchantMailAddr）に送信するか否かの設定"0"： 送信不要"1"： 送信要決済依頼メール、決済完了メールのコピーメール又は BCC メール先マーチャントメールアド
レス

cancelMailAddr

取消返金通知メールア
ドレス

半角英数字 256 文字以内

決済の取消完了を利用者に通知するためのメールアドレス△

requestMailAddInfo
completeMailAddInfo

依頼メール付加情報
完了メール付加情報

半角英数字 256 桁以内
文字列 300 バイト以内

返金通知メールに追加される文字列（返金情報等）
決済完了メールに追加される文字列

shopNamecompleteMailFlag

ショップ名
完了メール送信要否

文字列 48 バイト以内
半角数字 1 桁
右記参照

Edy で使用する店舗名
決済完了時にメールを送信するか否かの設定"0"： 送信不要"1"： 送信要△△△△

Edy、WAON、nanaco：￥50,000 以下
Suica：￥20,000 以下
支払期限 （YYYYMMDDhhmmss）

△
△

△

20

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

説明

設定

文字列 256 バイト以内

内容確認画面に表示する付加情報△

completeScreenAddInfo

内容確認画面付加情報
完了画面付加情報

文字列 256 バイト以内

決済完了画面に表示する付加情報

screenTitle
completeReturnKind

画面タイトル
決済完了戻り先種別

文字列 40 バイト以内
半角数字 1 桁
右記参照

△
△
△

completeReturnUrl

決済完了戻り先 URL

半角英数字 256 桁以内

モバイル Suica で決済完了画面・決済確認画面等で「商品・サービス名」に表示される情報
モバイル Suica でアプリ終了時に遷移する先の種別"1"： ローカルメニュー"2"： モバイル Suica アプリを終了し「決済完了戻り先 URL」へ遷移
モバイル Suica でアプリ終了時に遷移する先の URL

completeNoticeUrlsalesType

決済完了通知 URL
販売区分

半角英数字 256 桁以内
半角数字 1 桁
右記参照

Edy Viewer にて支払いを完了した後に遷移する URL
Edy で任意に登録する販売区分"1"：物販"2"：デジタル

freerefundOrderCtlId

備考
返金取引 ID

文字列 256 バイト以内
文字列

備考(商品詳細など)

receiptNo
appUrl

受付番号
決済アプリ起動 URL

半角英数字 64 文字以内
半角英数字 384 文字以内

決済センターへ正常に決済請求が完了した際に決済センターで採番される受付番号
Edy Viewer の起動 URL、又はモバイル Suica アプリ URL

orderKind

オーダー種別右記参照"authorize"： 決済"refund"： 返金"present"： プレゼント請求

completeDatetime

完了日時

文字列 14 桁

支払が完了した日時（YYYYMMDDhhmmss 形式）

reAuthorizeRedirectionUrl

半角英数字記号 256 桁以
内
半角数字 2 桁

復旧処理後のリダイレクト先 URL

transactionKind

復旧リダイレクション
URL
取引種別

"01"：残高照会（予約語。現在はご利用いただけません。）"02"：電子マネー決済△

userIdユーザ ID

半角英数字記号 64 桁以内

取引対象利用者を一意に特定可能な ID
半角英数字の他に以下の記号も使用可能です（RFC2822 の local-part に準拠します）。
"!"、"#"、"$"、"%"、"&"、"'"、"*"、"+"、"-"、"/"、"="、"?"、"^"、"_"、"`"、"{"、"|"、"}"、"~".

△

settlementId
reAuthAppUrl

決済処理 ID
復旧用アプリ起動 URL

文字列 256 桁以内
半角英数字 380 文字以内

※現在はご利用いただくことはできません。
復旧処理が成功した場合の復旧処理用 URL△△

取引の詳細な状態
検索要求電文の各決済の detailOrderType 参照。

△

confirmScreenAddInfo

properTransactionInfo

△
△
△

△
△
△
△
△

△
△

電子マネー決済 固有トランザクション情報

emTxnType

取引対象タイプ

文字列centerProcDatetime
startDatetime

取引日時
取引日時

文字列
文字列

△
△
21

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

説明

設定

cardType

カード種別

半角数字 2 桁

電子マネーのカード種別"00"：かざして決済"10"：かざして決済以外△

cardNocardBrandCode

取引カード番号
取引カードブランドコー
ド

半角数字 4 桁
半角数字 4 桁

消費者が取引に使用した電子マネーカードのカード ID 下 4 桁△△

settlementStatus

決済ステータス

半角数字 10 桁"success"：決済完了"failure"：決済失敗"pending"：復旧処理が必要

properOrderInfo

決済方式
金額

文字列
半角数字 10 桁以内

name1
name2

顧客名１
顧客名２

全角 20 バイト以内
全角 20 バイト以内

telNo
payLimit

電話番号
支払期限

半角数字 11 桁以内
文字列 8 桁

決済した金額YYYYMMDD 形式

収納日時
文字列 12 桁
銀行決済 固有トランザクション情報

YYYYMMDDhhmm 形式

peTxnType

対象取引タイプ

文字列receiptNo

受付番号

半角数字、"-" 27 桁

取引の詳細な状態
検索要求電文の各決済の detailOrderType 参照。
決済センターへ正常に決済請求が完了した際に決済センターで採番される受付番号
お客様番号（半角数字 20 桁）-確認番号（半角数字 6 桁）

startDatetime

取引日時

文字列

properOrderInfo
properTransactionInfo△

銀行決済 固有オーダー情報

settlementMethod
amountreceivedDatetime
properTransactionInfo

ブランドを識別するコード"0001"：nanaco

△
△
△
△
△
△
△
△
△
△

銀聯ネット決済（UPOP） 固有オーダー情報
銀聯ネット決済（UPOP） 固有トランザクション情報

upopTxnType

取引タイプ

文字列

下記の値が返戻されます：
01： 与信同時売上
02： 与信のみ
03： 与信→売上
31： 与信同時売上→取消
32： 与信のみ→取消
33： 与信→売上→取消
04： 売上→返金△

amountstartDatetime

取引金額
取引日時

半角数字 12 桁以内
半角数字 14 桁

支払い総額
YYYYMMDDhhmmss 形式△△
22

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

説明

resUpopSettleAmount

清算金額

半角数字 12 桁以内

清算金額

resUpopSettleDate
resUpopSettleCurrency

清算日付
清算通貨種類

半角数字 4 桁
半角数字 3 桁以内

MMDD 形式

resUpopExchangeDate
resUpopExchangeRate

両替日付
清算為替レート

半角数字 4 桁
半角数字 8 桁

MMDD 形式

resUpopOrderId

決済センターとの取引
ID

半角英数字 20 桁以内

決済センターとの取引 ID※拡張項目のため、ご利用の際には弊社までお問い合わせください。

properOrderInfo
settlementMethod
invoiceId
payerId
paymentDatetime
properTransactionInfo

PayPal 決済 固有オーダー情報
決済方式
文字列
請求番号
顧客番号

半角英数字 127 文字以内
半角英数字 13 文字以内

決済サーバーが発番するオーダー単位でユニークとなる ID

設定

△
△
△
△
△
△

△
△
△
△

支払日時
文字列 14 桁
PayPal 決済 固有トランザクション情報

YYYYMMDDhhmmss 形式

ppTxnType

対象取引タイプ

文字列

取引の詳細な状態
検索要求電文の各決済の detailOrderType 参照。

△

centerTxnId
amount

取引識別子
金額

半角英数字 19 文字以内
半角数字

PayPal が発番するユニークな ID

feeAmountexchangeRate

手数料
外貨換算レート

半角数字
半角英数字 17 文字以内

netRefundAmounttxnFixed

純返金金額
決済完了フラグ

半角数字
右記参照

△
△
△
△
△
△

startDatetime

取引日時

文字列

properOrderInfo
properTransactionInfo
centerTradeId

決済完了取引かどうかを示すフラグ"0"：決済レコード（速報レコード）"1"：決済完了レコード（確報レコード）△

Alipay 決済 固有オーダー情報
Alipay 決済 固有トランザクション情報
決済センターとの取引
ID

文字列 64 文字以内

決済センターとの取引 ID△

23

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
説明

設定

alipayTxnType

検索フィールド名

対象取引タイプ

検索項目名
文字列

書式・制限

下記の値が返戻されます："payment_request"：決済請求"payment"：決済請求"refund_request"：返金申込み請求"refund"：返金（オンライン決済）
返金（バーコード決済：残りの返金可能金額が 1 円以上の場合）"void"：返金（バーコード決済：残りの返金可能金額が 0 円の場合）"payment_request_fail"：決済請求失敗（バーコード決済（消費者スキャン型）：QR コード生
成処理に失敗した場合）"payment_fail"：決済請求失敗"payment_pending"：決済請求保留"refund_fail"：返金失敗"refund_pending"：返金保留△

settleAmountsettleCurrency

清算金額
清算通貨

半角数字 7 桁
半角数字 3 桁以内

清算金額
清算通貨

△
△

paymentTime
settlementTime

支払日付
清算日付

半角数字 14 桁以内
半角数字 14 桁以内

YYYYMMDDhhmmss 形式
YYYYMMDDhhmmss 形式△△

payType

決済種別

半角数字

決済種別

△

"0"：オンライン決済"1"：バーコード決済（店舗スキャン型）"2"：バーコード決済（消費者スキャン型）
properOrderInfo

キャリア決済 固有オーダー情報

△
△
△
△
△
△
△
△
△

crServiceType
withCapture

キャリアサービスタイプ
与信同時売上フラグ

文字列
文字列

決済申込時に指定したキャリア決済のタイプ(serviceOptionType)
決済申込時に指定した与信同時売上フラグ

accountingType
itemInfo

課金タイプ
商品情報

文字列 1 桁文字列

決済申込時に指定した課金タイプ
決済申込時に指定した商品情報

itemIditemType

商品 ID
商品タイプ

文字列
文字列 1 桁決済申込時に指定した商品 ID
決済申込時に指定した商品タイプ

terminalKind
authorizeDatetime

端末種別
決済申込日時文字列 1 桁文字列 14 桁

決済申込時に指定した端末種別
決済申込日時（YYYYMMDDhhmmss 形式）

captureDatetime

売上日時

文字列 14 桁

キャリア側で売上処理した日時
YYYYMMDDhhmmss 形式

cancelDatetime

取消日時

文字列 14 桁

キャリア側で取消処理した日時
YYYYMMDDhhmmss 形式△

crOrderId

キャリアオーダーID

文字列 16 桁以内

キャリア側で発番された取引毎の ID△
24

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名
d3Flag

検索項目名

書式・制限

本人認証（3D セキュア）
初回課金日付文字列 1 桁文字列 2 桁以内
文字列 1 桁

mpOrderId

継続課金日
継続状態フラグ(月額課金状態フラグ)
継続課金オーダーID

mpTxnStatusType

継続課金状態タイプ

文字列

mpFirstDate
mpDay
mpStatus

文字列 8 桁文字列 6 桁説明
決済申込時に指定した値"0"：無し、"1"：バイパス、 "2"：有り
決済申込時に指定した初回課金日付
決済申込時に指定した継続課金日
継続状態フラグ (月額課金状態フラグ)"1"：継続中、"8"：抹消、"9"：終了
継続課金オーダーID（課金年月を YYYYMM 形式で格納）
直近の継続課金処理によって、課金データがどのような状態に遷移したかを示します。
"Init"：初期状態"VoidReq"：取消要求"Void"：取消"CaptureReq"：売上要求"Capture"：売上"CaptureFail"：売上失敗"VoidCaptureReq"：売上取消要求"VoidCapture"：売上取消"VoidWait"：取消待ち

設定

△
△
△
△
△
△

※Search コマンドでは、継続課金のすべての売上データを取得することはできません。
※「mpTxnStatusType」の詳細については、『キャリア決済サービス 補足資料』を参照してく
ださい。

△
△
△

mpCaptureDatetime
mpCancelDatetime

継続売上日時
継続取消日時文字列 14 桁
文字列 14 桁

継続売上日時（YYYYMMDDhhmmss 形式）
継続取消日時（YYYYMMDDhhmmss 形式）

mpTerminateDatetime

継続終了日時文字列 14 桁

継続終了日時（YYYYMMDDhhmmss 形式）※「抹消」の場合は、キャリア側で抹消された日時、または決済サーバー側で抹消を検知した日時

fletsArea

フレッツエリア

文字列 1 桁決済申込時に指定した値"0"：東日本、 "1"：西日本△

キャリアから返却された結果コード△

検索要求電文のキャリア決済の detailCommandType 参照。
※「detailCommandType」の詳細については、『キャリア決済サービス 補足資料』を参照して
ください。

△

properTransactionInfo
crResultCode
detailCommandType

キャリア決済 固有トランザクション情報
キャリア結果コード
文字列
詳細コマンドタイプ

文字列25

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

説明

設定

crRequestDatetime

キャリアへの要求日時

文字列 14 文字

キャリアへの要求日時（YYYYMMDDhhmmss 形式）

crResponseDatetime

キャリアからの返戻日時

文字列 14 文字

キャリアからの返戻日時（YYYYMMDDhhmmss 形式）△△

マーチャントリダイレクション URL△

ショッピングクレジット用の注文番号△

半角英数記号 20 桁以内
全角、半角英数記号
256 桁以内
半角数字 3 桁以内

店舗の会員番号
画面表示要求時に指定した商品名 1△△

画面表示要求時に指定した数量 1

半角数字記号 8 桁以内
全角、半角英数記号
256 桁以内
半角数字 3 桁以内

画面表示要求時に指定した商品価格 1（税込）
画面表示要求時に指定した商品名 2△△△

properOrderInfo
merchantRedirectionUrloricoOrderNo

ショッピングクレジット決済 固有オーダー情報
マーチャントリダイレク
URL に使用可能な半角英ション URL
数字 256 桁以内
注文番号
半角英数字
20 桁以内userNoitemName1

会員番号(加盟店)
商品名 1

itemCount1

数量 1

itemAmount1
itemName2

商品価格 1(税込)
商品名 2

itemCount2

数量 2

itemAmount2
itemName3

商品価格 2(税込)
商品名 3

半角数字記号 8 桁以内
全角、半角英数記号
256 桁以内

画面表示要求時に指定した商品価格 2（税込）
画面表示要求時に指定した商品名 3

itemCount3
itemAmount3

数量 3
商品価格 3(税込)

半角数字 3 桁以内
半角数字記号 8 桁以内

画面表示要求時に指定した数量 3
画面表示要求時に指定した商品価格 3（税込）

itemName4

商品名 4

全角、半角英数記号
256 桁以内

画面表示要求時に指定した商品名 4

itemCount4
itemAmount4

数量 4
商品価格 4(税込)

半角数字 3 桁以内
半角数字記号 8 桁以内

画面表示要求時に指定した数量 4
画面表示要求時に指定した商品価格 4（税込）

itemName5

商品名 5

全角、半角英数記号
256 桁以内

画面表示要求時に指定した商品名 5

itemCount5
itemAmount5

数量 5
商品価格 5(税込)

半角数字 3 桁以内
半角数字記号 8 桁以内

画面表示要求時に指定した数量 5
画面表示要求時に指定した商品価格 5（税込）

totalItemAmount
totalCarriage

商品価格合計(税込)
送料合計(税込)

半角数字 8 桁以内
半角数字 8 桁以内

画面表示要求時に指定した商品価格合計(税込)
画面表示要求時に指定した送料合計(税込)

amountdeposit

支払金額合計頭金

半角数字 8 桁以内
半角数字 8 桁以内

画面表示要求時に指定した支払金額合計
画面表示要求時に指定した頭金

shippingZipCode
handlingContractNo

配送先郵便番号
取扱契約番号

半角数字記号 8 桁
半角英数字 3 桁以内

画面表示要求時に指定した配送先郵便番号（ハイフンを含む 999-9999 形式）
画面表示要求時に指定した取扱契約番号

画面表示要求時に指定した数量 2

△
△
△
△
△
△
△
△
△
△
△
△
△
△
△
△
△
26

VeriTrans4G インターフェース詳細 ～検索～

応答電文 ： SearchResponseDto
検索フィールド名

検索項目名

書式・制限

contractDocumentKbn

契約書有無区分

半角数字 1 桁

webDescriptionId

WEB 申込商品 ID

半角英数字 4 桁以内

properTransactionInfo
oricoTxnType

ショッピングクレジット決済 固有トランザクション情報
オリコトランザクションタ 右記参照
イプ

説明

設定

"0"：契約書無し"1"：契約書有り
画面表示要求時に指定した WEB 申込商品 ID△"Authorize"：画面表示、"Verify"：決済結果取得、"Capture"：審査結果通知、"Cancel"：途中キャンセル△△

orderStateCode

審査結果コード

半角数字 2 桁"02"：否決"04"：承認△

approvalNo

承認番号

半角数字 16 桁以内△

requestDate

申込日

半角数字 8 桁

承認番号
審査結果が「"04"：承認」の場合に返戻されます。
申込日（YYYYMMDD 形式）

loanPrincipal
paymentCount

ローン元金
支払回数

半角数字 8 桁以内
半角英数字 3 桁以内

ローン元金"1"～"999":普通分割支払回数"B01":ボーナス一括"B02":ボーナスニ括

△
△
△

27

VeriTrans4G インターフェース詳細 ～検索～

2-3 検索 マスタ情報取得
2.3.1 要求電文 ： SearchRequestDto
要求電文 ： SearchRequestDto
フィールド名masterNames

項目名

書式・制限

マスタ名

右記参照

複数
指定
○

ﾜｲﾙﾄﾞ
ｶｰﾄﾞ

説明

設定

○

以下の値より複数指定可（随時追加予定）"bankFinancialInstInfo" ： 金融機関マスタ

2.3.2 応答電文 ： SearchResponseDto
応答電文 ： SearchResponseDto
フィールド名
result

項目名
処理結果

mstatus

処理結果コードvResultCode

詳細結果コード

書式・制限

説明

設定

以下、処理結果が格納されます。
半角英数字 32 文字以内

"success"：正常終了"failure"：異常終了○

半角英数字 16 文字処理の結果を詳細に表すコード
詳細は別途『結果コード一覧』を参照下さい。
処理結果を日本語で表示します。

○△

merrMsg

エラーメッセージ

文字列 1024 バイト以内

masterInfos
masterInfo

マスタ情報リスト
マスタ情報

複数のマスタ情報が格納されます。
検索条件に該当した情報が該当件数分繰り返されます。

キー
値

文字列
マスタ名
マスタに含まれるレコード情報です。

○

金融機関マスタ情報
金融機関コード

文字列

deviceCodebankName

デバイスコード
金融機関名称

文字列
文字列

bankKanabankIndexChar1

金融機関カナ
カナ頭文字

文字列
文字列

bankIndexChar2
startDatetime

カナ行頭文字
登録日時

文字列
文字列

△
△
△
△
△
△
△

name
masters
xxxxxxxxx Info

マスタ固有情報☆ 以下の情報は、上記「マスタ固有情報」内にセットされます。
bankFinancialInstInfo
bankCodeYYYYMMDDhhmmss 形式

28

VeriTrans4G インターフェース詳細 ～検索～

2-4 ダミーマーチャントでの検索
ダミーマーチャント（テスト専用アカウント）で検索を実施した場合は、本番マーチャント ID と以下の点が異なっています。
・検索結果件数は最大 100 件までになります。
・決済サービスタイプ（serviceTypeCd）に空の値が存在した場合は、結果コード：NC04 を返戻します。
・決済サービスタイプ（serviceTypeCd）、リクエスト ID、取引 ID（アスタリスクを含まない、完全一致の指定）を一つも指定していない場合、結果コード：NC04 を返戻します。
・リクエスト ID を指定していない場合、結果コードが NHｘｘのトランザクションレコードを抽出対象(検索対象、結果抽出対象)から除外します。

29