mPOS アプリ連携開発ガイド（Android 版）
Ver.1.7.1

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

mPOS アプリ連携開発ガイド（Android 版）

目次
本ガイドについて ........................................................................................................................................................ 3
1-1 本ガイドの内容............................................................................................................................................................. 3
1-2 対象者 ......................................................................................................................................................................... 3
1-3 著作権、および問い合わせ先 ....................................................................................................................................... 3
開発ガイドライン......................................................................................................................................................... 4
2-1 事前準備 ..................................................................................................................................................................... 4
2-2 mPOS アプリ実行環境.................................................................................................................................................. 4
2-3 mPOS アプリ連携仕様.................................................................................................................................................. 4
2-4 mPOS アプリ連携機能概要........................................................................................................................................... 5
2-5 決済機能概要 .............................................................................................................................................................. 62-6 取消機能概要 .............................................................................................................................................................. 9
2-7 返金機能概要 ............................................................................................................................................................ 10
インターフェース詳細 ................................................................................................................................................ 11
3-1 共通 .......................................................................................................................................................................... 11
3-1-1 Intent 共通設定.................................................................................................................................................... 11
3-1-2 Extra Data 共通設定............................................................................................................................................ 12
3-2 決済 API .................................................................................................................................................................... 13
3-2-1 リクエストパラメーター .......................................................................................................................................... 13
3-2-2 レスポンスパラメーター ........................................................................................................................................ 15
3-3 取消 API .................................................................................................................................................................... 19
3-3-1 リクエストパラメーター .......................................................................................................................................... 19
3-3-2 レスポンスパラメーター ........................................................................................................................................ 19
3-4 返金 API .................................................................................................................................................................... 21
3-4-1 リクエストパラメーター .......................................................................................................................................... 21
3-4-2 レスポンスパラメーター ........................................................................................................................................ 21
3-5 決済方法コード .......................................................................................................................................................... 24
3-6 支払手段 ................................................................................................................................................................... 25
3-7 支払種別 ................................................................................................................................................................... 26
3-8 カード所有者検証方法タイプ ....................................................................................................................................... 26
3-9 エラーコード ............................................................................................................................................................... 27
サンプルプログラムの利用 ....................................................................................................................................... 31
4-1 サンプルプログラム動作要件 ...................................................................................................................................... 31
4-2 サンプルプログラム機能概要 ...................................................................................................................................... 31
4-3 リクエスト電文の送信例 .............................................................................................................................................. 32
4-4 レスポンス電文の受信例 ............................................................................................................................................ 33

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

1

mPOS アプリ連携開発ガイド（Android 版）

テストパターン .......................................................................................................................................................... 34
5-1 カード決済系のテストパターン ..................................................................................................................................... 34
5-1-1 クレジットカード決済処理のテストパターン ............................................................................................................ 34
5-1-2 NFC 決済処理のテストパターン ............................................................................................................................ 35
5-1-3 銀聯決済処理のテストパターン ............................................................................................................................ 35
5-1-4 署名処理のテストパターン ................................................................................................................................... 35
5-1-5 取消処理のテストパターン ................................................................................................................................... 35
5-1-6 返金処理のテストパターン ................................................................................................................................... 36
5-2 コード決済系のテストパターン ..................................................................................................................................... 36
5-2-1 Alipay 決済 .......................................................................................................................................................... 36
5-2-2 Alipay+決済 ......................................................................................................................................................... 36
5-2-3 WeChat Pay 決済................................................................................................................................................ 37
5-2-4 LINE Pay 決済 .................................................................................................................................................... 37
5-2-5 d 払い決済........................................................................................................................................................... 38
5-2-6 PayPay 決済 ....................................................................................................................................................... 38
5-2-7 au PAY 決済 ........................................................................................................................................................ 39
5-2-8 メルペイ決済 ....................................................................................................................................................... 39
5-2-9 楽天ペイ決済 ...................................................................................................................................................... 40
5-2-10 J-Coin Pay 決済 ................................................................................................................................................ 40
5-2-11 UnionPay QR コード決済 ................................................................................................................................... 41
5-2-12 Smart Code 決済............................................................................................................................................... 41
5-3 マイル積算系のテストパターン .................................................................................................................................... 42
5-3-1 マイル積算処理のテストパターン .......................................................................................................................... 42
5-3-2 マイル積算取消処理のテストパターン................................................................................................................... 42
補足事項 ................................................................................................................................................................. 43
6-1 mPOS アプリの設定について ...................................................................................................................................... 43
6-2 自動取消・返金について ............................................................................................................................................. 43
改訂履歴 ................................................................................................................................................................. 44

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

2

mPOS アプリ連携開発ガイド（Android 版）

本ガイドについて
1-1 本ガイドの内容
mPOS はお手持ちのスマートフォン・タブレット端末で簡単にクレジット決済やコード決済などができる株式会社 DG フィナンシャ
ルテクノロジー（以下、DGFT）が提供するスマホ決済サービスです。加盟店様は mPOS 専用の決済アプリ（以下、mPOS アプリ）
をご利用いただくことで各種決済処理を行うことができます。この mPOS アプリは別アプリから連携することが可能であり、加盟店様が開発されたスマホアプリから mPOS アプリを呼び出すだけで mPOS アプリが持つ決済機能、返金機能をご利用いただくことが可能となります。
mPOS アプリにて、クレジットカードやバーコードの読み取り、IC・磁気情報の暗号化、mPOS 決済サーバーへの決済情報送信を行うため、加盟店様は mPOS アプリと連携することで簡単かつ迅速にお支払い・返金関連の機能を構築することが可能です。尚、クレジットカードの読み取りを行う際は、mPOS アプリがサポートするカードリーダーをご利用ください。
本ガイドではアプリ連携を行うに当たり開発に必要な内容について記載しています。

1-2 対象者
本ガイドは mPOS アプリと加盟店様アプリを連携させるために必要な内容を記載した開発者向けのガイドであり、Android アプ
リ開発を行う開発者を対象としています。

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

[配布について]本資料は株式会社 DG フィナンシャルテクノロジーの許可なく対外的に参照・配布することを禁止します。

[お問い合わせ先]
mPOS テクニカルサポート
電子メール： support-mpos@veritrans.jp

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

3

mPOS アプリ連携開発ガイド（Android 版）

開発ガイドライン
2-1 事前準備
mPOS アプリをご利用いただくに当たり次のものを事前にご準備ください。

１． mPOS アプリ ※Google Play から最新版 mPOS アプリのダウンロード・インストールを行ってください。
２． mPOS アプリがサポートするカードリーダー ※クレジットカード決済等でカードの読み取りを行う場合はご準備ください。
３． mPOS アプリがサポートするプリンター ※mPOS アプリ経由でレシート出力を行う場合はご準備ください。

2-2 mPOS アプリ実行環境
mPOS アプリとアプリ連携を行うための実行環境として、mPOS アプリをインストールされる Android 端末の Android のバージ
ョンが 5.0 以上であることをご確認ください。

2-3 mPOS アプリ連携仕様
mPOS アプリと加盟店様アプリを連携させる仕組みとして Intent を利用しています。Intent の仕様詳細については、次のサイト
をご確認ください。また、mPOS アプリとアプリ連携を行う場合は加盟店様アプリのマニフェストファイルに<queries>要素を追加し、その<queries>要素内に mPOS アプリのパッケージ名を指定する必要があります。

[Intent の仕様詳細]
https://developer.android.com/reference/android/content/Intent.html■マニフェストファイル（AndroidManifest.xml）の設定<manifest package="com.example.app">...
<queries><package android:name="jp.veritrans.mpos.v2.app.mpospay" /></queries>...
</manifest>

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

4

mPOS アプリ連携開発ガイド（Android 版）

2-4 mPOS アプリ連携機能概要
Intent を用いて連携することにより mPOS アプリが持つ機能の一部を加盟店様アプリから利用することができます。 アプリ連携（Intent 連携）により利用することができる mPOS アプリの機能は次の表の通りです。

モバイル端末

加盟店様

mPOS

アプリ

アプリ

mPOS

各種決済機関決済サーバー

各サービス提供機関

電文送受信

電文送受信

アプリ連携
（Intent 連携）

図 1 アプリ連携におけるアプリ・システム連携フロー表 1 機能概要一覧
機能名
決済機能

説明
加盟店様アプリから決済に必要な金額等の情報を引き渡し、mPOS アプリを介して決済・マイル積算を行う機能です。

取消機能

加盟店様アプリから売上が成立していない取引の mPOS 取引 ID を引き渡し、対象取引の取消を行う機能です。
※ mPOS 取引 ID とは、決済処理時に mPOS サービス内で発番される取引を一意に特定するための ID になります。
※ 取引が売上未成立の状態で一定時間経過すると mPOS 決済サーバーにて取消処理が実施されます。この取消機能は mPOS 決済サーバーが取消を実施する前に取り消したい場合にご利用ください。

