VeriTrans4G インターフェース詳細 ～コンビニ決済～

VeriTrans4G インターフェース詳細～コンビニ決済～
Ver. 1.0.9 （2023 年 6 月～）

Copyright © 2023 DG Financial Technology, Inc., a Digital Garage company. All rights reserved.
1VeriTrans4G インターフェース詳細 ～コンビニ決済～

目次
第1章

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

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

第2章

インターフェース詳細 ............................................................................................................................................................................................................ 62-1 共通 ......................................................................................................................................................................................................................................................................62-2 申込 ......................................................................................................................................................................................................................................................................7
2.2.1 要求電文 ： CvsAuthorizeRequestDto ................................................................................................................................................................................................................................... 7
2.2.2 応答電文 ： CvsAuthorizeResponseDto ................................................................................................................................................................................................................................. 92-3 キャンセル ........................................................................................................................................................................................................................................................... 10
2.3.1 要求電文 ： CvsCancelRequestDto .......................................................................................................................................................................................................................................10
2.3.2 応答電文 ： CvsCancelResponseDto .....................................................................................................................................................................................................................................102-4 結果通知............................................................................................................................................................................................................................................................. 11第3章

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

3-1 使用可能文字一覧 .............................................................................................................................................................................................................................................. 13
3-2 利用可能なコンビニタイプの確認方法 .................................................................................................................................................................................................................. 14
3.2.1 ファミリーマートとの接続形態が「直接接続」の加盟店様の場合....................................................................................................................................................................................................143.2.2 ファミリーマートとの接続形態が「イーコンテクスト経由接続」の加盟店様の場合 ............................................................................................................................................................................152

VeriTrans4G インターフェース詳細 ～コンビニ決済～

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

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

[お問い合わせ先]株式会社 DG フィナンシャルテクノロジー ベリトランス テクニカルサポート

電子メール： tech-support@veritrans.jp

3

VeriTrans4G インターフェース詳細 ～コンビニ決済～

1-3 改訂履歴
2017/04 ：Ver1.0.0 リリース
2017/10 ：Ver1.0.1 リリース
要求電文にプッシュ URL 項目を追加
2018/01 ：Ver1.0.2 リリース
「2-4 結果通知（コンビニ決済）」の「通知件数」の「説明」を修正（1 度に通知可能な件数を 1,000 件から 50 件に変更）
2018/02 ：Ver1.0.3 リリース
要求電文に支払期限時分項目を追加
電話番号項目にイーコン選択時の制約について説明追加
2020/03 ：Ver1.0.4 リリース
サークル K サンクスに関する記載を削除「2.2.2 応答電文 ： CvsAuthorizeResponseDto」の haraikomiUrl の説明を修正「2-4 結果通知（コンビニ決済）」 項目の並び順について追記
2022/02 ：Ver1.0.5 リリース
ファミリーマートとの接続形態が「直接接続」の場合の仕様を追加し、従来の記載は「イーコンテクスト経由接続」の場合の記載として説明
以下の用語の変更
変更前：決済サービスオプション
変更後：コンビニタイプ「2.2.2 応答電文 ： CvsAuthorizeResponseDto」の haraikomiUrl の説明に以下の内容を追加※以下のコンビニタイプは、ご契約のタイミングにより URL が返戻されない設定になっていることがあります。返戻されない場合は、弊社までご連絡ください。
lawson ： 各コンビニでのお支払い方法を説明する画面を表示します。
econ： 各コンビニでのお支払い方法を説明する画面を表示します。

サークルＫサンクスのロゴを削除「3-2 支払時の注意事項」のセブンイレブンの説明に、支払期限を「時分」まで指定した場合の注意事項を追記「3-4 利用可能なコンビニタイプの確認方法」を追加
2022/06 ：Ver1.0.6 リリース
「2.2.1 要求電文 ： CvsAuthorizeRequestDto」telNo の説明に「※famima, sej, other の場合は、5 桁未満は指定不可。」を追記「2-4 結果通知」の 4 ケタの連番を 0000～0049 に修正
2022/06 ：Ver1.0.7 リリース
「3-2 支払い時の注意事項」の"Fami ポート"を“マルチコピー機”に変更
2022/12 ：Ver1.0.8 リリース
4

