【りそな口座振替】WEB方式の概要と利用方法（REST API連携向け）

「りそな口座振替 WEB方式」は、貴社ご利用者様が、WEB画面上で口座振替の登録手続きを行えるサービスです。
従来の紙の口座振替依頼書による手続きが不要となり、ペーパーレスで口座情報の登録・確認が可能になります。

 

■重要：ご利用の前提

本記事は、REST APIによるシステム連携をご利用の加盟店様向けのご案内です。
なお、本機能をご利用いただくにあたり、口座情報登録後に遷移する「戻り先URL」および「キックバック通知先URL」の設定が必須となります。

１．管理画面にログインし、上部メニューの「設定」をクリックします。
２．表示されるタブの中から「決済システム」を選択します。
３．画面内に表示されている「PC用決済フォーム設定」枠内の「りそな口座振替決済完了後転送先URL」に加盟店様指定のURLを入力します。

 

■利用フロー

本機能は「リンク方式（GETリクエスト）」にて提供しており、加盟店様にて作成したHTMLリンクをWebサイトに設置することでご利用可能です。
貴社ご利用者様は、以下の流れで口座情報の登録手続きを行います。

１．口座振替の選択
加盟店様のWebサイトのリンクから、口座振替の申し込み画面へアクセスします。
２．金融機関の選択・認証
各金融機関のインターネットバンキングや、本人認証画面へリダイレクト（画面遷移）します。
貴社ご利用者様は、ご利用される金融機関のサイト上で、暗証番号などの認証を行い口座振替契約を承認します。
３．加盟店サイトへ戻る
手続き完了後、加盟店様が指定した画面（りそな口座振替決済完了後転送先URL）へ遷移します。

 

■パラメータ一覧

利用可能なパラメータは以下の通りです。

●インターフェース

接続先https://api.j-payment.co.jp/v1.0/account_transfer/bank_accont/create
メソッドGET

●リクエスト

項目名キー名型必須桁数説明
店舗IDaid半角数字〇6サブスクペイの契約時に発行された店舗ID
顧客番号cid半角数字〇10顧客ごとに発行される一意の番号
口座名義anm全角・半角英数カナ（大文字のみ）※1〇30バイト以下口座名義

※1：ｧ ｨ ｩ ｪ ｫ ｯ ｬ ｭ ｮ ｰ ｦは使用できません。

●キックバック

項目名キー名型桁数説明
顧客番号cid半角数字10顧客ごとに発行される一意の番号
Web口座登録状態regst半角数字1

Web口座振替の登録ステータス

0：対象外
1：処理中
2：登録完了
3：金融機関失敗
4：口振受付GW失敗
5：未登録

エラーコードec半角英数字-エラー発生時のエラーコード
詳細はエラーコード一覧をご覧ください。
電話番号pn半角数字-電話番号
Eメールアドレスem半角英数-Eメールアドレス
金融機関コードbac半角数字4金融機関コード
金融機関名bnm全角-金融機関コードの金融機関名
支店コードbrc半角数字3

支店コード

ゆうちょ銀行は記号の先頭1と末尾0を除いた3桁が返却されます。

支店名bonm全角-支店コードの支店名
口座名義anm半角カナ-口座名義
預金種目atype定型1

預金種目

0：種別なし
1：普通預金
2：当座預金

口座番号anum半角数字7

口座番号

ゆうちょ銀行は番号の末尾1を除いた7桁が返却されます。

請求番号reqid半角数字-請求ごとに発行される一意の番号
商品金額am半角数字-商品金額
税額tx半角数字-税額
送料sf半角数字-送料
商品コードiid2半角英数記号50バイト以下商品コード
商品名inm全角半角-商品名
次回振替年月日atdate定型6次回口座振替日
yyyyMM
省略時は次月が適用されます。
動作タイプtype半角数字1口座振替の動作タイプ
1：単発
2：連続
3：従量
省略時は1：単発が適用されます。
回数指定nt半角数字1口座振替の回数
店舗オーダー番号cod半角英数50バイト以下任意で設定できる管理用の値
状態stat定型1請求情報の有効ステータス
0：無効
1：有効
指定した次回振替年月の請求データ登録締切日が過ぎていた場合は、0：無効が適用されます。
その他データ-全角・半角英数1024バイト以下任意の値を設定可能な予備項目

 

■HTMLコード サンプル

<FORM ACTION="https://api.j-payment.co.jp/v1.0/account_transfer/bank_accont/create" METHOD="GET">
  <INPUT TYPE="HIDDEN" NAME="aid" VALUE="店舗ID">
  <INPUT TYPE="HIDDEN" NAME="cid" VALUE="顧客番号">
  <INPUT TYPE="HIDDEN" NAME="anm" VALUE="口座名義">
  <INPUT TYPE="submit" NAME="submit" VALUE="Web口座振替申込">
</FORM>

 

 

Powered by Zendesk