返金機能

加盟店様アプリから取引の mPOS 取引 ID を引き渡し、対象取引の返金（売上取消）・マイル積算
取消を行う機能です。
※ mPOS 取引 ID とは、決済処理時に mPOS サービス内で発番される取引を一意に特定するための ID になります。
※ 仮売上状態の取引を取り消す場合もこの返金機能をご利用ください。
※ 取引が仮売上の状態で一定時間経過すると mPOS 決済サーバーにて返金処理が実施されます。

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

5

mPOS アプリ連携開発ガイド（Android 版）

2-5 決済機能概要
アプリ連携により mPOS アプリを呼び出すことで、mPOS アプリを介して決済処理・マイル積算処理を行うことができます。連携開始後の処理については、mPOS アプリが提供します画面に従い画面操作を行ってください。処理結果については処理終了後に加盟店様アプリへ Intent によって返却します。

【加盟店様アプリ】【mPOS アプリ】
アプリ連携

連携開始

① ログイン画面② サービス選択画面③ 金額入力画面④ 支払方法画面⑧ バーコード⑨ 会員番号

読取画面

読取・入力画面⑤ カード読取画面⑥ PIN 入力画面

⑦ 電子署名画面⑩ 結果画面
アプリ連携

結果取得

図 2 決済処理フロー
Copyright © 2022 DG Financial Technology, Inc., a Digital Garage company. All rights reserved.

6

mPOS アプリ連携開発ガイド（Android 版）① ログイン画面
mPOS アプリにログインを行います。ユーザーID とパスワードを入力してログインを行ってください。
mPOS アプリにログイン済の場合は、ログイン画面はスキップされます。

② サービス選択画面
クレジットカード決済など利用するサービスを選択します。利用可能なサービスについては mPOS サービスのご契約状況によって異なり、ご契約状況によっては本画面がスキップされることがあります。

③ 金額入力画面
取引に必要な「金額」と「説明」を設定します。アプリ連携した「金額」と「説明」が本画面に表示されますが、この画面にて内容の変更することができます。尚、アプリ連携する際、金額入力画面をスキップするよう設定した場合は本画面がスキップされます。

④ 支払方法画面 （クレジットカード決済、NFC 決済）
利用代金の支払方法を選択します。支払方法として「一括払い」、「分割払い」、「ボーナス一括」、「ボーナス月指定」、「リボ払い」
を選択することができます。ただし、選択できる支払方法は mPOS サービスのご契約状況によって異なります。また、支払方法
が１つしか選択できない場合は本画面がスキップされます。

⑤ カード読取画面 （クレジットカード決済、NFC 決済、銀聯決済）
消費者様が保持するカード（クレジットカードなど）の読み取りを行う画面です。カードの読み取りについては mPOS アプリがサポートするカードリーダーにて行ってください。

⑥ PIN 入力画面 （クレジットカード決済、NFC 決済、銀聯決済）
消費者様が保持するカードの暗証番号を入力する画面です。暗証番号の入力については mPOS アプリがサポートするカードリーダーにて行ってください。尚、取引を行うに当たり消費者様が提示されたカードの暗証番号の入力が不要の場合は本画面がスキップされます。

⑦ 電子署名画面 （クレジットカード決済、NFC 決済、銀聯決済）
消費者様に署名を行っていただく画面です。尚、署名が不要の場合は本画面がスキップされます。

⑧ バーコード読取画面 （コード決済）
消費者様が提示したバーコードの読み取りを行う画面です。消費者様が提示したバーコードの自動識別を行いコード決済方法の指定なく決済を行うことができます。また、自動識別ではなく加盟店様側でコード決済方法を指定することも可能です。
mPOS サービスがサポートするコード決済の種類については「3-5 決済方法コード」をご参照ください。

⑨ 会員番号読取・入力画面 （ANA マイル積算、ユナイテッド航空マイル積算、その他マイル積算）
消費者様が提示された会員番号の読み取り、入力を行う画面です。次の方法で消費者様の会員番号の読み取り、もしくは入力を行います。

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

7

mPOS アプリ連携開発ガイド（Android 版）

１．カードからの読み取り （※ANA マイル積算のみ）
mPOS アプリがサポートするカードリーダーを用いて消費者様が提示されたカードから会員番号を読み取ります。

２．バーコードからの読み取り （※ANA マイル積算のみ）
消費者様が提示されたバーコードから会員番号を読み取ります。

３．手入力
消費者様の会員番号を画面上で手入力します。

⑩ 結果画面
実行した取引の成否を表示する画面です。取引に成功した場合に限り、本画面にてレシートの出力が行えます。レシートの出力方法としては次の通りです。尚、アプリ連携する際、結果画面をスキップするよう設定した場合は本画面がスキップされ加盟店様
アプリに戻ります。

１．メール送信送信先となる消費者様のメールアドレスをフォームに入力後、「送信」ボタンを押下していただくとレシートメールが送信されます。

２．プリンター出力
本画面に存在します「プリンターで印字」を押下していただくと、プリンターからレシートが出力されます。
尚、プリンターで出力される場合は、予めご利用の Android 端末と mPOS アプリがサポートするプリンターが Bluetooth 接続（ペアリング）された状態であることが必要です。

３．QR コード
本画面に存在します「QR コードを表示」を押下していただくと、mPOS アプリ画面上に QR コードが表示されます。
消費者様がお手持ちのスマートフォン・タブレット端末にて、その表示された QR コードを読み取って頂きますとレシート画面を表示するための URL が表示されます。その URL クリックしていただくとレシートが表示されます。

※補足①～⑤、⑧、⑨の画面上に存在します「キャンセル」ボタンを押下した場合は、取引を中止したものとして加盟店様アプリに戻ります。一方、⑥、⑦の画面上に存在します「キャンセル」ボタンを押下した場合は、取引を意図的に失敗させたものとして⑩の結果画面に遷移します。

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

8

mPOS アプリ連携開発ガイド（Android 版）

2-6 取消機能概要
アプリ連携による取消処理は、mPOS アプリに対して取引を特定する ID（mPOS 取引 ID）を連携することで実施ができます。連
携開始後の処理については、mPOS アプリが提供します画面に従い画面操作を行ってください。処理結果については処理終了後に加盟店様アプリへ Intent によって返却します。

【加盟店様アプリ】【mPOS アプリ】
アプリ連携

連携開始

① ログイン画面

アプリ連携

結果取得

② 実行画面

図 3 取消処理フロー① ログイン画面
mPOS アプリにログインを行います。ユーザーID とパスワードを入力してログインを行ってください。
mPOS アプリにログイン済の場合は、ログイン画面はスキップされます。

② 実行画面
指定した取引に対して取消を実行します。処理を実行する場合は、ダイアログに表示される「はい」ボタンを押下してください。処理実行後は加盟店様アプリに戻ると共に処理結果を返します。
「いいえ」ボタンを押下した場合は、処理を中止したものとして、処理を実行せずに加盟店様アプリに戻ります。

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

9

mPOS アプリ連携開発ガイド（Android 版）

2-7 返金機能概要
アプリ連携による返金（売上取消）処理・マイル積算取消処理は、mPOS アプリに対して取引を特定する ID（mPOS 取引 ID）を連携することで実施ができます。連携開始後の処理については、mPOS アプリが提供します画面に従い画面操作を行ってください。
処理結果については処理終了後に加盟店様アプリへ Intent によって返却します。

【加盟店様アプリ】【mPOS アプリ】
アプリ連携

連携開始

① ログイン画面

アプリ連携

結果取得

② 実行画面

図 4 返金処理フロー① ログイン画面
mPOS アプリにログインを行います。ユーザーID とパスワードを入力してログインを行ってください。
mPOS アプリにログイン済の場合は、ログイン画面はスキップされます。

② 実行画面
指定した取引に対して返金・マイル積算取消を実行します。処理を実行する場合は、ダイアログに表示される「はい」ボタンを押下してください。処理実行後は加盟店様アプリに戻ると共に処理結果を返します。
「いいえ」ボタンを押下した場合は、処理を中止したものとして、処理を実行せずに加盟店様アプリに戻ります。

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

10

mPOS アプリ連携開発ガイド（Android 版）

インターフェース詳細
本章では、各機能にて使用する API について説明します。

3-1 共通アプリ連携を行うために加盟店様アプリの Activity から mPOS アプリの Activity を呼び出す必要があります。mPOS アプリのActivity を呼び出すためには Intent を生成し、Intent に連携に必要な値を設定した上で Activity#startActivity(Intent)メソッドを実行
してください。

