VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

VeriTrans4G インターフェース詳細～銀聯ネット決済（UPOP）～
Ver. 1.0.3 （2023 年 02 月～）

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

1

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

目次
第1章

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

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

第2章

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

2-1 共通 ......................................................................................................................................................................................................................................................................6
2-2 与信 ......................................................................................................................................................................................................................................................................7
2.2.1 要求電文：UpopAuthorizeRequestDto ..................................................................................................................................................................................................................................... 7
2.2.2 応答電文：UpopAuthorizeResponseDto ................................................................................................................................................................................................................................... 7

2-3 結果リダイレクト .....................................................................................................................................................................................................................................................92.3.1 リダイレクト受信内容：決済サーバーから消費者ブラウザ経由で店舗へリダイレクト(POST)される内容 ............................................................................................................................................ 92-4 売上 .................................................................................................................................................................................................................................................................... 10
2.4.1 要求電文：UpopCaptureRequestDto .......................................................................................................................................................................................................................................10
2.4.2 応答電文：UpopCaptureResponseDto .....................................................................................................................................................................................................................................102-5 キャンセル ........................................................................................................................................................................................................................................................... 122.5.1 要求電文：UpopCancelRequestDto .........................................................................................................................................................................................................................................122.5.2 応答電文：UpopCancelResponseDto .......................................................................................................................................................................................................................................122-6 返金 .................................................................................................................................................................................................................................................................... 14
2.6.1 要求電文：UpopRefundRequestDto ........................................................................................................................................................................................................................................142.6.2 応答電文：UpopRefundResponseDto ......................................................................................................................................................................................................................................142-7 結果通知............................................................................................................................................................................................................................................................. 16

第3章

その他 補足事項 .............................................................................................................................................................................................................. 18
2

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～
3-1 注意事項............................................................................................................................................................................................................................................................. 18
3.1.1 清算通貨および清算レートについて ...........................................................................................................................................................................................................................................18
3.1.2 支払い期限について .................................................................................................................................................................................................................................................................18
3.1.3 与信・売上について...................................................................................................................................................................................................................................................................183

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

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

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

