楽天カードマルチ決済サービス共通説明書

Size: px

Start display at page:

Download "楽天カードマルチ決済サービス共通説明書"

そうすけけいれい
5 years ago
Views:

1 楽天カードマルチ決済サービス共通説明書 ( 第版 )

2 改訂履歴番号バージョン年月日内容 /07/29 初版 /10/20 決済表現ドコモ id を id へ修正 /08/01 分社化に伴う修正 /11/01 問合せ先住所変更に伴う修正 /01/31 会員情報預かりサービス追加 /10/03 Edy 名称変更に伴う修正売上一部取消追加 /03/17 コンビニ決済 ( 統合 ) 導入に伴う修正 /08/18 問合せ先住所変更に伴う修正 /02/01 コンビニ決済サークル K サンクス追加に伴う支払可能コンビニ表の修正

3 目次 1 はじめに目的前提条件接続テスト接続テストの主な内容と事前準備について接続テストの主な内容接続テストの事前準備テスト環境利用にあたっての注意事項 API ユーザの作成についてログインユーザ登録その他接続テスト全般について申込関連申請書関連送付先について申込情報の変更方法について店舗情報の変更口座情報の変更マルチ決済サービスの追加申込方法についてマルチ決済サービスの解約方法について決済関連提供サービスについてカード決済についてご利用可能なクレジットカード会社について SSL CVV2 3D セキュアについて売上取消の実施可能期間について

4 4.3 コンビニ決済についてお支払可能なコンビニについて収納依頼について収納取消についてペイジー決済についてお支払可能な金融機関について電子マネー決済についてご利用可能な決済方法について会員情報預かりサービスについてご利用可能なサービスについてご利用可能な決済方法について会員 ID の発番精算関連ボーナス払いについてボーナス払いの受付期間についてボーナス払いの振込みについてその他精算関連その他マルチ決済サービスについての問い合わせ先受注番号についてタイムアウトの設定について文字コードについて禁則文字について

5 1 はじめに 1.1 目的本書は提携サイト様システムと楽天カードが提供するマルチ決済サービスを接続する際の仕様を記述したドキュメントです 1.2 前提条件楽天カード ( 決済代行会社 ) サーバと https 通信が可能な環境が必要となります API 方式を利用する場合は以下の Java 実行環境が必要となります Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_10-b03) WEB サービス方式画面リンク方式を利用する場合は上記の実行環境は不要です - 5 -

6 2 接続テストサービス開始までに大きく2つの接続テストフェーズがあります 1. テスト店舗を利用した疎通テスト ( 申込 ~ 契約完了 ) テスト店舗の情報を利用してマルチ決済サービスとの接続テストを行います 2. 実店舗を利用した疎通テスト ( 契約完了後 ~) 提携サイト様の実際の情報を利用してマルチ決済サービスとの接続テストを行います 2.1 接続テストの主な内容と事前準備について接続テストの主な内容カードコンビニペイジー電子マネー決済依頼マルチ決済サービスを利用する全ての提携サイト様必須のテストです取引状態の確認 API 方式 WEB サービス方式を利用する提携サイト様必須のテストです画面リンク方式をご利用の場合はこのテストは不要です会員情報預かりサービス会員 ID 預かりサービスを利用する全ての提携サイト様必須のテストです接続テストの事前準備 1. テスト店舗を利用した疎通テスト ( 申込 ~ 契約完了 ) テスト店舗の情報を弊社担当者からご連絡します提携サイト様システムへテスト店舗情報を設定いただくことで接続テストの実施が可能となります 2. 実店舗を利用した疎通テスト ( 契約完了後 ~) 接続テストで利用するカード番号をご提出ください契約完了後提携サイト様の情報を弊社担当者からご連絡します API ユーザを作成していただくことで接続テストの実施が可能となります - 6 -

2.1.3 テスト環境利用にあたっての注意事項弊社の接続テスト実施環境は負荷テストを想定した設計となっておりません他の提携サイト様のテストに影響を及ぼしますので接続テスト環境を利用しての負荷テストはご遠慮ください接続テスト実施中に発生したエラーなどのお問い合せについてはメールにて承ります弊社担当者へメールにてお問い合せいただきますようお願いいたします 2.