3-1-1 Intent 共通設定
mPOS アプリと連携するために各機能で共通して設定可能な Intent のパラメーターは次の通りです。

No.
1

2

3

項目名
Package NameClass Name

Flags

必須

書式・制限

説明

○

文字列

連携先となる mPOS アプリのパッケージ名を設定します。

[String]

固定値： “jp.veritrans.mpos.v2.app.mpospay“

文字列

連携先となる mPOS アプリのクラス名を設定します。

[String]

固定値： “jp.veritrans.mpos.v2.app.scene.BootScene“

半角数字

連携した際の mPOS アプリの起動に関する振る舞いを設定

○

○

[int]

します。
Intet#FLAG_ACTIVITY_NEW_TASK とIntet#FLAG_ACTIVITY_CLEAR_TASK を設定してください。

※ これらの値が設定されていない場合は、mPOS アプリにログイン状態であっても未ログイン状態として判定され、連携する度にログインを行うことが求められます。
4

Extra Data○-mPOS アプリに連携するパラメーターを設定します。
Extra Data に設定する共通パラメーターの詳細については「3-1-2 Extra Data 共通設定」を参照してください。

※凡例： “○“：必須、 “△“：任意、 “-“：対象外

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

11

mPOS アプリ連携開発ガイド（Android 版）

3-1-2 Extra Data 共通設定
mPOS アプリと連携するために各機能で共通して設定可能な Intent の Extra Data は次の通りです。

No.
1

キー名（項目名）
action

必須

書式・制限

○

文字列

mPOS アプリに連携し実施する機能を設定します。

[String]

・決済機能： “payment“（アクション）

説明・取消機能： “cancel“
・返金機能： “refund“2

callbackPackageName○

callbackSuccessClassName

加盟店様アプリのパッケージ名を設定します。

[String]（コールバックパッケージ名）

3

文字列

○

（コールバック成功クラス名）

文字列

mPOS アプリでの処理に成功した場合に、加盟店様アプリ[String]

への戻り先となるパッケージ名を含む Activity クラス名を設
定します。

4

callbackErrorClassName○（コールバック失敗クラス名）

文字列

mPOS アプリでの処理に失敗した場合に、加盟店様アプリ[String]

への戻り先となるパッケージ名を含む Activity クラス名を設
定します。

5

callbackCancelClassName○（コールバック中止クラス名）

文字列

ユーザーが mPOS アプリでの処理を中止した場合に、加盟[String]

店様アプリへの戻り先となるパッケージ名を含む Activity ク
ラス名を設定します。

6

callbackSuccessActivityFlag△（コールバック成功起動フラグ）

半角数字

mPOS アプリから加盟店様アプリへ処理成功として戻る際[int]の Activity の起動方法を設定します。未設定の場合や設定値の型が不適切な場合は、Intet#FLAG_ACTIVITY_NEW_TASK が設定されたものとします。

7

callbackErrorActivityFlag△（コールバック失敗起動フラグ）

半角数字

mPOS アプリから加盟店様アプリへ処理失敗として戻る際[int]の Activity の起動方法を設定します。未設定の場合や設定値の型が不適切な場合は、Intet#FLAG_ACTIVITY_NEW_TASK が設定されたものとします。

8

callbackCancelActivityFlag△（コールバック中止起動フラグ）

半角数字

mPOS アプリから加盟店様アプリへ処理中止として戻る際[int]の Activity の起動方法を設定します。未設定の場合や設定値の型が不適切な場合は、Intet#FLAG_ACTIVITY_NEW_TASK が設定されたものとします。

※凡例： “○“：必須、 “△“：任意、 “-“：対象外

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

12

mPOS アプリ連携開発ガイド（Android 版）

3-2 決済 API
3-2-1 リクエストパラメーター
決済 API にて設定可能なリクエストパラメーターは次の通りです。尚、リクエストパラメーターについては Intent の Extra Data として設定してください。

No.
1

キー名（項目名）
amount

必須

書式・制限

△

半角数字

金額を設定します。

最大 8 桁※ 設定可能な値は 1 以上、99,999,999 以下です。

[String]※ 設定値にカンマを含めることはできません。

（金額）

説明

※ 本項目が未設定の場合、金額入力画面表示フラグに非表示“0“を設定しても金額入力画面が表示されます。
※ mPOS アプリの「マイル積算設定」にある入力単位設定
が「マイル数」に設定されている場合、本項目は無視されます。
※ マイル積算（ANA、ユナイテッド航空、その他マイル）を実行される場合の通貨単位は mPOS アプリの「マイル積算設定」にある通貨設定に従います。尚、通貨単位がドルで設定されている場合は、設定した値の下 2 桁が小数部として扱われます。
（例）入力値が 1234 の場合は$12.34 として処理されます。
2

description

△

（説明）

文字列

取引に対する説明を設定します。

最大 40 文字※ コード決済をご利用される場合は必須項目となります。

[String]※ マイル積算（ANA、ユナイテッド航空、その他マイル）をご利用される場合は値を設定しても無視されます。

3

miles

△

（マイル数）

半角数字

積算するマイル数を設定します。

最大 6 桁※ 本項目は mPOS アプリの「マイル積算設定」にある入力[String]

単位設定が「マイル数」に設定されている場合に有効です。
※ mPOS アプリの「マイル積算設定」にある入力単位設定
が「マイル数」で設定されている状態で本項目が未設定の場合は、金額入力画面表示フラグを非表示で設定しても金額入力画面が表示されます。

4

timesMiles（マイル回数）△

半角数字

積算するマイル数に対する倍率を設定します。

最大 2 桁※ 本項目は mPOS アプリの「マイル積算設定」にある入力[String]

単位設定が「マイル数」に設定されている場合に有効です。

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

13

mPOS アプリ連携開発ガイド（Android 版）※ mPOS アプリの「マイル積算設定」にある入力単位設定
が「マイル数」で設定されている状態で本項目が未設定の場合は、金額入力画面表示フラグを非表示で設定しても金額入力画面が表示されます。
5

inputAmountView△（金額入力画面表示フラグ）

半角数字

mPOS アプリにて金額・説明を入力する画面を表示するか

最大 1 桁

設定するためのフラグです。

[String]※ 値が未設定の場合は非表示“0“が設定された場合と同じ扱いとなります。
非表示： “0“、 表示： “1“

6completeView△（完了画面表示フラグ）

半角数字

mPOS アプリにて決済取引完了画面、もしくは決済取引失

最大 1 桁

敗画面を表示するか設定するためのフラグです。

[String]※ 値が未設定の場合は非表示“0“が設定された場合と同じ扱いとなります。
非表示： “0“、 表示： “1“7

originalOrderId△（加盟店取引 ID）

文字列

加盟店様アプリ側で管理する取引を特定するための ID を

[String]

設定します。

※凡例： “○“：必須、 “△“：任意、 “-“：対象外

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

14

mPOS アプリ連携開発ガイド（Android 版）

3-2-2 レスポンスパラメーター
決済 API の処理結果として取得可能なパラメーターは次の通りです。尚、レスポンスパラメーターについては Intent の Extra
Data に格納されています。

No.

1

キー名（項目名）

action

成

失

取

功

敗

消

時

時

時

○

○

○

status

文字列

説明“payment“： 決済機能

[String]（アクション）

2

書式・制限

○

○

○

（処理ステータス）

文字列“success“： 正常終了

[String]“failure“： 異常終了
“cancel“： キャンセル終了（途中離脱）

3

callingPackageName

○

○

○

errorCode

固定値： “jp.veritrans.mpos.v2.app.mpospay“[String]（呼び出し元パッケージ名）

4

文字列

-

○

-

半角数字

エラー内容を示すコード

最大 4 桁（エラーコード）[String]5

errorMessage

-

○

-

resultCode

エラーコードに対するメッセージ[String]（エラーメッセージ）

6

文字列

○

△

-

（結果コード）

半角英数字

処理結果を示すコードで、主にエラーコードの補足

最大 10 桁するコードが設定されます。

[String]
7

orderId○△-（mPOS 取引 ID）

半角英数字

mPOS サービスにて取引を一意に特定する ID

6桁[String]

8orderReferenceId

○

△

-

（mPOS 取引照会 ID）

文字列

mPOS サービスにて取引を照会するための ID

64 桁[String]9

originalOrderId

△

△

△

（加盟店取引 ID）

11

paymentMethodCode（決済方法コード）

文字列

リクエスト時に設定した加盟店取引 ID[String]

△

-

-

半角英数字
3桁

決済方法（サービス）を示すコード※ 定義される値は「3-5 決済方法コード」を参照[String]

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

15

mPOS アプリ連携開発ガイド（Android 版）

12

paymentSource

△

-

-

（支払手段）

半角英数字

決済時に利用された支払いの手段を示す情報