1-3 改訂履歴
2017/04 ：Ver1.0.0 リリース
※ 以下、「VeriTrans3G インターフェース詳細 ～銀聯ネット決済（UPOP）～」 Ver 2.0.4 からの更新分を記載します。
2.2.1 リダイレクト受信内容：VeriTrans3G から消費者ブラウザ経由で店舗へリダイレクト(POST)される内容 に、「upopOrderId（決済センターとの取引 ID）を追加
2.2.2 応答電文：UpopAuthorizeResponseDto の entryForm の説明を追加 2.3.2 応答電文：UpopCaptureResponseDto に、「upopOrderId（決済センターとの取引 ID）を追加
2.4.2 応答電文：UpopCancelResponseDto に、「upopOrderId（決済センターとの取引 ID）を追加
2-5 銀聯ネット決済（UPOP）返金 に、以下の説明を追加「ただし、Capture（売上）を実施した当日は、Cancel（キャンセル）を利用してください。（売上当日に返金処理を行った場合、失敗する可能性があります。）」
4VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～
2.5.2 応答電文：UpopRefundResponseDto に、「upopOrderId（決済センターとの取引 ID）を追加
2.6 結果通知（銀聯ネット決済（UPOP）） に、「vResultCode(詳細結果コード）」と「upopOrderId（決済センターとの取引 ID）を追加
2017/12 ：Ver1.0.1 リリース
章タイトルから「銀聯ネット決済（UPOP）」という表現を削除（冗長さの排除）
2-6 返金 に、返金が可能な期間を追記
3-1 「銀聯ネット決済（UPOP）画面概要」を削除し、「3-2 注意事項」を 3-1 に繰り上げ
3-1 注意事項 の章立てを次のように変更（既存の説明は 3.1.1 とし、新たに 3.1.2、3.1.3 を追加）
3.1.1 清算通貨および清算レートについて
3.1.2 支払期限について
3.1.3 与信・売上について
2018/01 ：Ver1.0.2 リリース
2-7 「結果通知」の「通知件数」の「説明」を修正（1 度に通知可能な件数を 1,000 件から 100 件に変更）
2023/02 ：Ver1.0.3 リリース
2-7 結果通知 項目の並び順について追記

5

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

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

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

任意項目：△

設定不可：×

応答電文 … 必ず返戻：○

処理成功時のみ返戻：△

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

返戻なし：×

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

6

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

2-2 与信2.2.1 要求電文：UpopAuthorizeRequestDto
要求電文：UpopAuthorizeRequestDto
フィールド名

項目名

書式・制限

説明

orderId

取引 ID

半角英数字100桁以内

上記「orderId（取引 ID）について」参照

amount

決済金額

半角数字 12 桁以内

決済金額（日本円）

設定○○

1 以上 999,999,999,999 以下
withCapture

売上フラグ

右記参照

△

"true"： 与信・売上"false"： 与信のみ
※ 指定が無い場合は、デフォルト値（与信のみ）が指定されます。

termUrl

決済結果戻り先 URL

URL に使える文字 256 桁以内

決済完了後に、店舗側へ遷移を戻すための URL を指定

customerIp

消費者 IP アドレス

IP の使える文字 40 桁以内

消費者側の IP アドレスを指定（例：111.111.111.111）○○※IPV6 の形式も対応しています。

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

項目名

書式・制限

serviceType

サービスタイプ

右記参照

mstatus

処理結果コード

半角英数字 32 文字以内

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

設定○"upop""success" ： 正常終了
"failure"vResultCode

詳細結果コード

半角英数 16 桁○： 異常終了

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

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

エラーメッセージ

文字列 300 桁以内

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

custTxn

トランザクション ID(取文字列100桁以内

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

文字列 100 桁以内

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

電文 ID

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

取引 ID

半角英数字 100 桁以内

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

txnVersion

MDK バージョン

文字列 5 桁

電文のバージョン○○問題発生時などに用いますが、通常ご利用になることはありません。
7VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

応答電文：UpopAuthorizeResponseDto
フィールド名entryForm

項目名
UPOP リダイレクト用
HTML フォーム文字列

書式・制限
文字列 4096 桁以内

説明
銀聯へリダイレクトするための HTML設定△

この文字列は URL エンコードされています。
銀聯の画面に自動遷移するための JavaScript を含みますので、URL デコード後の文字列をそのまま消費者のブラウザに返戻してください。返戻するコンテンツの文字コードは UTF-8 として返戻する必要があります。

8

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

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

項目名

書式・制限

serviceType

サービスタイプ

右記参照

authInfo

認証情報

右記参照

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

設定○"upop"
受信データが自店舗のデータかどうかを検証するための文字列。

○(弊社から提供するサンプルに当文字列による店舗認証の方法が入っていますので参照してください)
mstatus

処理結果コード

半角英数字 32 文字以内

"success" ： 正常終了
"failure"○： 異常終了"pending" ： 保留状態
vResultCode

詳細結果コード

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

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

エラーメッセージ

文字列 300 桁以内

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

custTxn

トランザクション ID(取文字列100桁以内

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

引毎につける ID)
orderId

取引 ID

半角英数字 100 桁以内

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

txnDatetimeJp

決済時刻（日本時間）

半角数字 14 桁固定

決済日時（日本時間） YYYYMMDDhhmmss の形式

txnDatetimeCn

決済時刻（中国時間）

半角数字 14 桁固定

capturedAmount

元売上金額

半角数字 12 桁以内

元売上金額

settleAmount

清算金額

半角数字 12 桁以内清算金額

settleDate

清算日付

右記参照

清算日付 MMDD の形式 （例 0927）

settleCurrency

清算通貨種類

半角数字 3 桁

清算通貨種類settleRate

清算レート

半角数字 8 桁○△（例 20130728181905）
決済日時（中国時間） YYYYMMDDhhmmss の形式△（例 20130728171905）

△
△
△
△

392：日本円（固定）
清算レート

△

※清算レートの仕様は、「3-1 注意事項」の 2)を参照。
upopOrderId

決済センターとの取引
ID

半角英数字 20 桁以内

決済サーバーが、決済センター向けに発番する ID※※拡張項目のため、ご利用の際には弊社までお問い合わせください。

9VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

2-4 売上2.4.1 要求電文：UpopCaptureRequestDto
要求電文：UpopCaptureRequestDto
フィールド名項目名書式・制限

説明

orderId

取引 ID

半角英数字 100 桁以内

決済請求、与信完了時に採番した取引ID

amount

決済金額

数字 12 桁以内

決済金額（日本円）

設定○○

与信時に設定した金額以下、かつ 1 以上 999,999,999,999 以下

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

項目名
サービスタイプ

書式・制限
右記参照

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

設定○"upop"
mstatus

処理結果コード

半角英数字 32 文字以内

"success" ： 正常終了
"failure"○： 異常終了"pending" ： 保留状態
vResultCode

詳細結果コード

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

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

エラーメッセージ文字列 300 桁以内

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

custTxn

トランザクション ID(取文字列100桁以内

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

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

電文 ID

文字列 100 桁以内

orderId

取引 ID

半角英数字 100 桁以内

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

txnVersion

MDK バージョン

文字列 5 桁

電文のバージョン

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

○○

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

決済時刻（日本時間）

半角数字 14 桁固定

決済日時（日本時間） YYYYMMDDhhmmss の形式△（例 20130728181905）
txnDatetimeCn

決済時刻（中国時間）

半角数字 14 桁固定

capturedAmount

売上金額

半角数字 12 桁以内

決済日時（中国時間） YYYYMMDDhhmmss の形式△（例 20090728171905）
売上金額

△
10

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

応答電文：UpopCaptureResponseDto
フィールド名

項目名

書式・制限

説明

remainingAmount

返品後の金額

半角数字 12 桁以内

通常ご利用になることはありません。

settleAmount

清算金額

半角数字 12 桁以内

清算金額

settleDate

清算日付

右記参照

清算日付 MMDD の形式（例 0927）

settleCurrency

清算通貨種類

半角数字 3 桁

清算通貨種類設定△△△△

392：日本円（固定）settleRate

清算レート

半角数字 8 桁

清算レート△※清算レートの仕様は、「3-1 注意事項」の 2)を参照。
upopOrderId

決済センターとの取引
ID

半角英数字 20 桁以内

決済サーバーが、決済センター向けに発番する ID※※拡張項目のため、ご利用の際には弊社までお問い合わせください。

11VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

2-5 キャンセル
2.5.1 要求電文：UpopCancelRequestDto
要求電文：UpopCancelRequestDto
フィールド名orderId

項目名
取引 ID

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

説明

設定

○

決済請求、与信・売上完了時に採番した取引ID

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

項目名
サービスタイプ

書式・制限
右記参照

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

設定○"upop"
mstatus

処理結果コード

半角英数字 32 文字以内

"success" ： 正常終了
"failure"○： 異常終了"pending" ： 保留状態
vResultCode

詳細結果コード

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

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

エラーメッセージ

文字列 300 桁以内

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

custTxn

トランザクション ID(取文字列 100 桁以内

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

文字列 100 桁以内

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

引毎につける ID)
marchTxn

電文 ID

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

取引 ID

半角英数字 100 桁以内

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

txnVersion

MDK バージョン

文字列 5 桁

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

決済時刻（日本時

半角数字 14 桁固定間）
txnDatetimeCn

決済時刻（中国時

決済日時（日本時間） YYYYMMDDhhmmss の形式△（例 20130728181905）
半角数字 14 桁固定間）

決済日時（中国時間） YYYYMMDDhhmmss の形式△（例 20130728171905）

capturedAmount

元売上金額

半角数字 12 桁以内

remainingAmount

返品後の金額

半角数字 12 桁以内

与信（売上は未実行の場合）に対するキャンセルの場合： "0"△

与信（売上同時）、与信後の売上に対するキャンセルの場合： 売上金額
返品後の金額△12

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

応答電文：UpopCancelResponseDto
フィールド名

項目名

書式・制限

説明設定

settleAmount

清算金額

半角数字 12 桁以内

清算金額

settleDate

清算日付

右記参照

清算日付 MMDD の形式（例 0927）△△settleCurrency

清算通貨種類

半角数字 3 桁

清算通貨種類△392：日本円（固定）settleRate

清算レート

半角数字 8 桁

清算レート△※清算レートの仕様は、「3-1 注意事項」の 2)を参照。
upopOrderId