VeriTrans4G インターフェース詳細 ～コンビニ決済～「2.2.1 要求電文 ： CvsAuthorizeRequestDto」telNo の説明に電話番号ではない数字で問題ない旨を追記「3-1 表示事項」を削除「3-2 支払い時の注意事項」を削除「3-3 使用可能文字一覧」の項番を 3-1 に変更「3-4 利用可能なコンビニタイプの確認方法」の項番を 3-2 に変更
2023/06 ：Ver1.0.9 リリース
「2.2.1 要求電文 ： CvsAuthorizeRequestDto」の説明を修正(serviceOptionType「3-4 利用可能なコンビニタイプの確認方法」 から「3-2 利用可能なコンビニタイプの確認方法」に変更。)(name1,name2「※詳細は「3-3 コンビニ決済使用可能文字一覧」参照。」から「※詳細は「3-1 使用可能文字一覧」参照。」に変更。)

5

VeriTrans4G インターフェース詳細 ～コンビニ決済～

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

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

任意項目：△

設定不可：×

応答電文 … 必ず返戻：○処理成功時のみ返戻：△

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

返戻なし：×

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

6

VeriTrans4G インターフェース詳細 ～コンビニ決済～

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

項目名
サービスオプションタイプ

書式・制限
右記参照

（コンビニタイプ）

説明"sej"： セブン－イレブン"other"： デイリーヤマザキ、ヤマザキデイリーストア

設定○※上記以外のコンビニは、加盟店様のご契約内容により以下の 2 つのパターンに分かれます。
（パターン１） ファミリーマートとの接続形態が「直接接続」の場合"famima" ： ファミリーマート"lawson" ： ローソン(ローソン、ミニストップ、セイコーマート)（パターン２） ファミリーマートとの接続形態が「イーコンテクスト経由接続」の場合"econ"： イーコン（ローソン、ファミリーマート、ミニストップ、セイコーマート）

どちらのパターンを利用できるかは、MAP のダッシュボードの「サービス利用情報」より確認できます。
「3-2 利用可能なコンビニタイプの確認方法」に説明していますのでご確認ください。
orderId

取引 ID

半角英数字 100 桁以内「2-1 共通」の 「orderId（取引 ID）について」を参照

amount金額

半角数字 6 桁以内

1 以上 299,999 以下。

○○※0 円、または 30 万円以上の金額を設定した場合、エラーが発生するか、コンビニ店舗で支払受付を拒否される可能性があります。
name1

氏名 1

全角 20 バイト以内

顧客姓○

文字列のサイズは、全角 1 文字を 2 バイトとみなした数値です。20 バイトの場合は全角文字１０桁となります。
※詳細は「3-1 使用可能文字一覧」参照。
name2氏名 2

全角 20 バイト以内

顧客名○

文字列のサイズは、全角 1 文字を 2 バイトとみなした数値です。20 バイトの場合は全角文字１０桁となります。
※詳細は「3-1 使用可能文字一覧」参照。

7

VeriTrans4G インターフェース詳細 ～コンビニ決済～

要求電文 ： CvsAuthorizeRequestDto
フィールド名
telNo

項目名
電話番号

書式・制限

説明

半角数字 13 桁以内

顧客電話番号

右記参照

数字のみは 11 桁以内、ハイフン含みは 13 桁以内

設定○例） 0311112222、03-1111-2222、09011112222、090-1111-2222※econ, lawson の場合は、電話番号 8 桁未満は指定不可。
※famima, sej, other の場合は、5 桁未満は指定不可。
※電話番号は固定値としないでください。
※電話番号でなくても規定の桁数の数字であれば問題はありません。電話番号の設定が難しい場合は、固定値ではない数字の文字列を設定してください。
payLimit

支払期限

payLimitHhmm

支払期限時分pushUrl

プッシュ URL

paymentType

支払区分

free1

備考 1

半角数字 10 桁

YYYY/MM/DD の形式

右記参照

sej

： 当日～150 日後を指定可能

famima： 当日～60 日後を指定可能

lawson： 当日～60 日後を指定可能

econ： 当日～60 日後を指定可能

other： 当日～365 日後を指定可能○△

半角数字 5 桁

HHMM または HH:MM の形式

右記参照※未指定の場合の期限は、期限日当日の 23:59 までとなります。

URL に使用可能な入金通知先 URL を指定

半角文字 256 桁以内※未指定の場合は、MAP の「各種設定変更」で設定した入金通知 URL に通知されます。

