J-Payment クレジットカード 決済システム接続仕様書

Transcription

1 クレジットカード決済 HTML LINK 方式接続仕様書 ( 自動課金専用 )

2 目次 概要 :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 2

3 HTMLリンク方式 概要 決済に必要な情報を パラメータとして弊社サーバに送信して頂く事で ROBOT PAYMENT専用の決済フォームを呼び出します クレジットカード情報は 弊社サーバ上で入力頂きますので 貴社でカード 情報を管理する必要は一切ございません また 特別なソフトウェアや機材等は不要です HTML形式のリンク設定を頂くだけで 簡単に導入する事が可能です 決済フォームサンプル 3

4 自動課金 概要 自動課金機能をご利用頂く事で 一定額を定期的に課金する仕組みを構築できます 定期的な課金は自動的に行われるので 運用の手間が比較的少なくシステムを導入頂けます また 貴社側でカード番号を保有する必要は一切ございません 初回の入会金のみ別の金額を課金し 2 回目以降の一定額を継続課金するような課金体系にも対応しております 以下のような事業者様にご利用頂いています 物販の定期購入サイト様 有料会員制サイト様 月謝制の学習塾様 定期募金 寄付金を募られている団体様 サービス利用料定期的に課金される事業者様 4

5 PC サイト決済時に必要なパラメータ 自動課金をご利用頂く際 管理画面にて事前に自動課金用の商品登録を行ってください その際に 課金周期 課金金額の情報をご設定頂きます 決済データ送信先 URL HTML FORM POST/GET 形式で決済フォームへリンクしてください 必要パラメータ一覧 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 カード決済画面表示 pt 1 をご指定下さい 定型 商品コード iid 管理画面で登録頂いた商品コードを ご指定下さい 1 半角英数 50 字以内 店舗オーダー番号 cod オーダーを識別する為のパラメータを任意で送信することがで きます 半角英数 50 字以内 決済フォーム英語表記 lang 英語 en 未指定の場合 日本語表記定型 電話番号 pn 指定頂くと 決済フォームの 電話番号 入力欄に自動的に セットされます Eメール em 指定頂くと 決済フォームの Eメール 入力欄に自動的に セットされます 半角数字 ( ハイフンなし ) 半角英数 その他データ その他 パラメータを自由に設定し 任意で送信することが出来ます 2 指定なし 1024Bite 以内 < 1> 弊社管理画面上で 商品登録を行って頂きます 自動課金をご利用頂く際は コンテンツ 商品として商品登録を行ってください < 2> その他パラメータで 改行コード スペース を送信される場合 必ずエンコード処理を行ってください サンプルソース <FORM ACTION=" <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> 5

6 フィーチャーフォンサイト決済時に必要なパラメータ フィーチャーフォンサイト用の決済フォームをご利用頂く場合 決済データ送信元 URL が PC 用と一部ことなりますのでご注意ください また HTML FORM /GET 形式で決済フォームへリンクしてください (POST 形式でリンクした場合 ER050 が発生します ) 決済データ送信先 URL HTML FORM /GET 形式で決済フォームへリンクしてください 必要パラメータ一覧 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 カード決済画面表示 pt 1 をご指定下さい 定型 画面遷移方法 cmd 0 をご指定下さい 定型 商品コード iid 管理画面で登録頂いた商品コードをご指定下さい 1 半角英数 50 字以内 店舗オーダー番号 cod オーダーを識別する為のパラメータを任意で送信することがで きます 半角英数 50 字以内 電話番号 pn 指定頂くと 決済フォームの 電話番号 入力欄に自動的に セットされます 半角数字 ( ハイフンなし ) Eメール em 指定頂くと 決済フォームの Eメール 入力欄に自動的に セットされます 半角英数 その他データ その他 パラメータを自由に設定し 任意で送信することが出来ます 2 指定なし 1024Bite 以内 < 1> 自動課金をご利用頂く際は コンテンツ 商品として商品登録を行ってください < 2> その他パラメータで 改行コード スペース を送信される場合 必ずエンコード処理を行ってください サンプルソース <form action=" <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> 6

7 自動課金停止処理に必要なパラメータ 自動課金停止パラメータを ROBOT PAYMENT 指定サーバに送信頂く事で 自動課金停止フォームが表示され 外部からの自動課金停止処理が出来ます これにより サイトユーザー様ご自身で 課金停止処理を行う仕組みを構築することが可能になります 決済データ送信先 URL HTML FORM /GET 形式で決済フォームへリンクしてください 必要パラメータ一覧 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 決済フォーム英語表記 lang 英語 en 未指定の場合 日本語表記定型 < ご注意点 > 自動課金停止に必要な情報自動課金停止フォームでは 弊社発行の ID/PASS もしくは 自動課金番号 の入力が求められます これらは 決済完了画面 決済完了メールにてユーザー様に通知されております 自動課金停止タイミング自動課金の停止タイミングは 即時 次回課金日 のどちらかを選択頂きます 管理画面 決済システムの設定 よりお選びください Gateway 方式での自動課金停止も可能です 詳しくは 自動課金仕様書 (Gateway 方式 ) をご参照下さい 自動課金停止 URL サンプル 店舗 ID 上記 URL の店舗 ID の箇所をご契約時に弊社より発行している店舗 ID に修正下さい < 退会フォームログイン画面 ( サンプル )> < 退会フォーム ( サンプル )> 退会フォームログイン画面については 自動課金番号を入力し 次へ ボタンをクリック下さい ログイン ID パスワードについては 未入力で問題ございません 7