最大 64 桁※ 定義される値は「3-6 支払手段」を参照[String]
13

amount

○

△

△

（金額）

半角数字

取引を行った金額

最大 8 桁※ 金額にはカンマは含みません。

[String]14

discountAmount

△

-

-

（割引金額）

半角数字

クーポン等の利用で割引された金額

最大 8 桁※ 金額にはカンマは含みません。

[String]
15

totalAmount

△

-

-

（合計金額）

半角数字

取引の合計金額

最大 8 桁※ 金額にはカンマは含みません。

[String]
16

paymentTime

△

-

-

半角数字
14 桁

（取引日時）

決済処理が行われた最終日時（日本時間）。
※ 書式：yyyyMMddHHmmss[String]17

description

△

△

△

文字列

取引に対する説明最大 40 文字（説明）

[String]
18

cardNumber

△

-

-

文字列

先頭６桁、末尾４桁以外がマスクされたカード番号

最大 19 桁

（カード番号）[String]
19

cardNumberToken

△

-

-

文字列
最大 19 桁

（カード番号トークン）

先頭６桁、末尾４桁以外がマスクされたカード番号
トークン[String]
20

cardExpiry

△

-

-

文字列

年月部分がマスクされたカードの有効期限

最大 5 桁（カード有効期限）[String]21

cardType△--（カードタイプ）

22

jpo

△

-

-

（支払種別）

半角英数字

決済時に扱ったカードの取引種別を示すコード

2桁“MS“： 磁気ストライプ取引[String]“IC“： IC カード取引

半角英数字

一括払いや分割払い等の支払方法を示すコード

最大 83 桁※ 定義される値は「3-7 支払種別」を参照[String]23

authCode（承認番号）

△

-

-

半角英数字

※ 半角英数字の他に半角スペースを許容します。

最大 7 桁[String]

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

16

mPOS アプリ連携開発ガイド（Android 版）

24

acquirerCode

△

-

-

（仕向け先コード）

半角英数字

決済要求電文を仕向けた加盟店管理会社を示すコ

最大 2 桁ード[String]
25

26

centerAcquirerId

-

-

半角英数字

決済センターにてアクワイアラを識別するために関（決済センターアクワイアラ

最大 8 桁連付けられた一意な値

ID）[String]

centerTradeId

△

△

-

-

（決済センター取引 ID）

半角英数字

決済センターで取引を特定するための ID

最大 64 桁[String]

27

centerProcessId

△

-

-

（決済センター処理 ID）

半角英数字

決済センターで処理の照合を行うための ID

最大 6 桁[String]

28

centerReferenceCode

△

-

-

文字列

決済センターで発番される照会用のコード

最大 32 桁（決済センター照会コード）[String]
29

centerTransactionType

△

-

-

半角英数字

決済センターで管理される取引のタイプ

最大 8 桁（決済センター取引タイプ）[String]
30

centerTransactionDatetime

△

-

-

（決済センター取引日時）

文字列

決済センターで決済処理された日時

最大 24 桁※ 書式：yyyy-MM-ddTHH:mm:ssZ[String]（ISO 8601 形式）（例）2021-05-01T01:00:00+08:00

31

centerTerminalId

△

-

-

（決済センター端末 ID）

半角英数字

決済センターに登録された端末 ID

最大 32 桁[String]

32

centerMerchantId

△

-

-

ID）
centerMerchantName[String]△--

決済センターに登録されている加盟店 ID[String]名）
cupRequestTime

文字列
最大 64 桁（決済センターマーチャント

34

決済センターに登録されている加盟店 ID

最大 32 桁（決済センターマーチャント

33

文字列

△

-

-

半角数字
10 桁

（銀聯要求送信日時）

銀聯へ送信した際の送信日時※ 書式：MMddHHmmss[String]35

emvAppId（EMV アプリケーション ID）

△

-

-

半角英数字

IC カードに設定されたアプリケーションを識別する

最大 32 桁ID

[String]

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

17

mPOS アプリ連携開発ガイド（Android 版）

36

37

emvAtc

半角英数字

IC カード取引時に使用された IC カードに設定され（EMV アプリケーショントラン

最大 4 桁たカウンターの値

ザクションカウンター）[String]

emvAppLabel

△

△

-

-

-

-

半角英数字

IC カードに設定されたアプリケーションの名称

最大 16 桁（EM アプリケーションラベル）[String]
38

panSeqNumber

△

-

-

半角数字

IC カードに設定されたカードシーケンス番号

最大 2 桁（カードシーケンス番号）[String]
39

40

cvmType

-

-

半角英数字

カード保有者検証（本人確認）方法を示す値（カード所有者検証方法タイ

最大 2 桁※ 定義される値は「3-8 カード所有者検証方法タプ）[String]

cvmr

△

△

-

-

半角英数字

イプ」を参照カード保有者検証（本人認証）の結果

最大 6 桁（カード所有者検証結果）[String]
41

tvr

△

-

-

半角英数字

IC カード取引時の端末検証結果

最大 10 桁（端末検証結果）[String]
42

43

tsi

△

-

-

半角英数字

（トランザクションステータス情最大 4 桁報）[String]

txnCryptogram

△

-

-

半角英数字

IC カード取引時のカード認証の記録

IC カード取引時に作成される暗号文

最大 16 桁（トランザクション暗号文）[String]44

mileageMembershipNo

△

-

-

（マイレージ会員番号）

半角数字

ANA マイレージクラブお客様番号などの各種マイ最大 10 桁レージの会員番号[String]
45

usageType△--（利用タイプ）46

lastUseDate△（前回利用日）

-

-

半角英数字

消費者が加盟店を利用した状況を示す値

1桁“0“：初回利用[String]“1“：複数回利用

半角数字

当該取引の決済・積算を行った日時を基準とした8桁

前回利用した日[String]※ 書式：yyyyMMdd※凡例： “○“：必須、 “△“：任意、 “-“：対象外

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

18

mPOS アプリ連携開発ガイド（Android 版）

3-3 取消 API
3-3-1 リクエストパラメーター
返金 API にて設定可能なリクエストパラメーターは次の通りです。尚、リクエストパラメーターについては Intent の Extra Data として設定してください。

No.
1

フィールド名（項目名）

必須

書式・制限

○

半角英数字

orderId（mPOS 取引 ID）

説明
mPOS サービスにて取引を一意に特定する ID

6桁[String]2

originalOrderId△（加盟店様アプリ取引 ID）

文字列

加盟店様アプリ側で管理する取引を特定するための ID を

[String]

設定します。

※凡例： “○“：必須、 “△“：任意、 “-“：対象外

3-3-2 レスポンスパラメーター
取消 API の処理結果として取得可能なパラメーターは次の通りです。尚、レスポンスパラメーターについては Intent の Extra
Data に格納されています。

No.

1

フィールド名（項目名）

action

成

失

取

功

敗

消

時

時

時

○

○

○

status

文字列

説明“cancel“： 取消機能

[String]（アクション）

2

書式・制限

○

○

○

（処理ステータス）

文字列“success“： 正常終了

[String]“failure“： 異常終了
“cancel“： キャンセル終了（途中離脱）

3

callingPackageName

○

○

○

errorCode

固定値： “jp.veritrans.mpos.v2.app.mpospay“[String]（呼び出し元パッケージ名）

4

文字列

-

○

-

半角数字

エラー内容を示すコード

最大 4 桁（エラーコード）[String]5

errorMessage（エラーメッセージ）

-

○

-

文字列

エラーコードに対するメッセージ[String]

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

19

mPOS アプリ連携開発ガイド（Android 版）

6

resultCode

○

△

-

（結果コード）

半角英数字

処理結果を示すコードで、主にエラーコードの補足す

最大 10 桁るコードが設定されます。

[String]
7

orderId○△△（mPOS 取引 ID）

半角英数字

mPOS サービスにて取引を一意に特定する ID

6桁[String]8

originalOrderId△（加盟店様アプリ取引 ID）

△

△

文字列

リクエスト時に設定した加盟店様アプリ取引 ID[String]※凡例： “○“：必須、 “△“：任意、 “-“：対象外

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

20

mPOS アプリ連携開発ガイド（Android 版）

3-4 返金 API
3-4-1 リクエストパラメーター
返金 API にて設定可能なリクエストパラメーターは次の通りです。尚、リクエストパラメーターについては Intent の Extra Data として設定してください。

No.
1

フィールド名（項目名）

必須

書式・制限

○

半角英数字

orderId（mPOS 取引 ID）

説明
mPOS サービスにて取引を一意に特定する ID

6桁[String]2

originalOrderId△（加盟店取引 ID）

文字列

加盟店様アプリ側で管理する取引を特定するための ID を

[String]

設定します。

※凡例： “○“：必須、 “△“：任意、 “-“：対象外

