BitCash 決済システム接続仕様書 ( リンク接続 Gateway 接続 )
改訂履歴 項番改定日時改訂者対象改訂内容 1 2015/10/20 梨本 Gateway SSL 暗号方式に関して 2 2016/5/6 梨本 Gateway SSL 暗号方式に関するご案内の削除 2
目次 1. 概要 導入方法について : 概要 ( 本ドキュメントについて おことわり ) : 導入方法 ( 概要 セッションについて ) 2.HTML リンク接続方式について : 概要 : 導入準備 : サンプル画面 (Bitcash 決済 ) 3. 決済時に必要なパラメータ ( 商品登録無し ) : 商品登録無しについて : サンプルソース要なパラメータ ( 商品登録なし 商品登録ありの場合 ) 4. 決済時に必要なパラメータ ( 商品登録あり ) : 商品登録無ありについて : サンプルソース 5.Gateway 接続方式について : 概要 : 導入方法 (SSL) : 注意事項 6. 決済時に必要なパラメータ ( 商品登録無し ) : 商品登録無しについて 7. 決済時に必要なパラメータ ( 商品登録あり ) : 商品登録ありについて 8. 取消処理時のパラメータ : 取消処理の場合 9. 決済結果通知処理について 1 2 : 決済結果通知とは : 注意点 : 決済通知パラメータ一覧 10. テスト決済の手順 : テスト手順 : 注意点 11. エラーコード対応表について ( 弊社発行のエラーコード 1 2) : 弊社決済サーバー発行のエラーコード 12. エラーコード対応表について ( 弊社発行のエラーコード 1 2) :Bitcash 発行のエラーコード 13 その他 :SSL 接続方式について 3
1. 概要 導入方法について 概要 本ドキュメントについて本ドキュメントは株式会社 ROBOT PAYMENT が提供する オンライン BitCash 決済サービスの接続仕様書です おことわり 本ドキュメントの内容は著作権で保護されており 本書の内容の一部または全部を当社の同意なしに複写 複製および転載することを禁止します 本書の内容は予告なしに随時更新されることがあります 本書の内容については万全を期しておりますが記入漏れ等お気づきの点がございましたら 当社までご連絡下さい 導入方法 概要当社決済ゲートウェイには 2 種類の接続方法がございます HTML リンク方式は 当社サーバー上の専用決済情報入力フォームと 決済終了後の専用結果ページをご利用いただきます 当社の SSL を利用するため お客様サイトでの SSL 登録は必要ございません Gateway 方式は お客様サイト独自の決済情報入力フォームと 結果ページを作成可能です SSL の登録はお客様側で登録していただく必要がございます セッションについて 当システムでは 購入ボタンの 2 度押しなどによる 2 重課金を防止する機能を実装しております ごく稀に購入者様の想定外の動作により重複する可能性がございます 4
2.HTML リンク接続方式について 概要 HTML リンク方式では 店舗ウェブサイトから店舗番号 金額など決済に必要な情報を弊社ゲートウェイに HTML FORM POST もしくは GET 形式で送信後 弊社ゲートウェイサーバーが SSL 決済フォームを表示し 店舗のお客様がウェブマネー情報等を入力することで その後の決済プロセスすべてを行います この方式では店舗で SSL サーバーを構築する必要もなく 手軽に店舗ウェブサイトにオンライン BitCash 決済を導入することが出来ます 決済処理終了後は 決済サービスの確認ページが表示されるか もしくは店舗が指定する URL へ決済結果のパラメータを HTML FROM GET 形式で送信します この設定に関しては 店舗用コントロールパネルにて変更することが可能です 導入方法 HTML リンク方式の導入に際して特別なソフトウェアや機材などは必要ありません 決済フォームへの接続は一般的な フォームの送信 と同じ仕組みを利用するため 簡単な HTML コードをサイトに貼り付けるだけです ショッピングカートなどのプログラムをご利用の場合は簡単なプログラムの変更をする必要があります サンプル画面 (Bitcash 決済 ) 5
3. 決済時に必要なパラメータ ( 商品登録無し ) 商品登録無しについて商品登録無しにつきまして 弊社の管理画面上で商品登録作業を行う必要がなく 商品金額(am) 等の以下パラメータを送信して頂ければ 決済手続きを行う事が可能でございます 商品登録数が 多い加盟店様向けとなります 送信先 URL https://credit.j-payment.co.jp/gateway/payform.aspx 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 Bitcash 決済画面表示 pt 9 をご指定下さい 未指定の場合は支払方法選択フォームを表示されます 定型 商品金額 am 商品金額をご指定下さい 半角数字 税金額 tx 税額をご指定下さい 半角数字 送料 sf 送料をご指定下さい 半角数字 ジョブタイプ jb CAPTURE ( 仮実同時売上 ) 定型 店舗オーダー番号 cod オーダーを認識する為のパラメータを任意で送信することが出来ます 半角英数 50 字以内 電話番号 pn 半角数字 ( ハイフンなし ) E メール em 半角英数 商品名 Inm 決済フォームに商品名を表示できます 全角 / 半角英数字 ( 半角 100 字以内 ) 全角の場合 UTF-8 でご指定下さい その他データ その他 パラメータを自由に設定し 任意で送信することが出来ます 指定なし 1024Bite 以内 サンプルソース <form action="https://credit.j-payment.co.jp/gateway/payform.aspx"method= post"> <input type="hidden"name="aid"value="100000"> <input type="hidden"name="jb"value="capture"> <input type="hidden"name="am"value="1000"> <input type="hidden"name="tx"value="0"> <input type="hidden"name="sf"value="0"> <input type="hidden"name="pt"value="9"> <input type="submit"name="submit"value=" 購入 "> </form> 6
4. 決済時に必要なパラメータ ( 商品登録あり ) 商品登録ありについて 商品登録ありにつきまして 弊社の管理画面上で商品登録作業を行って頂き 商品コード (iid) 等の以下パラメータを送信して頂ければ 決済手続きを行う事が可能でございます 商品登録数が 多い加盟店様向けとなります 送信先 URL https://credit.j-payment.co.jp/gateway/payform.aspx 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 Bitcash 決済画面表示 pt 9 をご指定下さい 未指定の場合は支払方法選択フォームを表示されます 定型 店舗オーダー番号 cod オーダーを認識する為のパラメータを任意で送信することが出来ます 半角英数 50 字以内 商品名 Inm 決済フォームに商品名を表示できます 全角 / 半角英数字 ( 半角 100 字以内 ) 全角の場合 UTF-8 でご指定下さい 電話番号 pn 半角数字 ( ハイフンなし ) E メール em 半角英数 その他データ その他 パラメータを自由に設定し 任意で送信することが出来ます 指定なし 1024Bite 以内 サンプルソース <form action="https://credit.j-payment.co.jp/gateway/payform.aspx"method= post"> <input type="hidden"name="aid"value="100000"> <input type="hidden"name="jb"value="capture"> <input type="hidden"name="iid"value="test1"> <input type="hidden"name="pt"value="9"> <input type="submit"name="submit"value=" 購入 "> </form> 7
5.Gateway 接続方式について 概要 Gateway 方式で ROBOT PAYMENT 決済ゲートウェイに接続する場合は 店舗ウェブサイト側で SSL 決済フォームを用意する必要があります 当社ゲートウェイと店舗ウェブサーバーの接続に対する通信部分は当社 SSL サーバーにより安全ですが 店舗と顧客との通信部分は店舗ウェブサーバーに依存するため 店舗側でも SSL サーバーを設定していただく必要が御座います また 個人情報を店舗側でデータベース等に保存することはできません システムの仕様上 個人情報を保存する必要がある場合は 必ず暗号化する必要があります Gateway 方式では 店舗ウェブサイトは SSL などを利用したセキュアな決済フォームを用意し そのフォームで顧客が入力した決済情報を ROBOT PAYMENT 決済ゲートウェイに送信して頂きます 決済結果を HTML 出力行いますので HTTP GET コマンドにて取得後 解析して頂くようになりまたは 決済情報を ROBOT PAYMENT 決済ゲートウェイに送信して頂き 決済結果をキックバックいたします 決済終了後は決済ゲートウェイより決済結果情報を受け取って CGI などで解析しお客様オリジナルの確認画面を表示させます お客様で作成する確認ページは基本的に自由に作成していただけますが 弊社が発行する決済番号 連絡先の電話番号と E メールアドレス 請求社名については必ず表示するようにしてください 導入方法 (SSL) 注意事項 Gateway 方式を利用して当社ゲートウェイに接続するには 必ず SSL 通信の設定をする必要があります 決済フォームを表示する URL は必ず認証機関よりデジタル ID を取得して下さい SSL 通信を設定していただけないお客様には Gateway 方式での当社サーバーへの接続をすることはできません Gateway 方式をご利用になる際の注意事項です 1.Gateway 方式の接続に関するテクニカルサポートに関しては E メールにてのみ受付致しております 電話や対面でのサポートに関してましては別途料金が掛かります 尚 E メールでのサポートに関しては 少々お時間を頂く事も御座いますので 何卒ご了承下さい 2. レンタルサーバーをご使用のお客様はレンタルサーバーの環境によっては ご使用いただけない場合がございますのであらかじめご了承ください 3. 完全にサーバーサイド同士の通信をする必要があり ソケット通信を使って プログラムを呼び出す必要がございます また クライアント側の処理で決済のパケットが流れる仕組みですと リファラ IP がクライアントの IP を参照しますので ER003 エラー が出てしまいます 8
6. 決済時に必要なパラメータ ( 商品登録無し ) 商品登録無しについて商品登録無しにつきまして 弊社の管理画面上で商品登録作業を行う必要がなく 商品金額(am) 等の以下パラメータを送信して頂ければ 決済手続きを行う事が可能でございます 商品登録数が 多い加盟店様向けとなります 以下パラメーターをHTTP GETもしくはPOSTで下記のURLに送信してください 送信先 URL https://credit.j-payment.co.jp/gateway/bitcash.aspx 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 Bitcash 決済画面表示 pt 9 をご指定下さい 未指定の場合は支払方法選択フォームを表示されます 定型 結果返信方法 rt 結果返信方法 (0: キックバック 1: レスポンス ) 定型 商品金額 am 商品金額をご指定下さい 半角数字 税金額 tx 税額をご指定下さい 半角数字 送料 sf 送料をご指定下さい 半角数字 ジョブタイプ jb CAPTURE ( 仮実同時売上 ) 定型 店舗オーダー番号 cod オーダーを認識する為のパラメータを任意で送信することが出来ます 半角英数 50 字以内 電話番号 pn 半角数字 ( ハイフンなし ) E メール em 半角英数 Bitcash カード番号 ( ひらがな 16 文字 ) cn 全角ひらがな (16) 全角ひらがな (16) 商品名 Inm 決済フォームに商品名を表示できます 全角 / 半角英数字 ( 半角 100 字以内 ) 全角の場合 UTF-8 でご指定下さい その他データ その他 パラメータを自由に設定し 任意で送信することが出来ます 指定なし 1024Bite 以内 9
7. 決済時に必要なパラメータ ( 商品登録あり ) 商品登録ありについて 商品登録ありにつきまして 弊社の管理画面上で商品登録作業を行って頂き 商品コード (iid) 等の以下パラメータを送信して頂ければ 決済手続きを行う事が可能でございます 商品登録数が 多い加盟店様向けとなります 以下パラメーターを HTTP GET もしくは POST で下記の URL に送信してください 送信先 URL https://credit.j-payment.co.jp/gateway/bitcash.aspx 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 Bitcash 決済画面表示 pt 9 をご指定下さい 未指定の場合は支払方法選択フォームを表示されます 定型 結果返信方法 rt 結果返信方法 (0: キックバック 1: レスポンス ) 半角英字 (1) 商品コード iid 弊社の管理画面上に登録頂いた 商品コード を ご指定下さい 半角数字 (50) 店舗オーダー番号 cod オーダーを認識する為のパラメータを任意で送信することが出来ます 半角英数 50 字以内 商品名 Inm 決済フォームに商品名を表示できます 全角 / 半角英数字 ( 半角 100 字以内 ) 全角の場合 UTF-8 でご指定下さい Bitcash カード番号 cn Bitcash カード番号 ( ひらがな 16 文字 ) 全角ひらがな (16) 電話番号 pn 半角数字 ( ハイフンなし ) E メール em 半角英数 その他データ その他 パラメータを自由に設定し 任意で送信することが出来ます 指定なし 1024Bite 以内 10
8. 取消処理時に必要なパラメータ 取消処理の場合取消処理につきまして 以下パラメータを送信頂ければ 取消処理を行う事が可能でございます 以下パラメーターをHTTP GETもしくはPOSTで下記のURLに送信してください 送信先 URL https://credit.j-payment.co.jp/gateway/bitcash.aspx 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 結果返信方法 rt 結果返信方法 (0: キックバック 1: レスポンス ) 半角英字 (1) ジョブタイプ jb CANCEL ( 取消 ) 定型 決済番号 tid 取消処理を行う決済番号をご指定下さい 半角数字 (6) 9. 決済結果通知処理について 1 決済結果通知とは弊社の管理画面と別に顧客管理画面にデータ反映を行う処理通知となります 決済結果通知 URLの設定箇所 : 弊社管理画面トップ 設定 決済システム設定 をクリック後 決済結果通知設定内の 決済結果通知 URL にご指定 URLを設定下さい 注意点 決済後キックバックにより指定の URL に送信される情報管理画面上の設定ページで 決済結果通知 URL に設定された URL 決済情報を送信します また 決済完了後転送先 URL に URL を設定していただきますと 決済完了時にその URL を表示します ( 正常終了の場合のみ 異常終了に関しては弊社ページのエラー表示となりますので決済結果通知 URL を設定していただくことをお勧めいたします ) 店舗通知ですが 弊社より決済結果通知 URL にパラメータを送信後 通知先のプログラムで HTML 出力が検知できた際に 通知成功とみなし HTML 出力がされなかった場合は失敗と判断しております HTML 出力が検知されれば そのプログラムが動いた事が確認できる為 プログラムの 1 行目に 何でも結構ですので HTML が出力されれば結果通知成功となります 11
9. 決済結果通知処理について 2 決済結果通知のパラメータ一覧 項目 フィールド 詳細 必須 指定条件 決済番号 gid 半角数字 (8) 定型 決済結果 rst 決済結果 (1:OK 2:NG) 半角数字 (1 字 ) 承認番号 ap BitCash: 決済完了 BIT_CAN: 取消完了 定型 エラーコード ec 詳細はエラーコード一覧をご覧ください 1 半角英数 (12 字 ) オーダーコード god 決済ごとに発行されるユニークID 半角数字 (8 字 ) 店舗オーダー番号 cod 決済データ送信時に送信された店舗オーダー番号 半角英数 (50 字以内 ) ジョブタイプ jb CAPTURE ( 仮実同時売上 ) 定型 店舗オーダー番号 cod オーダーを認識する為のパラメータを任意で送信することが出来ます 半角英数 (50 字以内 ) 電話番号 pn 半角数字 ( ハイフンなし ) E メール em 半角英数 決済金額 am 決済データ送信時に送信された決済金額 半角数字 税金額 tx 決済データ送信時に送信された税額 半角数字 送料 sf 決済データ送信時に送信された送料 半角数字 合計金額 ta 決済金額 + 税金額 + 送料の値 半角数字 商品コード iid 商品登録ありの決済時のみ通知されます 半角英字 (50 文字以内 ) 発行 ID id ROBOT PAYMENTシステムより発行されたID 半角英数 (50 字以内 ) 発行パスワード ps ROBOT PAYMENT システムより発行された PW 半角英数 (50 字以内 ) Bitcash 決済画面表示 pt Bitcash 画面表示を指定した場合のみ 9 が通知 半角数字 (1 字 ) 商品名 inm 決済フォームに商品名を表示できます ( 注 ): 商品名 (inm) を指定いた場合 通知 全角 / 半角英数字 ( 半角 100 字以内 ) 全角の場合 UTF-8 でご指定下さい その他データ その他 パラメータを自由に設定し 任意で送信することが出来ます 指定なし 1024Bite 以内 < 1> カード会社通信後エラー (G から始まるエラーコード ) のみキックバックします パラメータエラー (ER から始まるエラーコード ) はキックバックしませんのでご注意ください サンプル例 店舗への決済結果通知 ( POST 通信方式で送信された場合でも GET 方式にて通知されます.) キックバック処理 (rt=0) の場合通知サンプル ( id pw 発行の場合 id pw も通知されます ) http:// 店舗サーバ / 決済結果通知 URL?gid=100001&rst=1&ap=BitCash&ec=&god=100001 &cod=test001&am=1000&tx=50&sf=100&ta=1150 レスポンス処理 (rt=1) の場合通知サンプル Gateway 方式のみ選択可能. ( 決済結果を HTML 出力 ( カンマ区切で出力 ) 100001,1,0001112,,100001,a00001,1000,50,100,1150,,(, その他データ ) 12
10. テスト決済の手順について テスト手順 1.ROBOT PAYMENT 決済管理画面にて 設定 - 決済システム設定 - システムモード をテストモードにする. 2. 決済時に以下 bitcash テストカードをご入力下さいませ. テストカード : へもさくのゆたみろよめつすのらに のおかそきつねつぬふさてのつうは 3. 決済が成功した場合 1~2 秒後に決済が完了いたします. 4. 決済が失敗した場合決済完了画面にエラーコードが表示されます. ( 注意点 ) テストカードはテストモード 本番モードいずれも使用可能です. テストカードでの処理の場合 実際に売上が発生することはありません. 本番モードと同様に 決済結果通知メール等は送信されます. 決済結果通知メールについては 加盟店様向け 決済者様向けがあり それぞれ設定して頂ければ メール通知処理が行われます 加盟店様向けメールの設定方法 弊社の管理画面トップ 設定 決済システム設定 をクリック後 決済結果通知項目の 決済結果通知 E メール にメールアドレスを設定下さい. 決済者 ( 購入者 ) 様向けメールの設定方法 弊社の管理画面トップ 設定 決済システム設定 をクリック後 お問合せ情報項目の お問合せメールアドレス に御社メールアドレスを設定下さい. 決済者 ( 購入者 ) 様宛のメールは 設定したメールアドレスよりシステム的に 送信されます. テストモードで決済された情報は管理画面上に表示され データを消すことが出来ません. 注意点 Bitcash テストカードをご利用の際は 上限金額 :10 万円となり 全加盟店様共通のテストカードとなる為 Bitcash カードの残高不足エラー (BE206 エラー ) が発生致します 必ず取消処理を行って頂く様 お願い致します 13
11. エラーコード対応表について ( 弊社発行のエラーコード 1) 弊社決済サーバー発行のエラーコード エラーコード エラー内容詳細 ER000 決済システム内部エラー ( 例外 ) ER001 リクエストエラー ( ゲートウェイ等例外 ) ER002 決済データ送信元 URLエラー (Refererエラー) ER003 決済送信元 IPエラー (RemoteHostエラー) ER004 ER005 ER006 未登録店舗 未登録商品 発行可能 ID/PW なし ER010 決済処理が込み合ってます ( セッション数 ) ER011 ER012 ER016 決済拒否 -IP アドレス 決済拒否 - メールアドレス ご利用可能金額上限 ER017 お取り扱いできない金額 ( 決済金額下限 ) ER018 お取り扱いできない金額 ( 決済金額上限 ) ER030 決済失敗 ( すべて ) ER050 ER051 ER052 ER053 ER054 ER055 ER056 ER057 ER058 ER059 ER060 パラメータ : 店舗 IDエラー (aid) パラメータ : ジョブコードエラー (jb) パラメータ : 決済結果通知方法エラー (rt) パラメータ : 決済番号エラー (tid) パラメータ : オーダーコードエラー (cod) パラメータ :BitCash 番号エラー (cn) パラメータ : 有効期限エラー (ed) パラメータ : 名前エラー (fn) パラメータ : 苗字エラー (ln) パラメータ : メールアドレスエラー (em) パラメータ : 電話番号エラー (pn) 5 ページ目に続く 14
11. エラーコード対応表について ( 弊社発行のエラーコード 2) エラーコード エラー情報詳細 ER061 ER062 ER063 ER068 ER069 ER101 ER102 ER103 ER104 ER105 ER106 ER107 ER108 ER109 パラメータ : 商品金額エラー (am) パラメタ : 税金額エラー (tx) パラメタ : 送料エラー (sf) パラメタ : 商品コードエラー (iid) パラメタ : コマンドコードエラー (cmd) ID/PW 発行時オーダー情報取得エラー IP/PW 発行時オーダー情報取得エラー (CMD=0) コントロール読込みエラージョブ設定エラーセッション変数呼出順路確認エラーセッション変数受取エラーリクエストメソッドエラー確定時 ID/PWオーダー情報取得エラー確定時コントロール読込みエラー 15
12. エラーコード対応表について (Bitcash 発行のエラーコード 1) Bitcash 発行のエラーコード エラーコード エラー内容詳細 BE001 BE002 BE003 BE201 BE202 BE203 BE204 BE205 BE206 BE207 BE208 BE301 BE302 BE303 BE304 BE305 BE306 BE306 BE351 BE352 BE353 BE354 BE355 BE356 BE357 BitCashカード番号エラー決済取消済エラー決済取消期限切れエラーロット番号利用停止エラーカード利用停止エラー店舗利用停止エラーキャンペーン期間前エラーキャンペーン期間後エラー BitCash 残高エラー締日後決済キャンセルエラー該当決済キャンセル済エラー SHOP_ID 未入力エラー SHOP_PASSWORD 未入力エラー SALES_ID 未入力エラー BCS_ID 未入力エラー CARD_NUMBER 未入力エラー RATING 未入力エラー RATING 未入力エラー SHOP_ID 不正エラー SHOP_PASSWORD 不正エラー認証時と決済時のSHOP_ID 不一致エラー Bitcashカード情報 ( ひらがな ) 入力エラーカードレイティングエラー 弊社システムはSTのみ対応ショップレイティングエラーテストカードミスマッチエラー 5 ページ目に続く 16
12. エラーコード対応表について (Bitcash 発行のエラーコード 2) エラーコード エラー内容詳細 BE358 キャンペーンミスマッチエラー 1( カードがキャンペーンだが店舗がキャンペーンでない ) BE359 ロット番号不正エラー BE360 キャンペーンミスマッチエラー 2( 店舗がキャンペーンだがカードがキャンペーンでない ) BE361 BE362 BE363 BE501 BE502 BE503 BE504 BE506 BE507 BE508 売上レコード無しエラーマイナス売上決済エラー決済確認エラー決済情報作成エラー決済情報レコード取得エラー決済情報作成済みエラー決済情報レコード作成エラーカードレコード無しエラーロットレコード無しエラーショップレコード無しエラー 17