7 2.1.3 テスト環境利用にあたっての注意事項弊社の接続テスト実施環境は負荷テストを想定した設計となっておりません他の提携サイト様のテストに影響を及ぼしますので接続テスト環境を利用しての負荷テストはご遠慮ください接続テスト実施中に発生したエラーなどのお問い合せについてはメールにて承ります弊社担当者へメールにてお問い合せいただきますようお願いいたします 2.2 API ユーザの作成について実店舗を利用した疎通テストを行う際は必ず API ユーザを作成する必要があります以下の手順で API ユーザの作成を行ってくださいログインブラウザより以下の URL を入力してログイン画面を表示します弊社担当者よりご連絡いたしました管理者権限のログイン情報を入力後ログインを押下します初回ログインの場合パスワードの変更が必要となります - 7 -

8 2.2.2 ユーザ登録 1. メインメニューから店舗様ご利用ユーザ作成リンクを押下してください 2. 入力項目を全て入力後登録するボタンを押下します項目名説明ユーザ ID ログイン時に使用するユーザ ID です店舗内でユニークな半角英数字で 6 文字以内で入力してくださいなお一度登録したユーザ ID は以降変更できませんのでご注意くださいユーザ名ユーザ名を設定します全角 15 桁半角 30 桁以内で入力してくださいパスワードログイン時に使用するパスワードです半角英数字 6 桁以上 10 桁以内数値 / 大文字 / 小文字混在で入力してくださいユーザ権限 API ユーザを選択してください利用開始日該当ユーザが本システム利用が可能になる日付です 1 利用終了日該当ユーザが本システム利用が不可になる日付です利用終了日は利用開始日よりも未来日を指定してください状態該当ユーザのシステム利用可能有無を表します初期値は有効が選択されます 1: 利用開始日が現在日時よりも未来の場合や利用終了日が現在日時を超過している場合は該当ユーザは本システムへのログインができなくなりますご注意ください - 8 -

9 2.3 その他接続テスト全般についてテスト店舗を利用した接続テストの場合は受注番号の下 2 桁を変更することで提携サイト様システムへ返却するレスポンスの値を変更することが可能です設定する値と返却レスポンスコードについては補足 : 受注番号におけるレスポンス条件.pdf をご参照ください - 9 -

10 3 申込関連 3.1 申請書関連送付先について名称楽天カード株式会社楽天カードペイメントサポートセンター住所福岡県福岡市中央区天神天神ノースフロントビル TEL 営業時間平日 9:15 ~ 17:30 (12/29 から 1/3 を除く ) 3.2 申込情報の変更方法について店舗情報の変更店舗情報の変更を希望される場合は店舗情報変更申請書に記入捺印の上 3.1 申請書関連送付先までお送りください口座情報の変更口座情報の変更を希望される場合は口座情報変更申請書に記入捺印の上 3.1 申請書関連送付先までお送りください 3.3 マルチ決済サービスの追加申込方法についてマルチ決済サービスのサービス追加を希望される場合はサービス追加申請書に記入捺印の上 3.1 申請書関連送付先までお送りください 3.4 マルチ決済サービスの解約方法についてマルチ決済サービスの解約を希望される場合はサービス解約申請書に記入捺印の上 3.1 申請書関連送付先までお送りください

11 4 決済関連 4.1 提供サービスについてマルチ決済サービスにて提供しているサービスは以下の表の通りです提供サービスカード決済コンビニ決済ペイジー決済電子マネー決済会員情報預かりサービス決済提供方式 API 方式 WEB サービス方式画面リンク方式カード有効性チェックオーソリ依頼オーソリ取消売上売上取消売上一部取消カード決済取引照会収納依頼収納取消コンビニ決済取引照会収納依頼ペイジー決済取引照会決済依頼 id 入金取消電子マネー決済取引照会会員情報登録会員情報変更会員情報照会会員 ID 利用カード有効性チェック会員 ID 利用オーソリ会員 ID 利用 3D 認証可否確認継続課金情報登録会員情報削除

