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