3-4-2 レスポンスパラメーター
返金 API の処理結果として取得可能なパラメーターは次の通りです。尚、レスポンスパラメーターについては Intent の Extra
Data に格納されています。

No.

1

フィールド名（項目名）

action

成

失

取

功

敗

消

時

時

時

○

○

○

status

文字列

説明“refund“： 返金機能

[String]（アクション）

2

書式・制限

○

○

○

（処理ステータス）

文字列“success“： 正常終了

[String]“failure“： 異常終了
“cancel“： キャンセル終了（途中離脱）

3

callingPackageName

○

○

○

errorCode

固定値： “jp.veritrans.mpos.v2.app.mpospay“[String]（呼び出し元パッケージ名）

4

文字列

-

○

-

半角数字

エラー内容を示すコード

最大 4 桁（エラーコード）[String]5

errorMessage（エラーメッセージ）

-

○

-

文字列

エラーコードに対するメッセージ[String]

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

21

mPOS アプリ連携開発ガイド（Android 版）

6

resultCode

○

△

-

（結果コード）

半角英数字

処理結果を示すコードで、主にエラーコードの補足す

最大 10 桁るコードが設定されます。

[String]
7

orderId○△△（mPOS 取引 ID）

半角英数字

mPOS サービスにて取引を一意に特定する ID

6桁[String]8

originalOrderId

△

△

△

（加盟店取引 ID）

9

10

centerAcquirerId

文字列

リクエスト時に設定した加盟店取引 ID[String]

-

-

半角英数字

決済センターにてアクワイアラを識別するために関連（決済センターアクワイアラ

最大 8 桁付けられた一意な値

ID）[String]

centerTradeId

△

△

-

-

（決済センター取引 ID）

半角英数字

決済センターで取引を特定するための ID

最大 64 桁[String]

11

centerProcessId

△

-

-

（決済センター処理 ID）

半角英数字

決済センターで処理の照合を行うための ID

最大 6 桁[String]

12

centerReferenceCode

△

-

-

文字列

決済センターで発番される照会用のコード

最大 32 桁（決済センター照会コード）[String]
13

centerTransactionType

△

-

-

半角英数字

決済センターで管理される取引のタイプ

最大 8 桁（決済センター取引タイプ）[String]
14

centerTransactionDatetime

△

-

-

（決済センター取引日時）

文字列

決済センターで決済処理された日時

最大 24 桁※ 書式：yyyy-MM-ddTHH:mm:ssZ[String]（ISO 8601 形式）（例）2021-05-01T01:00:00+08:00

15

centerRefundDatetime

△

-

-

（決済センター返金日時）

文字列

決済センターで返金処理された日時

最大 24 桁※ 書式：yyyy-MM-ddTHH:mm:ssZ[String]（ISO 8601 形式）（例）2021-05-01T01:00:00+08:00

16

centerTerminalId（決済センター端末 ID）

△

-

-

半角英数字

決済センターに登録された端末 ID

最大 32 桁[String]

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

22

mPOS アプリ連携開発ガイド（Android 版）

17centerMerchantId

△

-

-

ID）
centerMerchantName

決済センターに登録されている加盟店 ID

最大 32 桁（決済センターマーチャント

18

文字列

[String]
△

-

-

文字列

決済センターに登録されている加盟店 ID

最大 64 桁（決済センターマーチャント名）[String]
19

cupRequestTime△（銀聯要求送信日時）

-

-

半角数字
10 桁

銀聯へ送信した際の送信日時※ 書式：MMddHHmmss[String]※凡例： “○“：必須、 “△“：任意、 “-“：対象外

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

23

mPOS アプリ連携開発ガイド（Android 版）

3-5 決済方法コード
決済方法（サービス）として定義する値とその名称は次の通りです。

値

分類

名称

001

カード決済系

クレジットカード決済

002

カード決済系

銀聯決済

010

カード決済系

NFC 決済020

コード決済系

Alipay 決済

021

コード決済系

Alipay+決済

030

コード決済系

WeChat Pay 決済

040

コード決済系

LINE Pay 決済

050

コード決済系

d 払い決済060

コード決済系

PayPay 決済

070

コード決済系

au Pay 決済

080

コード決済系

メルペイ決済090

コード決済系

楽天ペイ決済100

コード決済系

J-Coin Pay 決済

110

コード決済系

UnionPay QR コード決済

120

コード決済系

Smart Code 決済

Z01

コード決済系

コード決済 ※コード決済を特定できない場合の汎用的なコードです。

A01

マイル積算系

ANA マイル積算

A02

マイル積算系

ユナイテッド航空マイル積算

AZZ

マイル積算系

その他マイル積算

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

24

mPOS アプリ連携開発ガイド（Android 版）

3-6 支払手段
支払手段は消費者が支払いを行なった手段を示した情報です。この支払手段はコード決済を実施した場合に限り取得することができます。ただし、Smart Code 決済を行なった場合については決済処理を実施した後日に取得可能となります。また、テストア
カウントを利用して Alipay+決済、Smart Code 決済を行なった場合は支払手段が無作為に決定されます。
支払手段として定義する値は次の通りです。

値

名称

ALIPAY_CN

Alipay

ALIPAY_HK

AlipayHK

WECHATPAY

WeChat Pay

LINEPAY

LINE Pay

DPAYMENT

d 払い

AUPAY

au PAYPAYPAY

PayPayRPAY

楽天ペイ

MERPAY

メルペイ

JCOINPAY

J-Coin Pay

UNIONPAY_QR

UnionPay QR コード

GINKOUPAY

銀行 Pay

KPLUS

K PLUSEPOSPAYEPOS Pay

PRING

pring

ATONE

atone

AFTEE

aftee

PREMOCODE

プレモコード払い

MYJCBPAYMyJCB Pay

ANAPAYANA Pay

FAMIPAYFamiPay

LALAPAY

ララ Pay

PAIDY

Paidy

KAKAOPAY

KakaoPayTNG

TnG e-wallet

EZLINK

Ez-Link eWallet

TRUEMONEY

TrueMoney

DANA

DANA

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

25

mPOS アプリ連携開発ガイド（Android 版）

値
GCASH

名称
GCash

3-7 支払種別
支払種別は一括払いや分割払い等の支払方法を定義した値です。支払種別として定義するは次の通りです。

値

内容

10

一括払い

21

ボーナス一括払い

23Fmm

ボーナス払い（ボーナス月指定）

61AmmCxx

分割払い80

リボルビング払い※ “Amm“は省略される場合があります。
※ “Amm“の“mm“部分は支払開始月を設定します。

（例）１月の場合：A01※ “Cxx“の“xx“部分は分割回数を設定します。

（例）３回の場合：C03※ “Fmm“の“mm“はボーナス月を設定します。

（例）４月の場合：F04

3-8 カード所有者検証方法タイプ
カード所有者検証（本人確認）方法として定義する値は次の通りです。

値

内容

00

不明

01

検証失敗

02

検証不要

10

PIN（暗証番号）での検証

11

署名での検証12

PIN（暗証番号）と署名の両方での検証

13

消費者端末上での検証

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

26

mPOS アプリ連携開発ガイド（Android 版）

3-9 エラーコード
コード値

説明

101

エラーが発生しました。別のカードをご利用ください。

102

限度額オーバーのためカードが使用できない状態です。

103

磁気決済はご利用できません。IC カードスロットにカードを挿入するか、別のカードをご利用ください。

104

IC 決済はご利用できません。カードをスライドするか、別のカードをご利用ください。

105

エラーが発生しました。別の支払い方法をご利用ください。

106

暗証番号誤りのため取引に失敗しました。再度お試しください。

107

NFC 決済はご利用できません。別のカードをご利用ください。

108

取引に失敗しました。クレジットカード決済を指定し、IC 決済対応のカードで再度お試しください。

109

暗証番号を一定回数以上間違えました。カード発行会社にお問い合わせください。

110

消費者事由（残高不足など）により取引に失敗しました。

111

消費者事由（限度額超過など）により処理に失敗しました。

112

消費者様がアプリに登録されているクレジットカードをご確認ください。

113

もう一度、QR コード又はバーコードの読取りを行ってください。

114

会員番号に誤りがあります。会員番号をご確認ください。

115

会員番号の読取りに失敗しました。他のカードをご利用いただくか、別の読取り手段をご利用ください。

116

会員番号の読取りに失敗しました。もう一度お試しいただくか、別の読取り手段をご利用ください。

117

指定した支払方法では決済できません。

118

消費者事由により処理に失敗しました。

119

消費者事由（回数制限など）により処理に失敗しました。

120

消費者様が入力したパスワードが不正です。

121

消費者様が決済中にキャンセルしました。

122

使用できないクーポンです。クーポンをご確認ください。

123