"0"固定※現在はリザーブパラメーターのため無条件に "0" を設定○文字列

備考欄（商品詳細などに利用する）

※

詳細は右記

sej

： 使用不可famima： 任意（38 バイト）

lawson： 任意（50 バイト）econ

： 任意（50 バイト）other

： 任意（32 バイト）

△

右記参照

free2

備考 2文字列

備考欄（商品詳細などに利用する）

詳細は右記

sej

： 使用不可famima： 任意（38 バイト）

lawson： 使用不可econ： 使用不可other： 任意（32 バイト）※8

VeriTrans4G インターフェース詳細 ～コンビニ決済～

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

項目名

書式・制限

説明

serviceType

決済サービスタイプ

半角英数字 10 桁以内

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

mstatus

処理結果コード

半角英数字 32 文字以内"success" ： 正常終了
"failure"

設定○○： 異常終了"pending" ： 保留vResultCode

詳細結果コード

半角英数字 16 文字処理の結果を詳細に表すコード○

4 桁ずつ 4 つのブロックで構成され、各ブロックでサービス毎の処理結果を表します。
詳細は『結果コード一覧』を参照下さい。
merrMsg

エラーメッセージ

文字列 1024 バイト以内

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

marchTxn

電文 ID

文字列 100 桁以内

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

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

取引 ID

半角英数字 100 文字以内

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

custTxn

取引毎に付く ID

文字列 100 桁以内

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

receiptNo

受付番号

文字列 32 文字以内

正常に決済請求が完了した際に返戻されるコンビニの受付番号

haraikomiUrl

払込票 URL

半角英数字 256 文字以内

sej

： 払込票番号（13 桁）

famima： 企業コード（5 桁）-注文番号（12 桁）

lawson： 受付番号（6 桁）

econ： 受付番号（6 桁）other： オンライン決済番号（11 桁）

コンビニから返される払込票 URL。
sej

： 消費者の利用端末 PC・スマートフォン・フィーチャーフォンを判別して表示します。

other： PC、スマートフォン、携帯電話（フィーチャーフォン）での表示・支払に対応しています。

○○△※

携帯電話（フィーチャーフォン）で表示する場合には、戻り値の「https://～.info/JLP/JLPcon」の部分を「https://w2.kessai.info/JLM/JLMcon」に置換えてご利用ください。
例）https://w2.kessai.info/JLM/JLMcon?code=xxx～&rkbn=1
famima： スマートフォン用画面を表示します。 ※ 「3-2 支払時の注意事項」を参照してください。

※以下のコンビニタイプは、ご契約のタイミングにより URL が返戻されない設定になっていることがあります。
返戻されない場合は、弊社までご連絡ください。

txnVersion

MDK バージョン

半角英数字 5 桁lawson： 各コンビニでのお支払い方法を説明する画面を表示します。

econ： 各コンビニでのお支払い方法を説明する画面を表示します。

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

○9VeriTrans4G インターフェース詳細 ～コンビニ決済～

2-3 キャンセル
コンビニ決済では、支払い前の申込に対するキャンセルが可能です。
消費者がコンビニエンスストアで支払いを行った後のキャンセルはできませんのでご注意ください。

2.3.1 要求電文 ： CvsCancelRequestDto
要求電文 ： CvsCancelRequestDto
フィールド名

項目名

書式・制限

説明

serviceOptionType

決済サービスオプション

右記参照

申込の要求電文で指定した値

orderId

取引 ID

半角英数字 100 桁以内

決済請求時に採番した取引 ID

設定

○
○

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

項目名

書式・制限

説明

serviceType

決済サービスタイプ

半角英数字 10 桁以内

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

mstatus

処理結果コード

半角英数字 32 文字以内

"success" ： 正常終了
"failure"

設定○○： 異常終了"pending" ： 保留vResultCode

詳細結果コード

半角英数字 16 文字処理の結果を詳細に表すコード○

4 桁ずつ 4 つのブロックで構成され、各ブロックでサービス毎の処理結果を表します。
詳細は『結果コード一覧』を参照下さい。
merrMsg

エラーメッセージ

文字列 1024 バイト以内

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

marchTxn

電文 ID

文字列 100 桁以内

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

orderId

取引 ID

半角英数字 100 文字以内

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

custTxn

取引毎に付く ID

文字列 100 桁以内

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

txnVersion

