ROBOT PAYMENT
キャリア決済接続仕様書
改訂履歴
2
項 番 改定日時 改訂者 対象 改訂内容 1 2015/11/17 中野 初版として作成 2 2018/12/10 梨本 Gateway接続方式追加目次
■概要
:キャリア決済 概要
:導入方法 概要
■都度課金
:必要なパラメータ 商品登録なし≪決済時≫
:必要なパラメータ 商品登録あり≪決済時≫
:サンプルソースコード
:キックバック通知
■自動課金
:必要なパラメータ ≪初回決済時≫
:サンプルソースコード
:自動課金停止URL
:自動課金情報更新URL
:キックバック通知 ≪初回決済時≫
:キックバック通知 ≪自動課金発生時≫
:キックバック通知 ≪自動課金停止時≫
:自動課金スケジュール①
:自動課金スケジュール②
■FLAVOR設定
:サービス情報登録
:検証環境利用登録
■その他
:FAQ
:エラーコード対応表①
:エラーコード対応表②
4
■本ドキュメントについて ・本ドキュメントは株式会社 ROBOT PAYMENTが提供する、キャリア決済サービスの 接続仕様書です。 ■おことわり ・本ドキュメントの内容は著作権で保護されており、本書の内容の一部または全部を当社の同意なし に複写、複製および転載することを禁止します。本書の内容は予告なしに随時更新されることがあ ります。本書の内容については万全を期しておりますが記入漏れ等お気づきの点がございましたら、 当社までご連絡下さい。概要
■概要 当社キャリア決済サービスの接続方法はHTMLリンク方式・Gateway方式でご利用いただけます。 下記に接続方式詳細を記載いたしますのでご確認をお願い致します。 ・HTMLリンク方式は、当社サーバー上の専用決済情報入力フォームと、決済終了後の専用結果ペー ジをご利用いただきます。決済完了後のページに関してはお客様が指定されたページを表示するこ とも可能です。当社のSSLを利用するため、お客様サイトでのSSL登録は必要ありません。 ・Gateway方式は、貴社にてSSLサーバをご用意頂き、ユーザー様から取得したクレジットカード情 報をROBOT PAYMENT決済サーバへ送信していただくことで決済処理を行う方式です。 加盟店様オリジナルの決済フォームをご希望される場合にお勧めです。 ■セッションについて ・当HTMLリンク方式では、購入ボタンの2度押しなどによる2重課金を防止する機能を実装していま す。 ※ごく稀に購入者様の想定外の動作により重複する可能性があります。 ■キャリア決済とは ・ユーザーが携帯電話の利用料金とまとめてサービス利用料金をお支払いできるサービスであり、 クレジットカードを持たないユーザー層を新たに取り込むことに貢献する決済手段です。 ・また、操作方法も非常に簡単でau・docomoのスマートフォン、またはPCから各キャリアの 「ID」、「パスワード」、「暗証番号」を入力するだけで決済を行うことが出来ます。 ・なお、弊社システムではau・docomoともに自動課金に対応しており、ユーザーが一度決済処理を 行うことで継続的に請求を行うことが可能です。
導入方法
6
■概要HTMLリンク方式では、加盟店様ウェブサイトから店舗番号、金額など決済に必要な情報を
弊社ゲートウェイにHTML FORM POST もしくは GET形式で送信後、弊社ゲートウェイサーバーが SSL決済フォームを表示し、購入者様が電話番号等を入力し送信することで、 その後の決済プロセスすべてを行います。 この方式では加盟店様でSSLサーバーを構築する必要もなく、手軽に加盟店様ウェブサイトに キャリア決済を導入することが出来ます。 決済処理終了後は、当社決済完了ページが表示されます。 また、管理画面で決済完了ページを指定していただくこともできます。決済結果は、ご指定の 完了ページへ通知する方法と決済結果通知URLへ通知する方式がございます。この設定に関しては、 管理画面にて設定することが可能です。 ■導入準備 HTMLリンク方式の導入に際して特別なソフトウェアや機材などは必要ありません。 決済フォームへの接続は一般的な「フォームの送信」と同じ仕組みを利用するため、 簡単なHTMLコードをサイトに貼り付けるだけです。 ショッピングカートなどのプログラムをご利用の場合は簡単なプログラムの変更をする必要があります。 ■管理画面の基本設定 接続作業とは別に管理画面の設定が必要になります。管理画面の設定が完了していない場合は 本番運用が出来ませんので必ず設定していただきますようお願いします。 詳細はROBOT PAYMENT管理画面マニュアルをご確認下さい。
HTMLリンク方式
■都度課金送信パラメータ 商品登録を行わずに決済金額情報を送信する場合と、商品登録を行ったうえで商品番号を 送信する場合2種類の方法があります。 送信先URL https://credit.j-payment.co.jp/gateway/payform.aspx ※=必須 ※=必須 ※1.ジョブタイプとして「AUTH」を選択した場合、与信枠の確保のみが行われ、決済処理が完了しても ご請求は確定発生しません。ご請求を確定させるためには必ず管理画面より実売上処理を 行う必要があります。 また、実売上処理に関しましては処理実行の有効期限があります。詳細に関しましては25ページの FAQをご確認いただけますようお願いします。 ※2.”その他”部分で決済サーバーに送信されたパラメータは、同じ形で店舗ウェブサーバーに 決済完了後、 決済情報と共に送信されます。 フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID cod 半角英数(50) 店舗オーダー番号。店舗側でオーダーを識別する為 にIDを送信することができます。 jb 定型 ※ ジョブタイプ(AUTH、CAPTURE)※1 am 半角数字 ※ 決済金額 tx 半角数字 ※ 税金額 sf 半角数字 ※ 送料 pt 半角数字(2) 「16」:Docomoキャリア決済を利用する場合 「17」:auキャリア決済を利用する場合 その他 その他データ※2 フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID cod 半角英数(50) 店舗オーダー番号。店舗側でオーダーを識別する為 にIDを送信することができます。 jb 定型 ※ ジョブタイプ(AUTH、CAPTURE)※1 iid 半角英数(1-50) ※ 管理画面で設定された商品コード※自動課金商品はご利用できません pt 半角数字(2) 「16」:Docomoキャリア決済を利用する場合 「17」:auキャリア決済を利用する場合 その他 その他データ※2 2.商品登録有り送信パラメータ 1.商品登録なし送信パラメータ
都度課金(HTMLリンク方式)
8
サンプル1.商品登録無しの場合
<FORM ACTION="https://credit.j-payment.co.jp/gateway/payform.aspx" METHOD="POST"> <INPUT TYPE="HIDDEN" NAME="aid" VALUE="100000">
<INPUT TYPE="HIDDEN" NAME="cod" VALUE="000001"> <INPUT TYPE="HIDDEN" NAME="jb" VALUE="CAPTURE"> <INPUT TYPE="HIDDEN" NAME="am" VALUE="1000"> <INPUT TYPE="HIDDEN" NAME="tx" VALUE="50"> <INPUT TYPE="HIDDEN" NAME="sf" VALUE="500"> <INPUT TYPE="HIDDEN" NAME="pt" VALUE="16"> <INPUT TYPE="submit" NAME="submit" VALUE="購入"> </FORM>
2.商品登録有りの場合
<FORM ACTION="https://credit.j-payment.co.jp/gateway/payform.aspx" METHOD="POST"> <INPUT TYPE="HIDDEN" NAME="aid" VALUE="100000">
<INPUT TYPE="HIDDEN" NAME="cod" VALUE="000001"> <INPUT TYPE="HIDDEN" NAME="jb" VALUE="CAPTURE"> <INPUT TYPE="HIDDEN" NAME="iid" VALUE="test001"> <INPUT TYPE="HIDDEN" NAME="pt" VALUE="16"> <INPUT TYPE="submit" NAME="submit" VALUE="購入"> </FORM>
■都度課金送信パラメータ 商品登録を行わずに決済金額情報を送信する場合と、商品登録を行ったうえで商品番号を 送信する場合2種類の方法があります。 送信先URL https://credit.j-payment.co.jp/gateway/carrier_gate.aspx ※=必須 ※1.ジョブタイプとして「AUTH」を選択した場合、与信枠の確保のみが行われ、決済処理が完了しても ご請求は確定発生しません。ご請求を確定させるためには必ず管理画面より実売上処理を 行う必要があります。 また、実売上処理に関しましては処理実行の有効期限があります。詳細に関しましては25ページの FAQをご確認いただけますようお願いします。 ※2.”その他”部分で決済サーバーに送信されたパラメータは、同じ形で店舗ウェブサーバーに 決済完了後、 決済情報と共に送信されます。 フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID jb 定型 ※ ジョブタイプ(AUTH、CAPTURE)※1 rt 半角英数(1) ※ 0:キックバックあり 1:キックバックなし cod 半角英数(50) 店舗オーダー番号。店舗側でオーダーを識別する為 にIDを送信することができます。 am 半角数字 ※ 決済金額 tx 半角数字 ※ 税金額 sf 半角数字 ※ 送料 pt 半角数字(2) 「16」:Docomoキャリア決済を利用する場合 「17」:auキャリア決済を利用する場合 em 半角英数(100) ※ メールアドレス pn 半角数字(20) ※ 電話番号 iid2 32バイト文字列 設定された場合「サービス名」としてdocomo側に 登録する dsp1 40バイト文字列 表示項目内容1、設定された場合docomoの詳細情 報1に設定する dsp2 40バイト文字列 表示項目内容2、設定された場合docomoの詳細情 報2に設定する url 半角英字 ※ 決済結果リダイレクト先(rtの設定値と関係なく、 成功時/エラー時必ずリダイレクトする) その他 その他データ※2 1.商品登録なし送信パラメータ
都度課金(Gateway方式)
10
※=必須 ※1.ジョブタイプとして「AUTH」を選択した場合、与信枠の確保のみが行われ、決済処理が完了しても ご請求は確定発生しません。ご請求を確定させるためには必ず管理画面より実売上処理を 行う必要があります。 また、実売上処理に関しましては処理実行の有効期限があります。詳細に関しましては17ページの FAQをご確認いただけますようお願いします。 ※2.”その他”部分で決済サーバーに送信されたパラメータは、同じ形で店舗ウェブサーバーに 決済完了後、 決済情報と共に送信されます。 フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID jb 定型 ※ ジョブタイプ(AUTH、CAPTURE)※1 rt 半角英数(1) ※ 0:キックバックあり 1:キックバックなし cod 半角英数(50) 店舗オーダー番号。店舗側でオーダーを識別する為 にIDを送信することができます。 iid 半角英数(1-50) ※ 管理画面で設定された商品コード ※自動課金商品はご利用できません pt 半角数字(2) 「16」:Docomoキャリア決済を利用する場合 「17」:auキャリア決済を利用する場合 em 半角英数(100) ※ メールアドレス pn 半角数字(20) ※ 電話番号 dsp1 40バイト文字列 表示項目内容1、設定された場合docomoの詳細情 報1に設定する dsp2 40バイト文字列 表示項目内容2、設定された場合docomoの詳細情 報2に設定する url 半角英字 ※ 決済結果リダイレクト先(rtの設定値と関係なく、 成功時/エラー時必ずリダイレクトする) その他 その他データ※2 2.商品登録有り送信パラメータ都度課金(Gateway方式)
12
DOCOMO決済画面表示内容
DOCOMO
ROBOT PAYMENT
<s1><e1>
管理画面の「設定」-「会社情報」-「サイト情報」の「サイト名」
<s2><e2>
「iid」指定の場合 ⇒ 登録している商品情報の商品名
「iid2」指定の場合 ⇒ iid2で指定した値
「iid」、「iid2」指定なしの場合 ⇒ <s2><e2>は非表示
<s3><e3>
管理画面の「設定」-「会社情報」-「サイト情報」の「サイトURL」
<s4><e4>
管理画面の「設定」-「決済システム」-「お問合せ情報」の
「お問合せ先電話番号」
※未設定の場合は <s4><e4>は非表示(「TEL:」も非表示)
<s5><e5>
管理画面の「設定」-「決済システム」-「お問合せ情報」の
「お問合せ先メールアドレス」
※未設定の場合は <s5><e5>は非表示(「MAIL:」も非表示
詳細情報(1行目)
「dsp1」で指定した値
※「dsp1」指定なしの場合は「詳細情報(1行目)」は非表示
詳細情報(2行目)
「dsp2」で指定した値
※「dsp2」指定なしの場合は「詳細情報(2行目)」は非表示
■都度課金キックバック通知内容 フィールド タイプ 必須 説明 gid 半角数字(6-10) ※ 決済番号 rst 半角数字(1) ※ 決済結果(1:OK 2:NG) ap 定型 ※ ■仮売上 ・Docomo:DCM_AUTH ・AU:AU_AUTH ■仮実同時 ・Docomo:DCM_CAP ・AU:AU_CAP ec 半角英数(12) ※ エラーコード god 半角数字(6) ※ オーダーコード cod 半角英数(50) 店舗側オーダー番号 am 半角数字(20) ※ 決済金額 tx 半角数字 ※ 税金額 sf 半角数字 ※ 送料 ta 半角数字 ※ 合計金額 id 半角英数(50) 弊社システム発行ID ps 半角英数(50) 弊社システム発行PW その他 決済データ送信時に送信したその他データ ■決済処理完了後のキックバック通知先URLへの決済データの通知について ※キックバック通知:決済情報をHTML GETメソッドで指定されたURLに対しHTTPリクエスト送信します。 ①管理画面上の設定ページで「決済結果通知URL」に設定されたURL決済情報を送信します。また、 「決済完了後転送先URL」にURLを設定していただきますと、決済完了時にそのURLを表示します。 (決済結果通知URLの設定を行っていただくと決済正常終了時にキックバック通知のみが異常終了した場合、 管理画面上の「通知」の項目が「成功」ではなく、「エラー」と表示されます。 転送先URLのみで決済結果の返却値を受け取られている場合、通知に異常が発生しても管理画面から 確認できないため、決済結果通知URLを設定 していただくことをお勧めいたします。) 店舗通知ですが、弊社より決済結果通知URLにパラメータを送信後、通知先のプログラムでHTML出力が 検知できた際に、通知成功とみなし、HTML出力がされなかった場合は失敗と判断します。 ※HTML出力が検知されれば、そのプログラムが動いた事が確認できる為,プログラムの1行目に、 何でも結構ですのでHTMLが出力されれば管理画面上に結果通知ステータスとして「成功」が表示されます。 ※=必須 <キックバック返却値例> http://加盟店様サーバ/決済結果通知URL? gid=100000&rst=1&ap=AU_CAP&ec=&god=100001&cod=a00001&am=1000& tx=50&sf=100&ta=1150
キックバック通知
14
自動課金(HTMLリンク方式)
■概要 自動課金とは、エンドユーザー様が初回決済の手続きを取って頂く事で、2回目以降の課金は定期的に 一定金額の課金する仕組みです。 定期的な課金は自動的に行われますので、運用の手間が比較的少なくシステムを導入頂けます。 なお、キャリア決済では商品登録無しの場合(弊社管理画面上で決済商品登録を行わずに決済金額情報を送信するパ ターン)のみ自動課金をご利用いただくことが可能です。 ■決済データ送信先URL https://credit.j-payment.co.jp/gateway/payform.aspx ※HTML FORM /POST・GET形式で決済フォームへリンクしてください。 ■必要パラメータ一覧 ※=必須 ※1.自動課金ではジョブタイプとして「CAPTURE」のみご利用いただけます。 ※2.かならず「ac1」または「ac3」のどちらかのパラメータと値を送信する必要があります。 ※3.auキャリア決済で自動課金を行う場合の金額は5,400円まで指定することができます。 ※4.「0」:未指定を選択した場合、決済日の日付が指定されます。 例)登録日:2015/10/15→自動課金発生日:2015/11/15 また、未指定であっても、決済日が末日であった場合、毎月末日に決済が発生します。 ※5.”その他”部分で決済サーバーに送信されたパラメータは、同じ形で店舗ウェブサーバーに 決済完了後、 決済情報と共に送信されます。 フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時発行された店舗ID cod 半角英数(50) 店舗オーダー番号。店舗側でオーダーを識別する為 にIDを送信することができます。 jb 定型 ※ ジョブタイプ(CAPTURE)※1 am 半角数字 ※ 決済金額 tx 半角数字 ※ 税金額 sf 半角数字 ※ 送料 pt 半角数字(2) 「16」:Docomoキャリア決済を利用する場合 「17」:auキャリア決済を利用する場合※3 ac1 定型 ※2 ■課金日指定 「0」:未指定※4 「99」:末日 「1-30」:1日~30日 ac3 ※2 ■課金停止回数指定 「0」:指定なし 「1-50」:1~50回目で自動停止 その他 その他データ※5サンプル
1.課金日指定利用
<FORM ACTION="https://credit.j-payment.co.jp/gateway/payform.aspx" METHOD="POST"> <INPUT TYPE="HIDDEN" NAME="aid" VALUE="100000">
<INPUT TYPE="HIDDEN" NAME="cod" VALUE="000001"> <INPUT TYPE="HIDDEN" NAME="jb" VALUE="CAPTURE"> <INPUT TYPE="HIDDEN" NAME="am" VALUE="1000"> <INPUT TYPE="HIDDEN" NAME="tx" VALUE="50"> <INPUT TYPE="HIDDEN" NAME="sf" VALUE="500"> <INPUT TYPE="HIDDEN" NAME="pt" VALUE="16"> <INPUT TYPE="HIDDEN" NAME=“ac1” VALUE=“0"> <INPUT TYPE="submit" NAME="submit" VALUE="購入"> </FORM>
2.課金停止回数利用
<FORM ACTION="https://credit.j-payment.co.jp/gateway/payform.aspx" METHOD="POST"> <INPUT TYPE="HIDDEN" NAME="aid" VALUE="100000">
<INPUT TYPE="HIDDEN" NAME="cod" VALUE="000001"> <INPUT TYPE="HIDDEN" NAME="jb" VALUE="CAPTURE"> <INPUT TYPE="HIDDEN" NAME="am" VALUE="1000"> <INPUT TYPE="HIDDEN" NAME="tx" VALUE="50"> <INPUT TYPE="HIDDEN" NAME="sf" VALUE="500"> <INPUT TYPE="HIDDEN" NAME="pt" VALUE="16"> <INPUT TYPE="HIDDEN" NAME=“ac3" VALUE=“10"> <INPUT TYPE="submit" NAME="submit" VALUE="購入"> </FORM>
16
自動課金(Gateway方式)
■決済データ送信先URL https://credit.j-payment.co.jp/gateway/carrier_gate.aspx。 ■必要パラメータ一覧 ※=必須 ※1.自動課金ではジョブタイプとして「CAPTURE」のみご利用いただけます。 ※2.かならず「ac1」または「ac3」のどちらかのパラメータと値を送信する必要があります。 ※3.auキャリア決済で自動課金を行う場合の金額は5,400円まで指定することができます。 ※4.「0」:未指定を選択した場合、決済日の日付が指定されます。 例)登録日:2015/10/15→自動課金発生日:2015/11/15 また、未指定であっても、決済日が末日であった場合、毎月末日に決済が発生します。 ※5.”その他”部分で決済サーバーに送信されたパラメータは、同じ形で店舗ウェブサーバーに 決済完了後、 決済情報と共に送信されます。 フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID jb 定型 ※ ジョブタイプ(AUTH、CAPTURE)※1 rt 半角英数(1) ※ 0:キックバックあり 1:キックバックなし cod 半角英数(50) 店舗オーダー番号。店舗側でオーダーを識別する為 にIDを送信することができます。 am 半角数字 ※ 決済金額 tx 半角数字 ※ 税金額 sf 半角数字 ※ 送料 pt 半角数字(2) 「16」:Docomoキャリア決済を利用する場合 「17」:auキャリア決済を利用する場合※3 em 半角英数(100) ※ メールアドレス pn 半角数字(20) ※ 電話番号 ac1 定型 ※2 ■課金日指定 「0」:未指定※4 「99」:末日 「1-30」:1日~30日 ac3 ※2 ■課金停止回数指定 「0」:指定なし 「1-50」:1~50回目で自動停止 iid2 32バイト文字列 設定された場合「サービス名」としてdocomo側に 登録する dsp1 40バイト文字列 表示項目内容1、設定された場合docomoの詳細情 報1に設定する dsp2 40バイト文字列 表示項目内容2、設定された場合docomoの詳細情 報2に設定する url 半角英字 ※ 決済結果リダイレクト先(rtの設定値と関係なく、 成功時/エラー時必ずリダイレクトする) その他 その他データ※5■決済データ送信先URL https://credit.j-payment.co.jp/gateway/carrier_acstop.aspx ※HTML FORM /POST・GET形式で決済フォームへリンクしてください。 ■自動課金停止時送信パラメータ ※自動課金番号は任意項目であり、パラメータに設定された場合、停止フォーム内そのまま表示されます。 パラメータに設定されない場合、停止フォーム内から再入力できます。 ※ボタン設置ではなく、リンクURL作成し、サイト内に設置、またはユーザー様に直接渡される場合は 下記のリンクURL内の「店舗ID」、「自動課金番号」を修正していただくことでご利用いただけます。 https://credit.j-payment.co.jp/gateway/carrier_acstop.aspx?aid=店舗ID&cacid=自動課金番号
自動課金停止URL・情報更新URL(HTMLリンク方式)
フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID cacid 半角数字 自動課金番号 ■決済データ送信先URL https://credit.j-payment.co.jp/gateway/carrier_info.aspx ※HTML FORM /POST・GET形式で決済フォームへリンクしてください。 ■自動課金情報変更時送信パラメータ ※=必須 ※URLにアクセスされた後、停止フォーム内には自動課金番号が必要です。 ※ボタン設置ではなく、リンクURL作成し、ユーザー様に直接渡される場合は下記のリンクURL内の「店舗ID」と 「初回決済番号」を修正していただくことでご利用いただけます。https://credit.j-payment.co.jp/gateway/carrier_acinfo.aspx?aid=店舗ID&tid=初回決済番号
フィールド タイプ 必須 説明
aid 半角数字(6) ※ ご契約時に発行された店舗ID
tid 半角数字 ※ 初回決済番号
18
■決済データ送信先URL https://credit.j-payment.co.jp/carrier_acstop_gate.aspx ■自動課金停止時送信パラメータ ※自動課金番号は任意項目であり、パラメータに設定された場合、停止フォーム内そのまま表示されます。 パラメータに設定されない場合、停止フォーム内から再入力できます。 ※ボタン設置ではなく、リンクURL作成し、サイト内に設置、またはユーザー様に直接渡される場合は 下記のリンクURL内の「店舗ID」、「自動課金番号」を修正していただくことでご利用いただけます。 https://credit.j-payment.co.jp/gateway/carrier_acstop.aspx?aid=店舗ID&cacid=自動課金番号自動課金停止URL・情報更新URL(Gateway方式)
フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID rt 半角数字(1) ※ 0:キックバックあり 1:キックバックなし cacid 半角数字 ※ 自動課金番号 その他 その他データ ■決済データ送信先URL https://credit.j-payment.co.jp/carrier_info_gate.aspx ■自動課金情報変更時送信パラメータ ※=必須 フィールド タイプ 必須 説明 aid 半角数字(6) ※ ご契約時に発行された店舗ID cacid 角数字 ※ 自動課金番号 em 半角英数(100) ※ メールアドレス pn 半角数字(20) ※ 電話番号 その他 その他データフィールド タイプ 必須 説明 gid 半角数字(6-10) ※ 決済番号 rst 半角数字(1) ※ 決済結果(1:OK 2:NG) ap 定型 ※ ■仮実同時 ・Docomo:DCM_CAP ・AU:AU_CAP ec 半角英数(12) ※ エラーコード god 半角数字(6) ※ オーダーコード cod 半角英数(50) 店舗側オーダー番号 am 半角数字(20) ※ 決済金額 tx 半角数字 ※ 税金額 sf 半角数字 ※ 送料 ta 半角数字 ※ 合計金額 id 半角英数(50) 弊社システム発行ID ps 半角英数(50) 弊社システム発行PW ac1 定型 ■課金日指定 「0」:未指定※1 「99」:末日 「1-28」:1日~28日※2 ac3 ■課金停止回数指定 「0」:指定なし 「1-50」:1~50回目で自動停止 cacid 半角数字 ※ キャリア決済自動課金番号 その他 決済データ送信時に送信したその他データ※3
自動課金キックバック通知(初回決済時)
■初回決済時返却パラメータ ※=必須 ※1.「0」:未指定を選択した場合、決済日の日付が指定されます。 例)登録日:2015/10/15→自動課金発生日:2015/11/15 ※2.課金日指定を「未指定」、且つ登録日が28日以降であった場合、課金日の指定として28日が設定されます。 ※3.”その他”部分で決済サーバーに送信されたパラメータは、同じ形で店舗ウェブサーバーに 決済完了後、 決済情報と共に送信されます。 <キックバック返却値例> http://加盟店様サーバ/決済結果通知URL? gid=100000&rst=1&ap=AU_CAP&ec=&god=100001&cod=a00001&am=1000& tx=50&sf=100&ta=1150&ac1=0&cacid=100000000020
フィールド タイプ 必須 説明 gid 半角数字(6-10) ※ 決済番号 rst 半角数字(1) ※ 決済結果(1:OK 2:NG 3:リトライ失敗 4:ユーザ都合) ec 半角英数(12) ※ エラーコード god 半角数字(6) ※ オーダーコード cod 半角英数(50) 店舗側オーダー番号 id 半角英数(50) 弊社システム発行ID ps 半角英数(50) 弊社システム発行PW cacid 半角数字 ※自動課金キックバック通知(2回目以降)
■2回目以降返却パラメータ ※=必須 <キックバック返却値例> http://加盟店様サーバ/決済結果通知URL? gid=100000&rst=1&ec=&god=100001&&cacid=1000000000フィールド タイプ 必須 説明 gid 半角数字(6-10) ※ 決済番号 rst 半角数字(1) ※ 決済結果(4:ユーザ都合) cod 半角英数(50) 店舗側オーダー番号 cacid 半角数字 ※ ec 半角英数(12) ※ エラーコード
自動課金キックバック通知(停止)
■自動課金停止返却パラメータ ※=必須 <キックバック返却値例> http://加盟店様サーバ/決済結果通知URL? gid=100000&rst=4&ec=&cod=100001&cacid=100000000022
自動課金スケジュール例①
■例1 <設定条件> ・課金指定日 :未指定 ・決済金額 :1,000円 ・税金額 :80円 ・送料 :0円 初回決済:1/15 2回目:2/15 3回目:3/15 4回目:4/15 売上発生 自動課金開始 (自動課金1回目) 1,080円 1,080円 1,080円 1,080円 「毎月15日」で 自動課金が発生 課金の流れ ■特徴 ・課金日の指定がない場合、ユーザーが操作をして決済を行った日付から 1ヵ月周期で決済が発生します。 ・課金停止回数が設定されていない為、自動課金を止めるには管理画面、 または自動課金停止URLからの停止処理が必要です。 ■例2 <設定条件> ・課金指定日 :未指定 ・決済金額 :1,000円 ・税金額 :80円 ・送料 :0円 初回決済:1/31 2回目:2/28 3回目:3/31 4回目:4/30 売上発生 自動課金開始 (自動課金1回目) 1,080円 1,080円 1,080円 1,080円 「毎月末日」で 自動課金が発生 課金の流れ ■特徴 ・課金日の指定がない場合でも、ユーザー操作による決済が月の末日に行われた 場合、その後の決済は毎月末日に発生します。 ・課金停止回数が設定されていない為、自動課金を止めるには管理画面、 または自動課金停止URLからの停止処理が必要です。自動課金スケジュール例②
■例3 <設定条件> ・課金指定日 :20日 ・決済金額 :1,000円 ・税金額 :80円 ・送料 :0円 初回決済:1/15 2回目:2/20 3回目:3/20 4回目:4/20 売上発生 自動課金開始 (自動課金1回目) 1,080円 1,080円 1,080円 1,080円 「毎月20日」で 自動課金が発生 課金の流れ ■特徴 ・課金日の指定が行われた場合、自動課金が開始されるのは決済月の翌月で 課金日として指定された日付から開始されます。 ・課金停止回数が設定されていない為、自動課金を止めるには管理画面、 または自動課金停止URLからの停止処理が必要です。 自動課金停止 (自動課金3回目) ■例4 <設定条件> ・課金停止回数:3回 ・決済金額 :1,000円 ・税金額 :80円 ・送料 :0円 初回決済:1/31 2回目:2/28 3回目:3/31 4回目:4/30 売上発生 自動課金開始 (自動課金1回目) 1,080円 1,080円 1,080円 1,080円 課金の流れ ■特徴 ・課金停止回数を指定した場合、自動課金1回目から数え、課金停止回数として 指定された回数の自動課金が終了した段階で自動課金アカウントが停止します。 ・課金停止回数が設定されていない為、自動課金を止めるには管理画面、 または自動課金停止URLからの停止処理が必要です。24
区分 名前 設定値 備考 サービ ス情報 サービスURL(PC) https://credit.j-payment.co.jp/gateway/form/type1/ja/au.a spx PC版 サービスURL(EZ携帯) ー 何も設定しない サービスURL(スマートフォ ン) https://credit.j-payment.co.jp/gateway/form/sp/ja/au.aspx スマホ版 検証環 境利用 登録 検証環境URL https://credit.j-payment.co.jp/ 検証ホワイトリスト※1 https://credit.j-payment.co.jp/gateway/carrier/notification/ auth_openid.aspx?aid=xxxxxx 「xxxxxx」を店舗 IDに置き換えてく ださいFLAVOR設定
■概要 auかんたん決済をご利用頂く前、au FLAVORからサービスIDを事前に登録する必要があります。【加盟店ID】、 【サービスID】、【セキュアキー】が発行されたら、弊社にお知らせください。サービスID登録時、弊社決済システ ム関連情報を記入して頂く箇所があり、下表をご参考ください。 ※1検証ホワイトリストは決済URL有効性チェック時利用されています。間違って設定された場合、auかんたん決済 できない可能性があります。ホワイトリスト(URL)は一意で制限されているため、複数サービスIDに同じ ホワイトリスト(URL)の登録は不可です。「xxxxxx」は弊社発行した店舗IDです。FAQ
Q:ROBOT PAYMENTのスマートフォン最適化機能に対応しているか?
A:キャリア決済はスマートフォン最適化機能に対応しています。スマートフォンから
の多数の流入が見込まれる加盟店様は併せて是非御検討をお願い致します。
Q:キャリア決済は英語対応しているか?
A:誠に申し訳ございません。キャリア決済は英語フォームに対応しておりません。
Q:フィーチャーフォン(ガラケー)に対応しているか?
A:キャリア決済はフィーチャーフォンには対応しておりません。
Q:実売上処理実行の期限はあるか?
A:実売上処理実行の期限はございます。各キャリアごとに基準はことなっており、
以下に記載いたしますのでご確認をおねがいいたします。
・au
:仮売上発生から、90日以内
・docomo:仮売上発生月の翌々月末日19:59まで
※ユーザー様がキャリアを解約された場合、上記の期限内であっても実売上処理を行えませんので
商品の発送を行う場合は、実売上処理を行われた後の発送をお願い致します。
Q:上限・下限金額はあるか?
A:上限・下限金額はございます。1円から決済を行っていただくことは可能です。
一回あたりの最高上限金額に関しましては以下に記載いたしますのでご確認をお願い致します。
※なお、上限金額に関しましてはユーザー様のキャリアご契約年数、年齢、ご契約形態に
よっては上記の内容があてはまりませんのでご了承くださいませ。
Q:自動課金が失敗した場合、自動課金のリトライは行われるか?
A:auかんたん決済の場合自動課金のリトライは行われません。また、自動課金が失敗すると
該当ユーザーの自動課金アカウントは停止ステータスに切り替わります。
docomoケータイ払いの場合自動課金は即時最大3回リトライが行われます。
3回連続課金失敗した場合、即時自動課金停止ステータスに切り替わりません。
au
docomo
上限金額 50,000円 50,000円26
■エラーコードは決済成功時は空白、エラー時には半角英数字が返信されます。 ・弊社決済サーバー発行のエラーコード エラーコード エラー情報 ER000 決済システム内部エラー(例外) ER002 決済送信元URLエラー(Refererエラー) ER004 未登録店舗 ER005 未登録商品 ER006 発行可能ID/PWなし ER010 決済処理が込み合ってます。(セッション数) ER011 決済拒否-IP アドレス ER012 決済拒否-メールアドレス ER017 お取り扱いできない金額(決済金額下限) ER018 お取り扱いできない金額(決済金額上限) ER050 パラメータ:店舗IDエラー(aid) ER051 パラメータ:ジョブコードエラー(jb) ER053 パラメータ:決済番号エラー(tid) ER054 パラメータ:オーダーコードエラー(cod) ER059 パラメータ:メールアドレスエラー(em) ER060 パラメータ:電話番号エラー(pn) ER061 パラメータ:商品金額エラー(am) ER062 パラメータ:税金額エラー(tx) ER063 パラメータ:送料エラー(sf) ER068 パラメータ:商品コードエラー(iid) ER071 パラメータ:発行PWエラー(ps) ER127 パラメータ:課金指定日エラー(ac1) ER128 パラメータ:課金停止回数エラー(ac3) ER575 自動課金ご利用可能金額上限金額エラーエラーコード対応表
■エラーコードは決済成功時は空白、エラー時には半角英数字が返信されます。 ・弊社決済サーバー発行のエラーコード エラーコード エラー情報 ER800 キャリア決済課金停止処理エラー ER801 AU決済認証エラー ER802 AUトランザクションID取得エラー ER803 AUキャリア決済情報照合エラー ER804 AUレスポンスパラメーターエラー ER805 DOCOMO決済認証エラー ER806 DOCOMOキャリア決済情報照合エラー ER807 DOCOMO決済キャンセルエラー ER808 DOCOMO決済情報照合エラー ER809 DOCOMO売上確定エラー ER998 都合によりお取り扱いできません。 ER999 メンテナンス中です。