決済センターとの取引 ID

半角英数字 20 桁以内

決済サーバーが、決済センター向けに発番する ID※※拡張項目のため、ご利用の際には弊社までお問い合わせください。

13

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

2-6 返金与信後に Capture（売上）を実施した取引については、Refund（返金）が可能です。
ただし、Capture（売上）を実施した当日は、Cancel（キャンセル）を利用してください。（売上当日に返金処理を行った場合、失敗する可能性があります。）
返金が可能な期間は、売上実施日から 180 日間となります。※与信時の売上フラグが"true"（与信・売上）の場合には、申込みが成立した日から 180 日間となります。

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

項目名

書式・制限

説明

orderId

取引 ID

半角英数字 100 桁以内

決済請求、売上完了時に採番した取引ID

amount

決済金額

半角数字 12 桁以内

返金金額（日本円）

設定○○※一部キャンセルも可能

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

項目名
サービスタイプ

書式・制限
右記参照

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

設定○"upop"
mstatus

処理結果コード

半角英数字 32 文字以内

"success" ： 正常終了
"failure"○： 異常終了"pending" ： 保留状態
vResultCode

詳細結果コード

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

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

エラーメッセージ

文字列 300 桁以内

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

custTxn

トランザクション ID(取文字列 100 桁以内

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

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

引毎につける ID)
marchTxn

