クレジットカード決済
HTML LINK方式 接続仕様書
（自動課金専用）
■概要 ：HTMLリンク方式 概要･・・・・・・・・・・・・・・・・・・・・・・・・・P.3 ：自動課金 概要･・・・・・・・・・・・・・・・・・・・・・・・・・・・・・P.4 ■必要パラメータ一覧 ：PCサイト決済時･・・・・・・・・・・・・・・・・・・・・・・・・・・・・・P.5 ：フィーチャーフォン決済時･・・・・・・・・・・・・・・・・・・・・・・・・P.6 ：自動課金停止処理･・・・・・・・・・・・・・・・・・・・・・・・・・・・・P.7 ：カード情報変更･・・・・・・・・・・・・・・・・・・・・・・・・・・・・・P.8 ■決済後に通知されるパラメータ ：初回決済時･・・・・・・・・・・・・・・・・・・・・・・・・・・・・・･・P.9 ：2回目以降･・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・P.10 ■その他機能 ：決済確認メールについて･・・・・・・・・・・・・・・・・・・・・・・・・・P.11 ：決済テスト手順について･・・・・・・・・・・・・・・・・・・・・・・・・・P.12 ：機能一覧･・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・・P.13
目次
HTMLリンク方式 概要
決済に必要な情報を、パラメータとして弊社サーバに送信して頂く事で、
ROBOT PAYMENT専用の決済フォームを呼び出します。
クレジットカード情報は、弊社サーバ上で入力頂きますので、貴社でカード
情報を管理する必要は一切ございません。
また、特別なソフトウェアや機材等は不要です。
HTML形式のリンク設定を頂くだけで、簡単に導入する事が可能です。
【決済フォームサンプル】
自動課金 概要
自動課金機能をご利用頂く事で、一定額を定期的に課金する仕組みを構築
できます。定期的な課金は自動的に行われるので、運用の手間が比較的少な
くシステムを導入頂けます。
また、貴社側でカード番号を保有する必要は一切ございません。
初回の入会金のみ別の金額を課金し、2回目以降の一定額を継続課金する
ような課金体系にも対応しております。
■以下のような事業者様にご利用頂いています。
・物販の定期購入サイト様
・有料会員制サイト様
・月謝制の学習塾様
・定期募金、寄付金を募られている団体様
・サービス利用料定期的に課金される事業者様
■決済データ送信先URL
https://credit.j-payment.co.jp/gateway/payform.aspx
※HTML FORM POST/GET 形式で決済フォームへリンクしてください。■必要パラメータ一覧
＜※1＞ 弊社管理画面上で、商品登録を行って頂きます。 自動課金をご利用頂く際は、「コンテンツ」商品として商品登録を行ってください。 ＜※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="pt" VALUE="1"> <INPUT TYPE="HIDDEN" NAME="iid" VALUE="item01"> <INPUT TYPE="submit" NAME="submit" VALUE="購入"> </FORM>
PCサイト決済時に必要なパラメータ
自動課金をご利用頂く際、管理画面にて事前に自動課金用の商品登録を行ってください。
その際に、課金周期・課金金額の情報をご設定頂きます。
項目 フィールド 詳細 必須 指定条件 店舗ID aid ご契約時に発行されます。 ▲ 定型 カード決済画面表示 pt 「1」をご指定下さい。 ▲ 定型 商品コード iid 管理画面で登録頂いた商品コードを ご指定下さい。※1 ▲ 半角英数 50字以内 店舗オーダー番号 cod オーダーを識別する為のパラメータを任意で送信することがで きます。 半角英数50字以内 決済フォーム英語表記 lang 英語「en」※未指定の場合、日本語表記 定型 電話番号 pn 指定頂くと、決済フォームの「電話番号」入力欄に自動的に セットされます。 半角数字（ハイフンなし） Eメール em 指定頂くと、決済フォームの「Eメール」入力欄に自動的に セットされます。 半角英数 その他データ その他 パラメータを自由に設定し、任意で送信することが出来ます。 ※2 指定なし1024Bite以内フィーチャーフォンサイト決済時に必要なパラメータ
■決済データ送信先URL
https://credit.j-payment.co.jp/
igateway
/payform.aspx
※HTML FORM /GET形式で決済フォームへリンクしてください。■必要パラメータ一覧
＜※1＞ 自動課金をご利用頂く際は、「コンテンツ」商品として商品登録を行ってください。 ＜※2＞ その他パラメータで、「改行コード」「スペース」を送信される場合、必ずエンコード処理を行ってください。■サンプルソース
<form action="https://credit.j-payment.co.jp/igateway/payform.aspx"method="get">
<input type="hidden"name="aid"value="100000">
<input type="hidden"name="pt"value="1">
<input type="hidden"name="cmd"value="0">
<input type="hidden"name="iid"value="item01">
<input type="submit"name="submit"value="購入">
</form>
項目 フィールド 詳細 必須 指定条件 店舗ID aid ご契約時に発行されます。 ▲ 定型 カード決済画面表示 pt 「1」をご指定下さい。 ▲ 定型 画面遷移方法 cmd 「0」をご指定下さい。 ▲ 定型 商品コード iid 管理画面で登録頂いた商品コードをご指定下さい。※1 ▲ 半角英数 50字以内 店舗オーダー番号 cod オーダーを識別する為のパラメータを任意で送信することがで きます。 半角英数50字以内 電話番号 pn 指定頂くと、決済フォームの「電話番号」入力欄に自動的に セットされます。 半角数字（ハイフンなし） Eメール em 指定頂くと、決済フォームの「Eメール」入力欄に自動的に セットされます。 半角英数 その他データ その他 パラメータを自由に設定し、任意で送信することが出来ます。 ※2 指定なし1024Bite以内 フィーチャーフォンサイト用の決済フォームをご利用頂く場合、決済データ送信元URLが PC用と一部ことなりますのでご注意ください。 また、HTML FORM /GET形式で決済フォームへリンクしてください。 （POST形式でリンクした場合、ER050が発生します）自動課金停止処理に必要なパラメータ
■決済データ送信先URL
https://credit.j-payment.co.jp/gateway/
acstop.aspx
※HTML FORM /GET形式で決済フォームへリンクしてください。■必要パラメータ一覧
＜※ご注意点＞ 自動課金停止に必要な情報 自動課金停止フォームでは、弊社発行の「ID/PASS」もしくは「自動課金番号」の入力が求められます。 これらは、決済完了画面、決済完了メールにてユーザー様に通知されております。 自動課金停止タイミング 自動課金の停止タイミングは、「即時」「次回課金日」のどちらかを選択頂きます。 管理画面、「決済システムの設定」よりお選びください。 ---Gateway方式での自動課金停止も可能です。 詳しくは、自動課金仕様書（Gateway方式）をご参照下さい。---■自動課金停止URL サンプル
https://credit.j-payment.co.jp/gateway/acstop.aspx?aid=
店舗ID
※上記URLの店舗IDの箇所をご契約時に弊社より発行している店舗IDに修正下さい。 ＜退会フォームログイン画面（サンプル）＞ ＜退会フォーム（サンプル）＞ 項目 フィールド 詳細 必須 指定条件 店舗ID aid ご契約時に発行されます。 ▲ 定型 決済フォーム英語表記 lang 英語「en」※未指定の場合、日本語表記 定型 自動課金停止パラメータをROBOT PAYMENT指定サーバに送信頂く事で、自動課金停止フォームが表示され、 外部からの自動課金停止処理が出来ます。 これにより、サイトユーザー様ご自身で、課金停止処理を行う仕組みを構築することが可能になります。 ※退会フォームログイン画面については、 自動課金番号を入力し、「次へ」ボタンをクリック下さい。 ログインID・パスワードについては、未入力で問題ございません。カード情報変更に必要なパラメータ
■決済データ送信先URL
https://credit.j-payment.co.jp/gateway
/cardinfo.aspx
※HTML FORM /GET形式で決済フォームへリンクしてください。■必要パラメータ一覧
■カード情報変更URL サンプル
https://credit.j-payment.co.jp/gateway/cardinfo.aspx?aid
=
店舗ID&tid=初回決済番号
■ユーザー向けメールからのカード情報変更
自動課金失敗時のユーザー向けメールに、上記カード情報変更フォームURLが自動的に記載されますので ユーザー様に変更方法をご認識頂けます。 項目 フィールド 詳細 必須 指定条件 店舗ID aid ご契約時に発行されます。 ▲ 定型 初回決済番号 tid 変更対象自動課金の初回決済番号 ▲ 定型 決済フォーム英語表記 lang 英語「en」※未指定の場合、日本語表記 定型 カード情報変更パラメータをROBOT PAYMENT指定サーバに送信頂く事で、カード情報変更フォームが表示され、 サイトユーザー様ご自身で、カード情報の変更を行うことが可能になります。 変更可能項目は、「カード番号」「カード名義」「有効期限」「メールアドレス」「電話番号」となります。 ＜カード情報変更フォームログイン画面（サンプル）＞ ※退会フォームログイン画面については、 自動課金番号を入力し、「次へ」ボタンをクリック下さい。 ログインID・パスワードについては、未入力で問題ございません。 ＜カード情報変更フォーム（サンプル）＞決済後に通知されるパラメータ（初回決済時）
項目 フィールド 詳細 必須 通知条件 決済番号 gid 決済ごとに発行されるユニークID。 ▲ 半角英数（8字） 決済結果 rst 決済成功「1」 決済失敗「2」 ▲ 半角数字（1字） カード会社承認番号 ap 決済ごとに発行されるユニークID ▲ 半角英数（6～7字） エラーコード ec 詳細はエラーコード一覧をご覧ください。※1 半角英数（12字） オーダーコード god 決済ごとに発行されるユニークID ▲ 半角数字（8字） 店舗オーダー番号 cod 決済データ送信時に送信された店舗オーダー番号。 半角英数（50字以内） 決済金額 am 決済データ送信時に送信された決済金額。 ▲ 半角数字 税金額 tx 決済データ送信時に送信された税額。 ▲ 半角数字 送料 sf 決済データ送信時に送信された送料。 ▲ 半角数字 合計金額 ta 決済金額＋税金額＋送料の値。 ▲ 半角数字発行ID id ROBOT PAYMENTシステムより発行されたID。 半角英数（50字以内）
発行パスワード ps ROBOT PAYMENTシステムより発行されたパスワード。 半角英数（50字以内） その他 決済データ送信時に送信されたその他データ。 指定なし（1024Bite以内） 自動課金番号 acid 対象の自動課金番号。 ▲ 半角英数（10字）
■キックバックパラメータ 一覧
＜※1＞ カード会社通信後エラー（Gから始まるエラーコード）のみキックバックします。 パラメータエラー（ERから始まるエラーコード）はキックバックしませんのでご注意ください。 貴社ご指定のURLに決済結果パラメータを通知することが可能です。 決済結果通知先URLは管理画面「決済システムの設定」よりご設定下さい。 初回決済の通知は「決済結果通知URL」に行われます。「自動課金結果通知URL」ではございませんのでご注意ください。 ※HTML GET 形式で指定のURLにキックバックします。 ※通知先URLの1行目にHTMLが出力されれば結果通知成功とみなします。■キックバック通知サンプル
決済結果通知URL？gid=4562114&rst=1&ap=TestMod&ec=&god=4562112&cod=
&am=1000&tx=0&sf=0&ta=1000&id=qlllqqaR&ps=f8DaQins&sonota&acid=282564
決済後に通知されるパラメータ（2回目以降の決済時）
項目 フィールド 詳細 必須 通知条件 決済番号 gid 決済ごとに発行されるユニークID。 ▲ 半角英数（8字） 決済結果 rst 決済成功「1」 決済失敗「2」 リトライ課金失敗「3」 ユーザー様による課金停止「4」 お試し期間中にリトライ2回課金失敗「5」 ▲ 半角数字（1字） 店舗オーダー番号 cod 決済データ送信時に送信された店舗オーダー番号。 半角英数（50字以内） 自動課金番号 acid 対象の自動課金番号。 ▲ 半角英数（10字） エラーコード ec 詳細はエラーコード一覧をご覧ください。 半角英数（12字） 発行ID id J-Paymentシステムより発行されたID。 半角英数（50字以内） 発行パスワード ps J-Paymentシステムより発行されたパスワード。 半角英数（50字以内）■キックバックパラメータ 一覧
＜ご注意点＞ 「その他」データは初回決済時にはキックバックされますが、2回目以降の課金時にはキックバックされません。 貴社ご指定のURLに自動課金結果パラメータを通知することが可能です。 自動課金通知先URLは管理画面「決済システムの設定」の「自動課金結果通知URL」でご設定下さい。 ※HTML GET 形式で指定のURLにキックバックします。 ※通知先URLの1行目にHTMLが出力されれば結果通知成功とみなします。＜キックバック通知 サンプル例＞
【決済結果(rst=1)：自動課金成功】例 http://自動課金通知先URL?gid=決済番号&rst=1&cod=初回決済時店舗オーダー番号 &acid=自動課金番号&id=発行済みID&ps=発行済みパスワード&ec=エラーコード 【決済結果(rst=2)：失敗】例(この通知後、自動課金は停止します) http://自動課金通知先URL?gid=決済番号&rst=2&cod=初回決済時店舗オーダー番号 &acid=自動課金番号&id=発行済みID&ps=発行済みパスワード&ec=エラーコード 【決済結果(rst=3)：リトライ有失敗】例 http://自動課金通知先URL?gid=決済番号&rst=3&cod=初回決済時店舗オーダー番号 &acid=自動課金番号&id=発行済みID&ps=発行済みパスワード&ec=エラーコード 【決済結果(rst=4)：ユーザーによる自動課金停止】例 http://自動課金通知先URL?gid=初回決済番号&rst=4&cod=初回決済時店舗オーダー番号 &acid=自動課金番号&id=発行済みID&ps=発行済みパスワード&ec=エラーコード決済確認メールについて
■決済確認メールについて
クレジットカード決済処理が終了後、 決済が成功した場合はクレジットカード決済を確認するEメールが 「加盟店様側」と「クレジットカード利用者側」との両方に送信されます。 決済確認Eメールには、決済番号や加盟店様のお問い合わせ電話番号とEメールアドレス、 および請求書に記載される請求社名が記載されます。 また、物販でご契約の加盟店様に関しましては、 決済時に仮売上確認メールがクレジットカード利用者と加盟店様に、 実売上処理時に実売上確認メールが「加盟店様側」と「クレジットカード利用者」にそれぞれ送信されま す。 ＜注意事項＞ ・クレジットカード利用者にメール送信する場合、 弊社管理画面トップ⇒「設定」⇒「決済システム設定」内、 お問合せ情報のお問合せ先メールアドレス（加盟店様のメールアドレス）を設定する必要が御座います 。 トラブル防止のためにもメールが送信されるように必ずメールアドレスの設定を御願いいたします。 ･クレジットカード利用者様へのメール文面のカスタマイズについては、 弊社管理画面トップ⇒「設定」⇒「ユーザー向けメール」内、 各ジョブタイプ（成功・失敗）・自動課金（成功・失敗・停止・期限）を修正する事が可能です。 ・加盟店様へメール送信する場合、 弊社管理画面トップ⇒「設定」⇒「決済システム設定」内、 ＜決済結果通知設定＞の「決済結果通知Eメール」にメールアドレス（加盟店様のメールアドレス）を、 設定頂いたメールアドレス宛送信いたします。 ※1：2回目以降のメール未送信をご希望の場合、 弊社管理画面トップ⇒「設定」⇒「決済システム設定」内、 <動作設定＞の「自動課金メール送信」を「送信しない」を選択下さい。 初回決済手続き時の確認メールは、通知され、 2回目以降のメール送信を未送信にする事が可能です。 項目 加盟店 利用者様 （エンドユーザー） 備考 自動課金成功 通知有り 選択可 利用者様宛てのメール送信設定可能※1 自動課金失敗 通知有り 選択可 利用者様宛てのメール送信設定可能※1 自動課金停止（停止URLより） 通知有り 通知有り 自動課金停止（管理画面内より） 通知無し 通知無し 設定に関わらず送信されません 有効期限通知 通知有り 通知有り カード情報変更（停止URLより） 通知有り 通知有り カード情報変更（管理画面内より） 通知無し 通知無し 設定に関わらず送信されません【自動課金結果 確認メール送信表】
決済テストの手順について
■テスト決済の流れ
①. ROBOT PAYMENTクレジットカード決済管理画面にて 「設定」－「決済システム設定」－「システムモード」を「テストモード」にする。 ②.決済時のカード番号を「4444333322221111」と入力する（テストカード） ※「クレジットカード有効期限」・「名義（姓・名）」については、 任意の値をご指定頂いて問題ございません。 ③.決済が成功した場合 1～2 秒後に決済が完了いたします。 ④.決済が失敗した場合 決済完了画面にエラーコードが表示されます。 ＜注意点＞ ・上記のテストカード以外に実在するカード番号を入力していただいた場合も決済テスト可能です。 ※システムモード：「テストモード」の場合は、カード会社側にデータ伝送されませんので、 実在するクレジットカードをご利用頂いた場合でも、ご請求されることはございません。 ・テストカードはテストモードのみ使用可能です。本番モードでは使用できません。 ・テストモードの場合、実際にカード会社と通信していません。売上が発生することはありません。 ・本番モードと同様に、決済完了メール等は送信されます。 ・テストモードで決済された情報は管理画面上に表示され、データを消すことが出来ません。◆《洗替サービス》 カードの有効期限が切れるユーザー様のカード有効期限を自動更新を行う機能です。 ユーザー様がご利用の発行元カード会社様により、 弊社とシステム上で連携が取れないユーザー様は、 自動的にユーザー様側に情報更新が取れるURLをメールにてご案内しております。 ※洗替サービスを行わない設定をご希望の際は、弊社カスタマーサポートまでお問合せ下さい。 ◆《自動課金停止処理》 自動課金を停止する処理です。停止処理を行った後の決済は行いません。 ◆《課金日指定》 2回目以降の自動課金日を指定することが出来ます。 毎月決まった日に決済を発生させることが可能です。 （注）：課金日指定「15日」を指定された場合、 初回決済日：1月14日の後、同じ1月の1月15日に課金処理が行われます。 ◆《課金開始（停止）回数、開始（停止）日》 2回目以降の自動課金回数や日にちを指定することが出来ます。希望の回数や、 日にちで自動課金を開始したり、停止したり設定することが可能です。 ◆《リトライ機能》 自動課金に失敗した際、自動的にリトライ決済が行われます。 課金周期が１ヶ月未満の商品 → 課金失敗の翌日にリトライ 課金周期が１ヶ月以上の商品 → 課金失敗の7日後にリトライ ※1 リトライは最大2回目行われ、2回目が失敗した際に自動課金が停止されます。 ※2 リトライ機能を停止する際は、弊社カスタマーサポートまでご連絡下さい。
