口座直結決済
概要
口座直結決済は、お客様の預金口座から即時に口座振替を行う決済サービスです。 決済を行うためには事前にご利用者様の口座を登録する必要があります。
- 決済金額の上限：
- eKYC導入加盟店様の場合：500,000円
- 二要素認証（SMS認証必須）導入加盟店様の場合：50,000円
※1会員の同じ口座に対する1日の利用上限金額です
※金融機関にてこの金額以下で制限されている場合もあります
- 決済金額の下限：1円
- 利用可能地域 / 通貨：日本 / JPY
- 返金 / 金額変更：可 / 不可
口座直結決済を始めるには
-
契約の確認・申込
ご利用には口座直結決済の契約が必要です。未契約の場合は営業担当へご連絡ください。 -
テスト環境での動作確認
テスト環境に関する情報はこちらを確認してください。 -
本番稼働開始
動作確認完了後、本番運用を開始します。テスト環境⇒本番環境への切り替えチェックリストはこちら
接続方式のサポート
| 接続方式 | サポート状況 | 関連リンク |
|---|---|---|
| OpenAPIタイプ | ✖ 非対応 | |
| プロトコルタイプ | ✔ 対応 | API仕様（idPass） API仕様（json） |
| リンクタイプ Plus | ✖ 非対応 |
口座直結決済の流れ
口座直結決済は2つのステップで成り立ちます。
ステップ1：口座登録
お客様が加盟店様サイトで口座登録を開始し、金融機関の画面で口座登録手続きを行います。
口座登録が完了すると、加盟店様はその口座情報を利用して決済を行うことができます。
詳細は口座登録を参照してください。
ステップ2：決済
加盟店様は登録が完了した口座に対して、任意のタイミングで決済を行うことができます。
詳細は決済を参照してください。
口座状態
口座登録に関する状態遷移は以下の通りです。
| 取引状態 | コード | 説明 |
|---|---|---|
| 未登録 | ENTRY | 口座登録依頼を行った状態 |
| 登録処理中 | START | 当サービスまたは金融機関の口座登録手続き画面に遷移した状態 |
| 登録完了 | REGISTER | 口座登録に成功し有効な状態 |
| 登録失敗 | FAIL | お客様の口座不備や認証誤りにより口座登録に失敗した状態 またはお客様が口座登録手続き中に操作を中止した状態 |
| 登録解除 | END | 口座登録が解除され決済ができない状態 |
取引状態
決済取引に関する状態遷移は以下の通りです。
| 取引状態 | コード | 説明 |
|---|---|---|
| 未決済 | UNPROCESSED | 取引登録を行った状態 |
| 決済成功 | CAPTURE | 口座振替が正常に完了した状態 |
| キャンセル | CANCEL | 決済をキャンセルした状態 |
返金
全額キャンセルのみ可能です。
キャンセル可能期間：決済実行当日の23:59:59まで
利用可能な金融機関
以下いずれかの方法で確認が可能です。
- ショップ管理画面にて確認する
ショップ管理画面 > 都度決済 > 口座直結決済 > 設定 - 利用可能金融機関照会API（
SearchAvailableBankDirect）APIにて取得する
金融機関コードや支店コード等の金融機関情報は金融機関コード・ロゴを参照してください。
口座登録
同一会員の登録制限
同一の会員IDに対して複数の口座を登録することはできません。
会員の口座が登録されている状態で再度口座登録を行った場合は口座変更の扱いとなり、
以前の口座は自動的に登録解除（END）となります。
同一口座の登録制限
同一のサイトIDにおいて登録済みの口座が再度登録された場合、
以前の口座は自動的に登録解除（END）となり、新規に登録された口座が有効になります。
例：
- 会員Aが口座①を登録（口座①は会員Aに紐づき登録完了（
REGISTER）状態）- 会員Bが同じ口座①を登録
- → 会員Aの口座①は自動的に登録解除され登録解除（
END）状態になる
→ 会員Bの口座①が登録完了（REGISTER）状態になる
横浜銀行、沖縄銀行、ゆうちょ銀行以外の金融機関では、以前の口座で決済した取引のキャンセルはできなくなります。
沖縄銀行の口座有効期間
沖縄銀行では、口座登録・最終決済日から90日が経過すると口座は自動的に無効になり、再登録が必要になります。
※初回決済以降は口座登録日に関わらず、最終決済日から90日が有効期間となります。
口座登録依頼のカナ氏名について
口座登録依頼（BankDirectRegist）APIでリクエストする口座名義人のカナ氏名は、
加盟店様サイトに登録済みのカナ氏名と一致させる必要があります。
- 加盟店様サイトに登録済みのカナ氏名を口座登録画面にプリセット（入力補助）する
- 登録済みのカナ氏名と口座名義人のカナ氏名の一致を確認する
等の実装を行ってください。
口座名義人（姓 カナ）、口座名義人（名 カナ）は以下の内容をご確認の上指定してください。
- ￥ ， ． （ ） ー － ／ ＊ 「 」 ＄ ＋ ＆ 全角スペース（ゆうちょ銀行以外）
- ￥ ， ． （ ） ー － ／「 」 全角スペース（ゆうちょ銀行）
- 横浜銀行、沖縄銀行、ゆうちょ銀行以外の金融機関では、29文字を超える口座名義は利用できません。
信用金庫の口座登録について
お客様が信用金庫の画面遷移後に選択した金融機関が、口座登録依頼（BankDirectRegist）APIでリクエストされた金融機関コードと異なる場合、口座登録は失敗します。この場合、エラーコードDI1000023が返却されます。
動作環境
口座登録画面ではWebViewの使用は推奨していません。
WebViewを使用した場合のエラー等については当社は責任を負いかねます。
非推奨の範囲は処理フロー（プロトコルタイプ） 画面遷移イメージを参照してください。
機種変更時の口座再登録
ネイティブアプリ利用の加盟店様は、お客様が端末の機種変更を行った場合、口座情報を旧端末から新端末へ自動で引き継がず、新端末にて再度口座登録を実施させてください。
決済
決済が可能になるタイミング
口座登録後、口座状態が「登録完了（REGISTER）」になった時点で決済が可能となります。
ただし、山梨中央銀行のみ、口座登録の翌営業日15時以降に決済が可能となります。
口座から引き落とされるタイミング
決済実行（ExecTranBankDirect）APIの実行と同時に、お客様の口座から即時引き落としが行われます。
リクエスト数について
バッチ処理等により決済実行（ExecTranBankDirect）APIまたは決済取消（BankDirectCancel）APIをまとめて実行する場合は、加盟店様単位でのAPIリクエスト実行数が最大5TPSを超えないようにしてください。
ロゴについて
対応している各金融機関のロゴは金融機関コード・ロゴから利用可能です。