12 4.2 カード決済についてご利用可能なクレジットカード会社についてマルチ決済サービスが提供しているカード決済サービスで利用可能なカード会社は以下の表の通りですカード会社名楽天カード VISA MasterCard JCB American Express Diners SSL CVV2 3D セキュアについてマルチ決済サービスのカード決済ではカードの不正利用リスクを軽減するために 3 つの認証方式を採用しています提携サイト様のシステムに応じて選択いただくことが可能です決済提供方式決済方式クレジットカード決済 SSL CVV2 3D 画面リンク方式 PC WEB サービス方式 API 方式 PC モバイル PC モバイル売上取消の実施可能期間について売上取消は売上を実施した日から 60 日経過するまで実施可能です ( 売上を実施した日から数えて 60 日目から実施できなくなります ) 売上一部取消は売上を実施した日から 1 年経過するまで実施可能です

13 4.3 コンビニ決済についてお支払可能なコンビニについてマルチ決済サービスが提供しているコンビニ決済サービスでお支払可能なコンビニは以下の表の通りです支払可能コンビニセブンイレブンローソンファミリーマートミニストップセイコーマートサークル K サンクスデイリーヤマザキスリーエフ提携サイト様の審査結果によっては利用できないコンビニもございます審査結果通知メールをご確認ください収納依頼について収納依頼時の決済ステータス収納依頼時に設定いただく自動リトライフラグと各収納代行会社への収納依頼の処理結果により決済ステータスは下記となります自動リトライフラグ収納依頼処理結果決済ステータスリトライしない全社成功入金待ち一部失敗決済破棄全社失敗決済破棄リトライする全社成功入金待ち一部失敗入金待ち全社失敗未連携決済ステータス入金待ちについて一社以上の収納代行会社への収納依頼が成功し購入者様がお支払可能な状態です詳細エラーコード : 正常終了が返却されます

14 また収納依頼に失敗した収納代行会社が存在する場合はマルチ決済サービスが収納依頼のリトライ処理を行いますリトライ処理の収納依頼が成功次第対象の収納代行会社についても随時お支払が可能となります決済ステータス未連携について店舗様からの収納依頼はマルチ決済サービスとしてお受けしましたが収納代行会社への収納依頼はまだ成功しておらず購入者様がお支払できない状態です詳細エラーコード : 処理正常が返却されますただしマルチ決済サービスが収納依頼のリトライ処理を行いますので一社でも収納代行会社への収納依頼が成功した時点で決済ステータスが未連携から入金待ちとなります決済ステータス決済破棄について店舗様からの収納依頼をマルチ決済サービスとして正常にお受けできず購入者様がお支払できない状態です詳細エラーコード : 収納依頼 NG が返却されますマルチ決済サービスとしてリトライ処理を行いませんのでお手数ですが店舗様にて再度収納依頼の実施を行っていただく必要があります収納取消について収納取消時の決済ステータス各収納代行会社への収納取消の処理結果により決済ステータスは下記となります収納取消処理結果決済ステータス全社成功収納取消一部失敗入金待ち全社失敗入金待ち処理前と変更ありません決済ステータス収納取消について収納代行会社への収納取消が成功し購入者様がお支払できない状態です詳細エラーコード : 正常終了が返却されます

15 例 ) 1 店舗様から収納取消のご依頼をいただく 2マルチ決済サービスより野村総研イーコンテクストウェルネットの計三社に対し収納取消の依頼を行う 3 収納取消処理が三社全て成功する 4マルチ決済サービスにより決済ステータスが入金待ちから収納取消となる決済ステータス入金待ちについて店舗様からの収納取消はマルチ決済サービスとしてお受けしましたが一社以上の収納代行会社への収納取消に成功していない状態です詳細エラーコード : 収納取消 ( リトライ対象 ) エラーが返却されますただしマルチ決済サービスとして収納取消のリトライ処理を行いますので全社収納取消に成功した時点で決済ステータスが入金待ちから収納取消となりますまた既にお客様から入金が行われていたため収納取消に失敗していた場合一定時間後決済ステータスは入金待ちから入金済となります例 ) 1 店舗様から収納取消のご依頼をいただく 2マルチ決済サービスより野村総研イーコンテクストウェルネットの計三社に対し収納取消の依頼を行う 3 収納取消処理が野村総研イーコンテクストのみ成功しウェルネットの収納取消処理が失敗 4 決済ステータスは入金待ちのままでマルチ決済サービスがウェルネットに対し収納取消のリトライ処理を行う 5ウェルネットへのリトライ処理の結果収納取消に成功 6マルチ決済サービスにより決済ステータスが入金待ちから収納取消となる 4.4 ペイジー決済についてお支払可能な金融機関についてマルチ決済サービスが提供しているペイジー決済サービスでお支払可能な金融機関は以下の表の通りです支払い方法金融機関一覧ネットバンキング ATM