期限切れのプロモーションです。プロモーションの内容をご確認ください。

124

使用できないクーポンです。クーポンをご確認ください。

201

エラーが発生しました。利用可能なカードブランドをご利用ください。

202

決済センターが混雑しています。後ほどお試しください。

203

エラーが発生しました。もう一度お試しください。

204

エラーが発生しました。もう一度お試しください。

205

決済センター側が決済申込を受け付けることができない時間帯であるため、数分後に再度お試しください。

206

マイルの積算に失敗しました。

207

上限額を超える金額は指定できません。

208

金額が大きすぎるため受付できません。

209

決済処理に失敗しました。もう一度お試しください。

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

27

mPOS アプリ連携開発ガイド（Android 版）

コード値

説明

210

決済センターがメンテナンス中です。

211

取引に失敗しました。加盟店様の契約状況等をご確認ください。

301

エラーが発生しました。別のカードをご利用ください。

401

取引の有効期限が切れました。取引をやり直してください。

402

エラーが発生しました。もう一度お試しください。

403

エラーが発生しました。もう一度お試しください。

404

決済待ち時間を超過したため取引が失敗しました。

501

返金処理に失敗しました。

502

対象の取引は既に振込の対象となっています。そのため返金できません。

503

対象の取引は既に振込が完了しています。そのため返金できません。

504

返金の期限が切れました。このお取引を返金できません。

505

返金処理を実行する権限がありません。

507

マイルの積算取消に失敗しました。

508

このマイルの積算は既に取消されています。

509

積算取消の期限が切れました。このお取引を取消しできません。

510

指定した取引は既に返金（売上取消）されています。

601

取消に失敗しました。

602

取消処理を実行する権限がありません。

603

指定した取引は既に取消されています。

604

取消の実行期限が切れました。指定した取引を取消しできません。

901

エラーが発生しました。もう一度お試しください。

902

指定した取引が存在しません。

903

指定した取引は現在処理中のため失敗しました。

904

指定した取引は実行可能なステータスではありません。

905

ご利用のサービスは未契約です。

906

指定した処理・要求は拒否されました。

991

認証に失敗しました。

997

エラーが発生しました。もう一度お試しください。

998

エラーが発生しました。もう一度お試しください。

999

エラーが発生しました。もう一度お試しください。

1001

パラメーターの値として不適切な値が設定されたパラメーターが存在します。

1002

必須であるパラメーターが不足しています。

1003

指定した mPOS 取引 ID に紐付く取引が存在しません。

1006

ご利用のスマートフォン/タブレットが圏外にあるなどの理由で通信が行えません。

1007

利用可能な決済方法がありません。

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

28

mPOS アプリ連携開発ガイド（Android 版）

コード値

説明

1008

指定した決済方法に対応していないカードリーダーです。指定したカードリーダーをご確認ください。

1101

指定した mPOS 取引 ID に紐付く取引の状態が返金できない状態です。

1901

エラーが発生しました。もう一度お試しください。

2001

ユーザーパスワードの有効期限が切れました。パスワードの変更を行ってください。

2002

ユーザーアカウントがロックされました。mPOS アプリのログイン画面にある「パスワードをお忘れの場合」よりパスワードの再設定を行ってください。

2003

有効な金額を入力してください。

2004

有効な説明を入力してください。

2005

売上を行う権限がありません。

2006

取引が拒否されました。もう一度お試しください。

5001

カードリーダー内で処理に失敗しました。もう一度お試しください。

5002

カードリーダー内で処理に失敗しました。別のカードをご利用ください。

5003

カードリーダーが応答しません。カードリーダーとの接続をご確認ください。

5101

ユーザー操作によって処理がキャンセルされました。

5102

取引が拒否されました。もう一度お試しください。

5103

取引がキャンセルされました。

5104

エラーが発生しました。もう一度お試しください。

5105

エラーが発生しました。もう一度お試しください。

5106

IC アプリケーションの選択に失敗しました。

5107

エラーが発生しました。もう一度お試しください。

5108

エラーが発生しました。もう一度お試しください。

5109

エラーが発生しました。もう一度お試しください。

5110

IC カードがブロックされているため IC 決済をご利用できません。カード発行会社にお問い合わせください。

5111

エラーが発生しました。もう一度お試しください。

5112

エラーが発生しました。もう一度お試しください。

5113

エラーが発生しました。もう一度お試しください。

5114

エラーが発生しました。もう一度お試しください。

5115

エラーが発生しました。もう一度お試しください。

5116

エラーが発生しました。もう一度お試しください。

5117

エラーが発生しました。もう一度お試しください。

5118

エラーが発生しました。もう一度お試しください。

5199

エラーが発生しました。もう一度お試しください。

5201

IC 決済はご利用できません。カードをスライドするか、別のカードをご利用ください。

5202

IC 決済未対応の IC カードが挿入されました。別のカードをご利用ください。

5203

取引がキャンセルされました。

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

29

mPOS アプリ連携開発ガイド（Android 版）

コード値

説明

5204

非接触（NFC）対応のカードではありません。

9001

ユーザー操作によって処理がキャンセルされました。

9004

取引が拒否されました。もう一度お試しください。

9005

取引が拒否されました。もう一度お試しください。

9006

IC カードがブロックされているため IC 決済をご利用できません。カード発行会社にお問い合わせください。

9008

カメラの起動に失敗しました。

9009

結果を得られませんでした。別途照会を行い、結果をご確認ください。

9010

エラーが発生しました。もう一度お試しください。

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

30

mPOS アプリ連携開発ガイド（Android 版）

サンプルプログラムの利用
加盟店様アプリから mPOS アプリにアプリ連携を行うための実装例としては、サンプルプログラムをご参照ください。

4-1 サンプルプログラム動作要件
サンプルプログラムの動作要件としては次の通りです。

・

動作 OS： Android 5.0 以上

・

開発言語： Java・

統合開発環境（IDE）： Android Studio Dolphin (2021.3.1)以上

4-2 サンプルプログラム機能概要
サンプルプログラムには機能として次のものが存在します。

機能名

対象ソースファイル

備考

決済機能

PaymentFragment.java

mPOS アプリに連携し、決済処理を行うサンプルプログラムです。

取消・返金機能

RefundFragment.java

mPOS アプリに連携し、取消・返金（売上取消）処理を行うサンプルプ
ログラムです。

電文表示機能LogFragment.java

サンプルプログラムから mPOS アプリに送信したリクエスト電文とmPOS アプリから受信したレスポンス電文を履歴として表示する機能です。

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

31

mPOS アプリ連携開発ガイド（Android 版）

4-3 リクエスト電文の送信例
mPOS アプリに連携する内容を Intent に設定し、Context#startActivity メソッドを実行することで mPOS アプリを呼び出すことが可能です。また、サンプルプログラムにある各種機能の実装内容も実装例として併せてご参照ください。

■mPOS アプリを呼び出す実装例@Override
public void onClick(View view) {PackageManager pm = activity.getPackageManager();
Intent intent = pm.getLaunchIntentForPackage(“jp.veritrans.mpos.v2.app.mpospay“);
if (intent != null) {intent.setClassName(“jp.veritrans.mpos.v2.app.mpospay“,“jp.veritrans.mpos.v2.app.scene.BootScene“);intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_CLEAR_TASK);
intent.putExtra(“action“, “payment“);
intent.putExtra(“callbackPackageName“, “sample.app“);
intent.putExtra(“callbackSuccessClassName“, “sample.app.SuccessActivity“);
intent.putExtra(“callbackErrorClassName“, “sample.app.ErrorActivity“);
intent.putExtra(“callbackCancelClassName“, “sample.app.CancelActivity“);
intent.putExtra(“amount“, “100“);
intent.putExtra(“description“, “sample“);intent.putExtra(“originalOrderId“, “X123456“);intent.putExtra(“inputAmountView“, “1“);
intent.putExtra(“completeView“, “1“);

startActivity(intent);} else {// mPOS アプリがインストールされていない等の理由で見つからない場合。
}}

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

32

mPOS アプリ連携開発ガイド（Android 版）

4-4 レスポンス電文の受信例
mPOS アプリでの処理が終了すると、リクエスト時に設定した戻り先となる Activity が呼び出されます。mPOS アプリでの処理結果については Intent に格納されて連携されますので、Intent から必要なレスポンスパラメーターを取得してください。また、サンプル
プログラムにある決済機能と返金機能の実装内容も実装例として併せてご参照ください。

■mPOS アプリからの処理結果を受け取る実装例@Override
protected void onResume() {super.onResume();Intent intent = getIntent();
if (intent != null) {String orderId = intent.getStringExtra(“orderId“);
String originalOrderId = intent.getStringExtra(“originalOrderId“);}}

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

33

mPOS アプリ連携開発ガイド（Android 版）