8 カード情報変更に必要なパラメータ カード情報変更パラメータを ROBOT PAYMENT 指定サーバに送信頂く事で カード情報変更フォームが表示され サイトユーザー様ご自身で カード情報の変更を行うことが可能になります 変更可能項目は カード番号 カード名義 有効期限 メールアドレス 電話番号 となります 決済データ送信先 URL HTML FORM /GET 形式で決済フォームへリンクしてください 必要パラメータ一覧 項目フィールド詳細必須指定条件 店舗 ID aid ご契約時に発行されます 定型 初回決済番号 tid 変更対象自動課金の初回決済番号 定型 決済フォーム英語表記 lang 英語 en 未指定の場合 日本語表記定型 カード情報変更 URL サンプル 店舗 ID&tid= 初回決済番号 ユーザー向けメールからのカード情報変更 自動課金失敗時のユーザー向けメールに 上記カード情報変更フォーム URL が自動的に記載されますのでユーザー様に変更方法をご認識頂けます < カード情報変更フォームログイン画面 ( サンプル )> < カード情報変更フォーム ( サンプル )> 退会フォームログイン画面については 自動課金番号を入力し 次へ ボタンをクリック下さい ログイン ID パスワードについては 未入力で問題ございません 情報変更フォームについては カード情報以外に 電話番号 メールアドレス を 変更することが可能です 8

9 決済後に通知されるパラメータ ( 初回決済時 ) 貴社ご指定の URL に決済結果パラメータを通知することが可能です 決済結果通知先 URL は管理画面 決済システムの設定 よりご設定下さい 初回決済の通知は 決済結果通知 URL に行われます 自動課金結果通知 URL ではございませんのでご注意ください HTML GET 形式で指定の URL にキックバックします 通知先 URL の 1 行目に HTML が出力されれば結果通知成功とみなします キックバックパラメータ 一覧 項目フィールド詳細必須通知条件 決済番号 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?gid= &rst=1&ap=TestMod&ec=&god= &cod= &am=1000&tx=0&sf=0&ta=1000&id=qlllqqar&ps=f8daqins&sonota&acid=

10 決済後に通知されるパラメータ (2 回目以降の決済時 ) 貴社ご指定の URL に自動課金結果パラメータを通知することが可能です 自動課金通知先 URL は管理画面 決済システムの設定 の 自動課金結果通知 URL でご設定下さい HTML GET 形式で指定の URL にキックバックします 通知先 URL の 1 行目に HTML が出力されれば結果通知成功とみなします キックバックパラメータ 一覧 項目フィールド詳細必須通知条件 決済番号 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 回目以降の課金時にはキックバックされません < キックバック通知サンプル例 > 決済結果 (rst=1): 自動課金成功 例 自動課金通知先 URL?gid= 決済番号 &rst=1&cod= 初回決済時店舗オーダー番号 &acid= 自動課金番号 &id= 発行済み ID&ps= 発行済みパスワード &ec= エラーコード 決済結果 (rst=2): 失敗 例 ( この通知後 自動課金は停止します ) 自動課金通知先 URL?gid= 決済番号 &rst=2&cod= 初回決済時店舗オーダー番号 &acid= 自動課金番号 &id= 発行済み ID&ps= 発行済みパスワード &ec= エラーコード 決済結果 (rst=3): リトライ有失敗 例 自動課金通知先 URL?gid= 決済番号 &rst=3&cod= 初回決済時店舗オーダー番号 &acid= 自動課金番号 &id= 発行済み ID&ps= 発行済みパスワード &ec= エラーコード 決済結果 (rst=4): ユーザーによる自動課金停止 例 自動課金通知先 URL?gid= 初回決済番号 &rst=4&cod= 初回決済時店舗オーダー番号 &acid= 自動課金番号 &id= 発行済み ID&ps= 発行済みパスワード &ec= エラーコード 決済結果 (rst=5): お試し課金中のリトライ 2 回失敗自動課金停止 例 自動課金通知先 URL?gid= 初回決済番号 &rst=4&cod= 初回決済時店舗オーダー番号 &acid= 自動課金番号 &id= 発行済み ID&ps= 発行済みパスワード &ec= エラーコード 通常 自動課金が失敗した場合の決済結果の通知の流れは rst=3( 失敗 1 回目 ) rst=3( 失敗 2 回目 ( リトライ 1 回目 )) rst=2( 失敗 3 回目 ( リトライ 2 回目 ) 停止 ) となります 10

