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