本ガイドの内容

本ガイドは、株式会社DGフィナンシャルテクノロジーが提供するVeriTrans4GのBankPayサービス(※1)をインターネット店舗等に導入するための、開発者向けのガイドです。

※1）　Pay-easy（ペイジー）とは別の決済サービスとなりますので、間違えのないようご注意ください。

BankPayサービスの概要

BankPayサービスは、事前に銀行の口座情報を登録し、登録した口座情報を用いて決済を行うサービスです。

• 口座情報の登録は、銀行毎のページにリダイレクトして実施します。
• 口座情報を登録することで、決済の度に口座情報を入力する必要がなくなります。
• 口座登録なしで決済のみの実施はできません。

課金種別（都度決済、随時決済、チャージ）

BankPayサービスにおいて、課金種別は「都度決済」・「随時決済」・「チャージ」で区別されます。

【共通】

1. 事前に会員登録, 口座登録を実施しておき、決済は加盟店からリクエストする必要があります

   ※随時決済の場合でも自動で決済は行われず、加盟店からリクエストする必要があります。

2. 登録した会員・口座情報はすべての課金種別で利用可能です。
3. 一度登録した会員・口座情報は、基本的に削除するまでは繰り返し決済にご利用いただけます。

【都度決済機能】

加盟店が提供する商品もしくはサービスを購入する毎に、口座引落を行う決済が該当します。

【随時決済機能】

加盟店と消費者が事前に取り決めた条件(金額や日時等)にのっとり、利用者による購入手続きなく口座引き落としを行う決済が該当します。

【チャージ】

BankPayでは、チャージの類型を前払式支払手段（ハウス）／前払式支払手段（オープン）／資金移動の３つとし、定義は以下の通りとなっています。
（前払式支払手段と資金移動の区分は資金決済に関する法律の例によります）

1. チャージ(ハウス)：
   1. バリュー提供者自身またはバリュー提供者自身と資本関係のあるグループ会社のサービス対価としてのみ利用可能なバリューチャージ
   2. バリュー提供者と提携する特定一社または当該特定一社と資本関係のあるグループ会社のサービス対価としてのみ利用可能なバリューチャージ

   （例：電子マネーの発行者＝バリュー提供者）

2. チャージ(オープン)：
   チャージ（ハウス）に該当しない前払式支払手段の取引
   （例：バリュー提供者と提携する複数の提携先のサービス対価として利用可能なバリューへのチャージ取引）
3. チャージ(資金移動)：
   資金移動者へのチャージであり、チャージしたバリューは提携先のすべての加盟店で利用可能かつ現金として引き出したり、別のサービスの会員に送金することが可能。

機能一覧（決済要求コマンド）

使用可能な決済要求コマンドを下記表に示します。

決済処理シーケンス

【決済申込処理】

【返金処理】

【会員登録処理】

【会員情報更新処理】

【会員削除処理】

【口座登録処理】

【口座削除処理】

【口座照会処理】

結果通知受信処理の対象

BankPayの結果通知受信処理の対象は以下の機能です。

※1) 口座照会の対象の会員IDにおいて、登録中の口座が存在していた場合は登録結果を確認し、登録結果が確定した場合は口座登録と同様に結果通知を送信します。

通信電文仕様（共通部）および店舗様受信後応答仕様は、『開発ガイド』をご参照ください。
BankPay固有の通知電文インターフェイスにつきましては、「5-3 結果通知電文」の「5.3.2 BankPayの結果通知電文」をご参照ください。

BankPay

共通

結果通知電文

会員登録での遷移について

<form method="post" action="https://example.com/hogehoge">
    <input type="hidden" name="bankCode" value="0000">
    <input type="hidden" name="branchCode" value="001">
    <input type="hidden" name="depositType" value="1">
    <input type="hidden" name="accountNum" value="1234567">
    <input type="hidden" name="accountName" value="テストタロウ">
    <input type="hidden" name="accountLabel" value="test">
    <input type="hidden" name="backURL" value="https://example.com/fugafuga">
    <input type="hidden" name="cAccessToken" value="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx">
    <input type="hidden" name="processorAuthenticationKeyIndex" value="01">
    <input type="hidden" name="MAC" value="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx">
</form>

会員・口座の登録について

返金可能期間について

返金処理は決済申込を実施した当日中のみ可能です。
ただし、金融機関のサービス利用時間外などの理由により、当日中であってもエラーとなる可能性はございます。

検索（Search）に関する補足（詳細コマンドタイプ/詳細オーダー決済状態）

決済サーバーでは、システム内部データとして詳細コマンド（処理要求の種類）と詳細な決済状態（その取引がどのような状態にあるか）を管理しています。
通常の運用では、店舗様システムではこれらの内部情報を利用する必要はありませんが、店舗様システムにおいて取引の状態検索が必要なケースや、障害等のお問い合わせ時の参照情報として、これらの内部データをSearchコマンドで公開しています。
下表にSearchコマンドにて利用可能な内部データの一覧を示します。

注） 一覧に記載していないコマンドタイプと状態も存在します。

使用可能文字

BankPayで使用可能な文字を以下の表の通りです。

氏名(userName)、カナ氏名(userNameKana)、住所(address)、摘要(remarks)

口座名義人(accountName)

※口座名義人について、銀行毎の使用不可の文字は以下の表の通りです（2022/12/16時点）
今後BankPayに対応した銀行については、上記の表に記載があっても使用不可の可能性がございますので、ご注意ください。

口座登録時の画面遷移をシミュレートする

弊社では、BankPayのテストのための疑似環境を提供しております。 ダミー取引で「6.1.3 BankPayへの遷移処理」を実施すると、口座登録の認証画面のイメージが表示されます。

口座登録の認証画面からの遷移先の対応表を以下に記載します。

Authorie, Refundコマンドのエラーをシミュレートする

Authorize、Refundコマンドの要求金額（"amount"）の一の位の値を調整することで、意図的にエラーを発生させることができます。
（Refundコマンドで金額を指定しない場合は、対象取引の返金可能金額が要求金額に相当します。）
要求金額の下一桁と、返戻されるvResultCodeの対応表を以下に記載します。

会員系コマンドのエラーをシミュレートする

MemberAdd、MemberUpdate、MemberDeleteコマンドの会員ID（"memberId"）の末尾1文字の値を調整することで、意図的にエラーを発生させることができます。
会員IDの末尾1文字と、返戻されるvResultCodeの対応表を以下に記載します。

口座系コマンドのエラーをシミュレートする

PrepareAccountAdd、AccountAdd、AccountDelete、AccountGetコマンドの口座ID（"memberId"）の末尾1文字の値を調整することで、意図的にエラーを発生させることができます。
口座IDの末尾1文字と、返戻されるvResultCodeの対応表を以下に記載します。

※1 口座登録の認証画面への遷移については、「8-1 口座登録時の画面遷移をシミュレートする」を参照してください。

※2 口座照会コマンドで取得できる口座情報は、口座登録で入力した値ではなく固定値となります。

ダミー取引で登録した会員・口座情報のデータ保持期間について

ダミー取引にて登録した会員・口座情報のデータ保持期間は、取引データの保持期間と同様になります（会員登録をした日から算出）。