電文 ID

文字列 100 桁以内

orderId

取引 ID

半角英数字 100 桁以内

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

txnVersion

MDK バージョン

文字列 5 桁

電文のバージョン

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

○○

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

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

応答電文：UpopRefundResponseDto
フィールド名
txnDatetimeJp

項目名
決済時刻（日本時間）

書式・制限半角数字 14 桁固定

説明
決済日時（日本時間） YYYYMMDDhhmmss の形式

設定△（例 20130728181905）
txnDatetimeCn

決済時刻（中国時間）

半角数字 14 桁固定

決済日時（中国時間） YYYYMMDDhhmmss の形式△（例 20090728171905）
capturedAmount

元売上金額

半角数字 12 桁以内

与信（売上同時）、与信後の売上に対する返金の場合の元売上金額

remainingAmount

返品後の金額

半角数字 12 桁以内

返品後の金額settleAmount

清算金額

半角数字 12 桁以内

清算金額

settleDate

清算日付

右記参照

清算日付 MMDD の形式 （例 0927）

settleCurrency

清算通貨種類

半角数字 3 桁

清算通貨種類△△△△△392：日本円（固定）settleRate

清算レート

半角数字 8 桁

清算レート△※清算レートの仕様は、「3-1 注意事項」の 2)を参照。
upopOrderId

決済センターとの取引 ID

半角英数字 20 桁以内

決済サーバーが、決済センター向けに発番する ID※※拡張項目のため、ご利用の際には弊社までお問い合わせください。

15

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

2-7 結果通知
銀聯ネット決済（UPOP）では、与信、売上、キャンセル、返金それぞれの処理について、店舗様へ結果通知を送信します。