16 4.5 電子マネー決済についてご利用可能な決済方法についてマルチ決済サービスが提供している電子マネー決済サービスで利用可能な決済方法は以下の表の通りです電子マネー決済 id 楽天 Edy(Cyber Edy) 楽天 Edy(Mobile Edy) 提携サイト様の審査結果によっては利用できない決済方式もございます審査結果通知メールをご確認ください画面リンク方式は 2010 年 8 月時点で電子マネー決済に対応しておりません電子マネー決済を利用するためには API 方式 WEB サービス方式の何れかの方式である必要があります 4.6 会員情報預かりサービスについてご利用可能なサービスについて会員情報預かりサービスを利用する場合以下のサービスを利用することが可能です個人情報預かりサービス提携サイト様が発行する会員 ID と共に会員 ID に紐付く顧客の個人情報を提携サイト様に代わりマルチ決済サービスにて保持します会員 ID 指定決済マルチ決済サービスに登録済みの会員 ID を指定することで購入者は個人情報を入力することなく決済処理を行うことができます継続課金決済予め登録されたカード情報課金タイミングから自動的に課金 ( オーソリ売上 ) を実施できますご利用可能な決済方法についてカード決済のみ利用可能です

17 4.6.3 会員 ID の発番会員 ID は店舗様にて発番して下さいまたマルチ決済サービスでは会員 ID で購入者様を一意とします

18 5 精算関連 5.1 ボーナス払いについてカード決済ではボーナス払いが利用可能ですボーナス払いの受付期間についてボーナス払いはオーソリ売上を受付ける期間が決まっておりますボーナス種別オーソリ可能期間売上可能期間夏 12 月 16 日 ~ 6 月 15 日 12 月 16 日 ~ 6 月 25 日冬 7 月 16 日 ~11 月 15 日 7 月 16 日 ~11 月 25 日ボーナス払いの振込みについてボーナス払い分の店舗様への振込みは以下のスケジュールで行いますボーナス種別振込日夏 8 月 31 日 ( 非営業日の場合翌営業日 ) 冬 1 月 31 日 ( 非営業日の場合翌営業日 ) 5.2 その他精算関連ショップ締回数や振込日ショップ手数料など手数料関連については契約内容を確認ください

19 6 その他 6.1 マルチ決済サービスについての問い合わせ先マルチ決済サービスのシステムに関するお問い合せは以下の宛先へメールにてお問い合せください営業時間平日 9:00 ~ 17:30 (12/29 から 1/3 を除く ) 6.2 受注番号についてマルチ決済サービスでは受注番号で取引を一意としますそのため同一の受注番号で以下の処理を重複して依頼することは出来ません受注番号は重複しないようご注意くださいカード有効性チェックオーソリ収納依頼 ( コンビニ決済 ) 収納依頼 ( ペイジー決済 ) 決済依頼 ( 電子マネー決済 )

20 6.3 タイムアウトの設定について提携サイト様システムとマルチ決済システムとの通信タイムアウト時間は 90 秒以上を設定してください 6.4 文字コードについてマルチ決済システムで利用する文字コードは Shift-JIS となっております 6.5 禁則文字について以下にあげる文字の範囲以外の入力は入力不可能文字となっております使用可能な文字の範囲 (JISX0208 表記 ): 01 区 ~08 区 : 各種記号かな等 16 区 ~47 区 :JIS 第一水準漢字 48 区 ~84 区 :JIS 第二水準漢字

PowerPoint プレゼンテーション

PowerPoint プレゼンテーション SBPS 決済カゴラボ操作ガイド SBPS 2013 年 10 月現在版 (ver.1.0.0) お問い合せはこちらまでカゴラボサポートセンター 0120-713-362 ( 携帯電話からは 0985-23-3362 ) E-mail : support@cagolab.jp 受付時間 : 平日 10:00~12:00/13:00~18:00 ( 祝祭日及び弊社休業日を除く ) 提供企業 : 株式会社アラタナ

楽天カード マルチ決済サービス共通 説明書

楽天カードマルチ決済サービス共通説明書