MDK バージョン

半角英数字 5 桁

電文のバージョン○○

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

○○○

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

10VeriTrans4G インターフェース詳細 ～コンビニ決済～

2-4 結果通知
決済サーバーは、決済センターからの入金完了情報（消費者の支払完了情報）を受け取り、該当の入金が完了したと判断した場合に店舗様へ入金通知を送信します。
※入金取引が結果通知対象となります。
結果通知に関するサービス共通の仕様については、『開発ガイド』を併せてご参照ください。

項番1

フィールド名

項目名

書式・制限

説明

numberOfNotify

通知件数

半角数字 4 桁以内

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

2pushTime

送信時刻

半角数字 14 桁

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

3pushId

識別 ID

半角数字 8 桁

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

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

取引 ID

半角英数字 100 桁以内

5cvsType

CVS タイプ

半角英数字 10 桁以内

消費者が入金を行ったコンビニチェーンを示す以下の値を設定"sej"：セブン－イレブン"other"：その他（デイリーヤマザキ）※上記以外のコンビニは、加盟店様のご契約内容により以下の 2 つのパターンに分かれます。
（パターン１） ファミリーマートとの接続形態が「直接接続」の場合"famima"：ファミリーマート"lawson"：ローソン、ミニストップ、セイコーマート（パターン２） ファミリーマートとの接続形態が「イーコンテクスト経由接続」の場合"econ-lw"：ローソン"econ-fm"：ファミリーマート"econ-mini"：ミニストップ"econ-other"：セイコーマート

6

receiptNo

受付番号

半角英数字 32 桁以内

7

receiptDate

完了日時

半角数字 14 桁

8rcvAmount

入金金額

半角数字 6 桁以内

9dummy

ダミー決済フラグ

半角数字 1 桁

消費者側で支払が完了した時刻（YYYYMMDDhhmmss 形式）
ダミーデータを示す場合は"1"を設定
11

VeriTrans4G インターフェース詳細 ～コンビニ決済～（注意事項）
pushId（識別 ID）は、他の決済サービスで使用された Id と重複する場合がありますので、ユニークキーとして処理しないようにしてください。



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

12VeriTrans4G インターフェース詳細 ～コンビニ決済～

第3章 その他 補足事項
3-1 使用可能文字一覧
コンビニ決済の下記全角項目にて、JIS 基本漢字（JIS X 0208）で使用可能な文字の範囲を以下に表します。
使用可能文字の範囲外の文字を使用した場合、処理結果が正常の場合でも文字化けが発生する可能性があります。
■ 氏名 1（name1）、氏名 2（name2）
区点

内容

01 区

長音符 ー

同の字点 々ノノ字点 〃しめ 〆03 区

数字・アルファベット

04 区

平仮名

05 区

カタカナ

16 区～47 区

第一水準漢字48 区～84 区

第二水準漢字一の字点 ヽ ヾ ゝ ゞ13

VeriTrans4G インターフェース詳細 ～コンビニ決済～

3-2 利用可能なコンビニタイプの確認方法
利用可能なコンビニタイプ（serviceOptionType）は、MAP のダッシュボードの「サービス利用情報」－「コンビニ」で確認することができます。

3.2.1 ファミリーマートとの接続形態が「直接接続」の加盟店様の場合

図中に表示されている番号は、以下のコンビニタイプ（serviceOptionType）に対応しています。
番号表示名コンビニタイプ

支払可能なコンビニエンスストア01

セブンイレブンsej

セブンイレブン02

ローソン・セイコーマートその他

lawson

ローソン、ミニストップ、セイコーマート

03

ファミリーマート

famimaファミリーマート04

デイリーヤマザキ

otherデイリーヤマザキ、ヤマザキデイリーストア

14VeriTrans4G インターフェース詳細 ～コンビニ決済～

3.2.2 ファミリーマートとの接続形態が「イーコンテクスト経由接続」の加盟店様の場合

図中に表示されている番号は、以下のコンビニタイプ（serviceOptionType）に対応しています。
番号

表示名

コンビニタイプ

支払可能なコンビニエンスストア

01

セブンイレブンsej

セブンイレブン04

デイリーヤマザキ

otherデイリーヤマザキ、ヤマザキデイリーストア

05

ローソン・ファミリーマートその他

econ

ローソン、ファミリーマート、ミニストップ、セイコーマート

15