下表に、電文項目の詳細を示します。
結果通知に関するサービス共通の仕様については、『開発ガイド』を併せてご参照ください。
項番1

フィールド名numberOfNotify

項目名
通知件数

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

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

2

pushTime

送信時刻

半角数字 14 桁

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

3

pushId

識別 ID

半角数字 8 桁

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

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

取引 ID

半角英数字 100 桁以内

取引 ID

5txnType

サービスコマンド

半角英数字 20 桁以内"Authorize", "Capture" , "Refund", "Cancel"

右記参照※与信／与信同時売上の場合は"Authorize"が、与信後売上の場合は"Capture"が返戻されます。

6mstatus

処理結果コード

半角英数字 32 文字以内

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

7

traceNumber

システム追跡番号

半角数字6桁UPOP より発行されるシステム追跡番号8

traceTime

認証サービス日時

半角数字 10 桁固定

MMDDhhmmss形式（中国時間）

9settleAmount

清算金額

半角数字 12 桁以内

清算金額

10

settleDate

清算日付

半角数字 4 桁

清算日付 MMDD の形式 （例 0927）

11

settleRate

清算レート

半角数字 8 桁（予約項目）

12

dummy

ダミー決済フラグ

半角数字1桁ダミー取引の場合："1"、本番取引場合："0"13vResultCode

詳細結果コード

文字列16桁処理結果を詳細に表すコード（例 0928171905）

詳細は『結果コード一覧』を参照下さい。
※拡張項目のため、ご利用の際には弊社までお問い合わせください。
14

upopOrderId

決済センターとの取引ID

半角英数字20桁以内

決済サーバーが、決済センター向けに発番するID※拡張項目のため、ご利用の際には弊社までお問い合わせください。

16

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～（注意事項）


通常、各種決済の成功・失敗のステータス判明後の 5 分以内に店舗様へ結果通知を送信しますが、一部の特殊取引（ネットワーク通信問題などによって、銀聯側のステータスが判断できないもの等）については、翌日に行われる銀聯センターと決済サーバーとのマッチング処理にてステータスが判明しますので、翌日以降に結果通知が送信される場合があります。

通常ケースでは、結果通知の送信は 1 回だけ行われますが、取引の翌日に銀聯から受信した清算データと、決済サーバー側の取引データとの突合処理によって差異が判明した場合は、結果通知を再度送信する場合があります。

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

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

17

VeriTrans4G インターフェース詳細 ～銀聯ネット決済（UPOP）～

第3章 その他 補足事項
3-1 注意事項
3.1.1 清算通貨および清算レートについて
1)

各 I/F で返却している「清算通貨」は、392（JPY）固定となります。そのため、消費者への中国元での請求については、消費者自身で銀聯（UPOP）側のサイトで確認する必要があります。
また、為替レートが事前に取得する仕組みが提供されていないため、中国元の金額は銀聯（UPOP）のサイトにリダイレクトした後に分かります。

2)

各 I/F の「清算レート」の仕様は、以下のとおりです。
1 桁目：小数の桁数
2～8 桁目：実際の清算レート例） 「30001000」の場合、小数の桁数が"3"となっているため清算レートは「1.000」になります。

3.1.2 支払い期限について
消費者の支払い期限は、UPOP の決済画面に遷移してから 30 分です。30 分を超えて支払いを行うと、UPOP 側でエラーとなります。

3.1.3 与信・売上について
1)

銀聯カードはクレジットカードよりデビットカードとしての発行枚数が多いため、与信のみの場合、失敗する可能性があります。与信同時売上の実装をご検討ください。

2)

銀聯カードの与信有効期限は 30 日です。与信有効期限内であってもイシュアの運用によっては売上エラーになる場合があります。その場合には弊社にて売上処理を行いますが、処理を行うにあたっては利用契約に則り、取引に関する必要書類をご提出頂く必要があります。

18