11 決済確認メールについて 決済確認メールについて クレジットカード決済処理が終了後 決済が成功した場合はクレジットカード決済を確認する E メールが 加盟店様側 と クレジットカード利用者側 との両方に送信されます 決済確認 E メールには 決済番号や加盟店様のお問い合わせ電話番号と E メールアドレス および請求書に記載される請求社名が記載されます また 物販でご契約の加盟店様に関しましては 決済時に仮売上確認メールがクレジットカード利用者と加盟店様に 実売上処理時に実売上確認メールが 加盟店様側 と クレジットカード利用者 にそれぞれ送信されます < 注意事項 > クレジットカード利用者にメール送信する場合 弊社管理画面トップ 設定 決済システム設定 内 お問合せ情報のお問合せ先メールアドレス ( 加盟店様のメールアドレス ) を設定する必要が御座います トラブル防止のためにもメールが送信されるように必ずメールアドレスの設定を御願いいたします クレジットカード利用者様へのメール文面のカスタマイズについては 弊社管理画面トップ 設定 ユーザー向けメール 内 各ジョブタイプ ( 成功 失敗 ) 自動課金 ( 成功 失敗 停止 期限 ) を修正する事が可能です 加盟店様へメール送信する場合 弊社管理画面トップ 設定 決済システム設定 内 < 決済結果通知設定 > の 決済結果通知 E メール にメールアドレス ( 加盟店様のメールアドレス ) を 設定頂いたメールアドレス宛送信いたします 自動課金結果確認メール送信表 項目 加盟店 利用者様 ( エンドユーザー ) 備考 自動課金成功 通知有り 選択可 利用者様宛てのメール送信設定可能 1 自動課金失敗 通知有り 選択可 利用者様宛てのメール送信設定可能 1 自動課金停止 ( 停止 URLより ) 通知有り 通知有り 自動課金停止 ( 管理画面内より ) 通知無し 通知無し 設定に関わらず送信されません 有効期限通知 通知有り 通知有り カード情報変更 ( 停止 URLより ) 通知有り 通知有り カード情報変更 ( 管理画面内より ) 通知無し 通知無し 設定に関わらず送信されません 1:2 回目以降のメール未送信をご希望の場合 弊社管理画面トップ 設定 決済システム設定 内 < 動作設定 > の 自動課金メール送信 を 送信しない を選択下さい 初回決済手続き時の確認メールは 通知され 2 回目以降のメール送信を未送信にする事が可能です 11

12 決済テストの手順について テスト決済の流れ 1. ROBOT PAYMENT クレジットカード決済管理画面にて 設定 - 決済システム設定 - システムモード を テストモード にする 2. 決済時のカード番号を と入力する ( テストカード ) クレジットカード有効期限 名義 ( 姓 名 ) については 任意の値をご指定頂いて問題ございません 3. 決済が成功した場合 1~2 秒後に決済が完了いたします 4. 決済が失敗した場合決済完了画面にエラーコードが表示されます < 注意点 > 上記のテストカード以外に実在するカード番号を入力していただいた場合も決済テスト可能です システムモード : テストモード の場合は カード会社側にデータ伝送されませんので 実在するクレジットカードをご利用頂いた場合でも ご請求されることはございません テストカードはテストモードのみ使用可能です 本番モードでは使用できません テストモードの場合 実際にカード会社と通信していません 売上が発生することはありません 本番モードと同様に 決済完了メール等は送信されます テストモードで決済された情報は管理画面上に表示され データを消すことが出来ません 12

13 機能一覧 洗替サービス カードの有効期限が切れるユーザー様のカード有効期限を自動更新を行う機能です ユーザー様がご利用の発行元カード会社様により 弊社とシステム上で連携が取れないユーザー様は 自動的にユーザー様側に情報更新が取れる URL をメールにてご案内しております 洗替サービスを行わない設定をご希望の際は 弊社カスタマーサポートまでお問合せ下さい 自動課金停止処理 自動課金を停止する処理です 停止処理を行った後の決済は行いません 課金日指定 2 回目以降の自動課金日を指定することが出来ます 毎月決まった日に決済を発生させることが可能です ( 注 ): 課金日指定 15 日 を指定された場合 初回決済日 :1 月 14 日の後 同じ 1 月の 1 月 15 日に課金処理が行われます 課金開始 ( 停止 ) 回数 開始 ( 停止 ) 日 2 回目以降の自動課金回数や日にちを指定することが出来ます 希望の回数や 日にちで自動課金を開始したり 停止したり設定することが可能です リトライ機能 自動課金に失敗した際 自動的にリトライ決済が行われます 課金周期が1ヶ月未満の商品 課金失敗の翌日にリトライ 課金周期が1ヶ月以上の商品 課金失敗の7 日後にリトライ 1 リトライは最大 2 回目行われ 2 回目が失敗した際に自動課金が停止されます 2 リトライ機能を停止する際は 弊社カスタマーサポートまでご連絡下さい 13