テストパターンmPOS ではテストアカウントを利用することにより、決済事業者まで通信を行わず mPOS サービス内での折り返しテストを行うことができます。テストアカウントを使用したときのテストパターンは下記の通りになります。
尚、テストアカウントの利用につきましては弊社サポートまでお問い合わせください。

5-1 カード決済系のテストパターン
カード決済系（クレジットカード決済、NFC 決済、銀聯決済）のテストを行う場合のテストパターンは以下の通りです。

5-1-1 クレジットカード決済処理のテストパターン
5-1-1-1. IC チップを用いた決済処理を行う場合
IC チップを用いたテスト決済処理を行う場合、金額の下 3 桁の値が“990“から“999“である場合は決済処理が失敗します。それ以外の金額を設定された場合は決済処理が成功します。
尚、ご利用の IC チップ搭載のカードによっては署名が求められる場合があります。その場合につきましては「5-1-4 署名処理のテストパターン」も決済処理結果に関係しますため、そちらも併せてご確認ください。

5-1-1-2. IC チップ搭載のカードにある磁気ストライプを用いてテストを行う場合
IC チップ搭載のカードにて磁気ストライプを用いたクレジットカード決済処理を行うと決済が拒否される場合がありますが、テ
スト用のユーザーID を使用した場合に限り、千の位が“2“となる金額を指定していただくことで、IC チップ搭載のカードでも磁気ストライプによる決済処理を行うことが可能です。開発やテストを行うに当たり IC チップ非搭載のカードをご準備できない場合などにご利用ください。
尚、磁気ストライプを用いた決済処理のテストパターンについては「5-1-1-3 磁気ストライプを用いた決済処理を行う場合」をご確認ください。

5-1-1-3. 磁気ストライプを用いた決済処理を行う場合
磁気ストライプを用いたテスト決済処理を行う場合、mPOS サービスの決済処理内ではテストで使用した実カードのブランドとは別に金額の下１桁の値から処理で使用するカードブランドが決定されます。この時、その決定されたカードブランドが mPOS
サービスとして決済利用可能な状態であれば、決済処理が成功します。決済利用できない状態である場合については決済処理が失敗します。また、金額の下 1 桁が下記の表に存在しない場合についても決済処理が失敗します。
尚、「5-1-4 署名処理のテストパターン」も決済処理結果に関係しますため、そちらも併せてご確認ください。

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

34

mPOS アプリ連携開発ガイド（Android 版）

条件

カードブランド

金額の下１桁が“0“

VISA

金額の下１桁が“1“

MASTER

金額の下１桁が“2“

JCB

金額の下１桁が“3“

AMEX

金額の下１桁が“4“Diners5-1-1-4. 新韓カード使用の場合
新韓カードを使用してテスト決済処理を行う場合、金額の下 3 桁の値が“989“～“999“である場合は決済処理が失敗します。
それ以外の金額を設定された場合は決済処理が成功します。尚、新韓カード取引のテスト決済を行う場合については、実際に新韓カードが必要となります。新韓カードの手配については加盟店様にてご準備ください。
尚、「5-1-4 署名処理のテストパターン」も決済処理結果に関係しますため、そちらも併せてご確認ください。

5-1-2 NFC 決済処理のテストパターン
NFC 決済でのテスト決済処理を行う場合、金額の下 3 桁の値が“990“から“999“である場合は決済処理が失敗します。それ以外の金額を設定された場合は決済処理が成功します。
尚、ご利用の IC チップ搭載のカードによっては署名が求められる場合があります。その場合につきましては「5-1-4 署名処理のテストパターン」も決済処理結果に関係しますため、そちらも併せてご確認ください。

5-1-3 銀聯決済処理のテストパターン
銀聯決済でのテスト決済処理を行う場合、金額の下 3 桁の値が“989“～“999“である場合は決済処理が失敗します。それ以外の金額を設定された場合は決済処理が成功します。また、テスト決済を行う場合は、銀聯カードをご用意していただく必要はなく、銀聯以外のブランドのクレジットカードでもテスト決済処理を実施することが可能です。
尚、「5-1-4 署名処理のテストパターン」も決済処理結果に関係しますため、そちらも併せてご確認ください。

5-1-4 署名処理のテストパターン
金額の下 2 桁が“10“である場合は、署名後の処理が失敗します。それ以外の金額を設定された場合は、署名後の処理が成功します。

5-1-5 取消処理のテストパターン
決済処理時に設定した金額の下 2 桁が“20“である場合は、処理が失敗します。それ以外の金額を設定された場合は処理が成功します。

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

35

mPOS アプリ連携開発ガイド（Android 版）

5-1-6 返金処理のテストパターン
決済処理時に設定した金額の下 2 桁が“20“である場合は、処理が失敗します。それ以外の金額を設定された場合は処理が成功します。

5-2 コード決済系のテストパターン
コード決済系のテストを行う場合のテストパターンは以下の通りです。

5-2-1 Alipay 決済
5-2-1-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “5“, “6“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“1“, “2“, “3“, “4“, “8“のいずれかの場合

処理失敗

5-2-1-2. 返金処理のテストパターン
決済処理時に設定した金額の下 2 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-2 Alipay+決済
5-2-2-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “1“, “5“, “9“のいずれかの場合

処理成功

金額の下１桁が“2“, “3“, “4“, “6“, “7“, “8“のいずれかの場合

処理失敗

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

36

mPOS アプリ連携開発ガイド（Android 版）

5-2-2-2. 返金処理のテストパターン
決済処理時に設定した金額の下 2 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-3 WeChat Pay 決済
5-2-3-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “5“, “6“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“1“, “2“, “3“, “4“, “8“のいずれかの場合

処理失敗

5-2-3-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“6“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-4 LINE Pay 決済
5-2-4-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “4“, “5“, “6“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“1“, “2“, “3“, “8“のいずれかの場合

処理失敗

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

37

mPOS アプリ連携開発ガイド（Android 版）

5-2-4-2. 返金処理のテストパターン
決済処理時に設定した金額の下 2 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-5 d 払い決済
5-2-5-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “1“, “2“, “3“, “4“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“5“, “6“, “8“のいずれかの場合

処理失敗

5-2-5-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“3“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-6 PayPay 決済
5-2-6-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “2“, “6“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“1“, “3“, “4“, “5“, “8“のいずれかの場合

処理失敗

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

38

mPOS アプリ連携開発ガイド（Android 版）

5-2-6-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“6“, “9“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-7 au PAY 決済
5-2-7-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “1“, “2“, “3“, “4“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“5“, “6“, “8“のいずれかの場合

処理失敗

5-2-7-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“3“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-8 メルペイ決済
5-2-8-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “2“, “6“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“1“, “3“, “4“, “5“, “8“のいずれかの場合

処理失敗

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

39

mPOS アプリ連携開発ガイド（Android 版）

5-2-8-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“6“, “9“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-9 楽天ペイ決済
5-2-9-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “7“, “9“のいずれかの場合

処理成功

金額の下１桁が“1“, “2“, “3“, “4“, “5“, “6“, “8“のいずれかの場合

処理失敗

5-2-9-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“7“, “9“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-10 J-Coin Pay 決済
5-2-10-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “1“, “9“のいずれかの場合

処理成功

金額の下１桁が“2“, “3“, “4“, “5“, “6“, “7“, “8“のいずれかの場合

処理失敗

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

40

mPOS アプリ連携開発ガイド（Android 版）

5-2-10-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“1“, “9“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-11 UnionPay QR コード決済
5-2-11-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “1“, “4“, “5“, “9“のいずれかの場合

処理成功

金額の下１桁が“2“, “3“, “6“, “7“, “8“のいずれかの場合

処理失敗

5-2-11-2. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が“4“, “5“の場合

処理失敗

金額の下 2 桁が“20“の場合

処理失敗

上記以外の場合

処理成功

5-2-12 Smart Code 決済
5-2-12-1. 決済処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が”0”, “1”, “9”のいずれかの場合

処理成功

金額の下１桁が”2”, “3”, “4”, “5”, “6”, “7”, “8”のいずれかの場合

処理失敗

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

41

mPOS アプリ連携開発ガイド（Android 版）

5-2-12-1. 返金処理のテストパターン
決済処理時に設定した金額の下 1 桁もしくは 2 桁の値により処理の成否が決定されます。成否の条件については次の表の
通りです。

条件

成否

金額の下 1 桁が”1”, “9”の場合

処理失敗

金額の下 2 桁が”20”の場合

処理失敗

上記以外の場合

処理成功

5-3 マイル積算系のテストパターン
マイル積算系（ANA マイル積算、ユナイテッド航空マイル積算、その他マイル積算）のテストを行う場合のテストパターンは以下の通りです。

5-3-1 マイル積算処理のテストパターン
金額の下 1 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下１桁が“0“, “3“, “4“, “5“, “6“, “7“, “8“, “9“のいずれかの場合

処理成功

金額の下１桁が“1“, “2“のいずれかの場合

処理失敗

5-3-2 マイル積算取消処理のテストパターン
マイル積算処理時に設定した金額の下 2 桁の値により処理の成否が決定されます。成否の条件については次の表の通りです。

条件

成否

金額の下 2 桁が“20“, “30“, “40“のいずれかの場合

処理失敗

上記以外の場合

処理成功

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

42

mPOS アプリ連携開発ガイド（Android 版）

補足事項
6-1 mPOS アプリの設定について
mPOS アプリの設定については、アプリ連携にて設定することができません。そのため、アプリ連携を行う前に直接 mPOS アプ
リを起動して、mPOS アプリの設定画面から各種設定を行ってください。

[設定項目の一例]
・

言語の設定

・

カードリーダーの設定

・プリンターの設定

・

マイル積算の設定

6-2 自動取消・返金について取引が与信もしくは仮売上の状態で一定時間経過すると mPOS 決済サーバーにて自動で取消処理、もしくは返金処理が実施され、対象の取引が取消・返金されます。

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

43

mPOS アプリ連携開発ガイド（Android 版）

改訂履歴2016/05

Ver1.0.0 リリース

2017/05

Ver1.1.0 リリース
・「3-2-2 レスポンスパラメーター」- 成功時の“mPOS 取引 ID“を必須に更新。
- “JPO“に対する説明を修正。
・「3-3-2 レスポンスパラメーター」- 成功時の“結果コード“、“mPOS 取引 ID“を必須に更新。
・「3-4 エラーコード」：次のエラーコードを追加。
- 110, 111, 205, 404, 1007, 1008
・「4-1 サンプルプログラム動作要件」- 統合開発環境のバージョンを更新。
・「第 5 章 テストパターン」- 次の項を追記。それに伴い第 5 章の章立てを更新。
* 「5-1 クレジットカード決済処理を行う場合のテストパターン」* 「5-2 NFC 決済処理を行う場合のテストパターン」* 「5-3 Alipay 決済処理を行う場合のテストパターン」

2017/10

Ver1.1.1 リリース
・第１章の章名を更新。
・「2-5 決済機能概要」- “図 2 決済処理フロー“上の誤字を修正。

2018/05

Ver1.1.2 リリース
・「2-5 決済機能概要」- 画面名と画面に対する概要を修正。
・「4-1 サンプルプログラム動作要件」- 統合開発環境のバージョンを更新。

2018/10

Ver1.2.0 リリース
・WeChat Pay に関する記述を追加。
・「3-4 エラーコード」：次のエラーコードを追加。
- 112, 113
・「4-1 サンプルプログラム動作要件」- 統合開発環境のバージョンを更新。

2018/12

Ver1.2.1 リリース・金額（amount）の最大桁数を 8 桁に修正。
・「3-2-2 レスポンスパラメーター」

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

44

mPOS アプリ連携開発ガイド（Android 版）- 次のパラメーターを追加。
“description“
・「3-4 エラーコード」：次のエラーコードを追加・削除。
- 追加：207, 208, 998
2019/04

削除：9002, 9003, 9007

Ver1.3.0 リリース
・LINE Pay、d 払い、PayPay、ANA マイル積算に関する記述を追加。
・“description（説明）“の最大文字数を 40 文字に修正。
・“aosa（有効オフライン支出額）“に関する記述を削除。
・「3-4 エラーコード」- メッセージ欄を削除。
- 次のエラーコードを追加。
* 追加：114, 115, 116, 117, 206, 209, 210, 211, 507, 508, 509
・「第 5 章 テストパターン」- WeChat Pay 決済に関するテストパターンを更新。
- LINE Pay 決済に関するテストパターンを追加。
- d 払い決済に関するテストパターンを追加。
- PayPay 決済に関するテストパターンを追加。
- ANA マイル積算に関するテストパターンを追加。

2019/09

Ver1.4.0 リリース・取消機能・API に関する記述を追加。
・「3-2-1 リクエストパラメーター」- “amount（金額）“を任意項目に修正。
- “miles（マイル数）“の項目を追加。
- “timesMiles（マイル回数）“の項目を追加。
・「3-2-2 レスポンスパラメーター」- “paymentTime（取引日時）“の項目を追加。
- “amcNumber（AMC 番号）“の項目を追加。
・「3-5 エラーコード」- 次のエラーコードを追加。
* 追加：601, 602, 603, 604, 902, 903, 904, 905
・「4-1 サンプルプログラム動作要件」- 統合開発環境のバージョンを更新。
・「第 5 章 テストパターン」- 取消処理のテストパターンを追加。

2020/06

Ver1.5.0 リリース
・銀聯決済、ユナイテッド航空マイル積算に関する記述を追加。
・「3-2-2 レスポンスパラメーター」- 次のパラメーターを追加。

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

45

mPOS アプリ連携開発ガイド（Android 版）“orderReferenceId“, “tvr“, “tsi“, “txnCryptogram“, “centerTradeId“, “centerProcessId“,“cupRequestTime“, “mileageMembershipNo“- 次のパラメーターを削除。
“amcNumber“
・「3-4-2 レスポンスパラメーター」- 次のパラメーターを追加。
“centerProcessId“, “cupRequestTime“・「3-5 エラーコード」- 次のエラーコードを追加。
* 追加：510, 906, 9008, 9009, 9010
・「4-1 サンプルプログラム動作要件」- 動作 OS を Android 5.0 以上に更新。
- 統合開発環境のバージョンを更新。
・「第 5 章 テストパターン」- “5-1-4 新韓カード使用の場合“を追加。
- “5-3 銀聯決済処理のテストパターン“を追加。
- “5-11 ユナイテッド航空マイル積算処理のテストパターン“を追加。
- “5-13-3 ユナイテッド航空マイル積算取消処理のテストパターン“を追加。
・「6-1 mPOS アプリの設定について」- 言語、カードリーダー、プリンターに関する節を統合。
・「6-2 自動取消・返金について」を追加。
2021/06

Ver1.6.0 リリース
・商号変更に伴う内容の更新。
・コード決済、その他マイル積算に関する記述を追加。
・「3-2-2 レスポンスパラメーター」- 次のパラメーターを追加。
“paymentSource“, “discountAmount“, “totalAmount“, “cardNumber“, “cardNumberToken“, “cardExpiry“,“authCode“, “acquirerCode“, “centerAcquirerId“, “centerReferenceCode“, “centerTransactionType“,“centerTransactionDatetime“, “centerTerminalId“, “centerMerchantId“, “centerMerchantName“,“cvmType“, “usageType“, “lastUseDate“
・「3-4-2 レスポンスパラメーター」- 次のパラメーターを追加。
“centerAcquirerId“, “centerTradeId“, “centerReferenceCode“, “centerTransactionType“,“centerTransactionDatetime“, “centerRefundDatetime“, “centerTerminalId“, “centerMerchantId“,“centerMerchantName“・「3-5 決済方法コード」を追加。
・「3-6 支払手段」を追加。
・「3-7 支払種別」を追加。

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

46

mPOS アプリ連携開発ガイド（Android 版）

・「3-8 カード所有者検証方法タイプ」を追加。
・「3-9 エラーコード」- 次のエラーコードを追加。
* 追加：118, 119, 120, 121, 997
・「4-1 サンプルプログラム動作要件」- 統合開発環境のバージョンを更新。
・「第 5 章 テストパターン」- 章立てを見直し。
- Alipay, WeChat Pay, LINE Pay, d 払い, PayPay のテストパターンを更新。
- Alipay+, au PAY, メルペイ, 楽天ペイ, J-Coin Pay, UnionPay QR コードのテストパターンを追加。
2021/10

Ver1.7.0 リリース
・「3-5 決済方法コード」を追加。
“Smart Code 決済”を追加。
・「3-6 支払手段」を追加。
- 次の値を追加。
GINKOUPAY, KPLUS, EPOSPAY, PRING, ATONE, AFTEE, PREMOCODE, MYJCBPAY, ANAPAY,
FAMIPAY, LALAPAY, PAIDY・「3-9 エラーコード」- 次のエラーコードを追加。
* 追加：122, 123, 124
・「4-1 サンプルプログラム動作要件」- 統合開発環境のバージョンを更新。
・「第 5 章 テストパターン」- Smart Code 決済に関するテストパターンを追加。

2022/11

Ver1.7.1
・「2-3 mPOS アプリ連携仕様」- マニフェストファイルの設定についての記述を追加。
・「4-1 サンプルプログラム動作要件」- 統合開発環境のバージョンを更新。
・誤字を修正。

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

47