楽天ペイV2（随時決済）

概要

楽天ペイ（オンライン決済）V2（以下「楽天ペイV2」）随時決済は、楽天ペイ（オンライン決済）における「汎用決済」です。
お客様から事前に利用承諾を1度取得すると、加盟店様の任意のタイミングで決済（随時決済）を行うことができる決済方法です。
利用承諾が継続している間は、利用承諾時に発行された楽天サブスクリプションIDを指定することにより、お客様は決済操作せずに決済を行う事が可能です。

利用承諾のみでは請求は発生せず、加盟店様が明示的に決済処理を実行した時点で課金が確定します。

overview

決済金額の上限：9,999,999円
決済金額の下限：100円
100円未満の決済が必要な場合は事前に楽天へお問い合わせください
利用可能地域 / 通貨：日本 / JPY
返金 / 金額変更：可 / 可

楽天ペイV2（随時決済）を始めるには

契約の確認・申込
ご利用には楽天ペイV2随時決済の契約および楽天による審査が必要です。
随時決済は、都度決済とは別途楽天へ申込が必要ですのでお問い合わせください。

サービスリリース前に楽天レギュレーション^※の対応状況を確認する表記審査・システムチェックがございます。
実装前に楽天レギュレーションをご確認ください。詳細は楽天ペイメント株式会社へお問い合わせください。
※楽天レギュレーション：楽天ペイメント株式会社が定める加盟店向けの表記・システム規則
テスト環境での動作確認
テスト環境に関する情報はこちらを確認してください。
本番稼働開始
動作確認完了後、本番運用を開始します。テスト環境⇒本番環境への切り替えチェックリストはこちら

接続方式のサポート

接続方式	サポート状況	関連リンク
OpenAPIタイプ	✔ 対応	API仕様
プロトコルタイプ	✔ 対応	API仕様（idPass） API仕様（json）
リンクタイプ Plus	✖ 非対応

利用承諾状態

楽天ペイV2（随時決済）で取り得る利用承諾状態は以下の通りです。

利用承諾状態	コード	説明
未決済	`UNPROCESSED`	利用承諾が完了していない状態（お客様のご注文途中の離脱が主な原因）
要求成功	`REQSUCCESS`	利用承諾を行う準備が整った状態（まだ利用承諾は完了していません）
認証処理中	`AUTHPROCESS`	楽天ペイでの認証中の状態
利用承諾	`REGISTER`	利用承諾が正常に完了した状態
決済失敗	`PAYFAIL`	お客様による利用承諾の中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態
期限切れ	`EXPIRED`	要求成功／認証処理中の状態を一定時間経過した状態

随時決済取引状態

楽天ペイV2（随時決済）で取り得る取引状態は以下の通りです。

取引状態	コード	説明
未決済	`UNPROCESSED`	決済が完了していない状態（お客様のご注文途中の離脱が主な原因）
仮売上	`AUTH`	決済が正常に完了し、ご利用枠を確保した状態
実売上	`SALES`	売上が確定した状態
即時売上	`CAPTURE`	仮売上を行わず、売上を確定した状態
キャンセル	`CANCEL`	仮売上の取引がキャンセルされた状態
返金	`RETURN`	売上を確定した取引がキャンセルされた状態
決済失敗	`PAYFAIL`	お客様による支払い中断や、システムトラブル等の何らかの原因でお支払いに失敗してしまった状態
期限切れ	`EXPIRED`	要求成功の状態を一定時間経過した状態

利用承諾

楽天ペイV2随時決済では、利用承諾の取得方法として2つのパターンがあります。

パターン1：利用承諾のみ

お客様から利用承諾のみを取得するパターンです。
この時点では課金は発生せず、後続の随時決済で課金を実行します。

利用シーン例

サブスクリプションサービスの初回登録時

継続利用サービスへの加入手続き

パターン2：利用承諾+都度決済

利用承諾と都度決済を同時に実行できるパターンです。
初回購入と同時に利用承諾を取得し、以降は随時決済で課金を行います。

利用シーン例

初回購入と同時にサブスクリプション登録

初回課金を伴う継続サービスへの加入

実売上

実売上可能期間

実売上は最後の仮売上日^※1から30日後まで、かつ初回の仮売上日から365日後^※2まで可能です。
※1 「最後の仮売上日」：仮売上、金額変更、仮売上有効期限延長の最終実施日
※2 対象取引の更新が無い場合は原則180日でデータが削除され、以降は処理ができなくなります。
　　金額変更、仮売上有効期限延長により取引を更新した場合の最大日数が365日後となりますのでご注意ください。

期限を超過した場合はエラー（期限切れ）となり、売上確定できません。

仮売上有効期限の延長

同額で金額変更のAPIを実行することで、仮売上有効期限の延長が可能です。
再オーソリを行うため、お客様の限度額を超えた場合は失敗する可能性があります。

仮売上有効期限延長可能回数：一つの取引に対し、成功・失敗合わせて15回までです。
可能回数を超えた場合は「RP1000006」エラーが返却されます。
仮売上有効期限延長可能期間：初回の仮売上日から365日後^※1まで
かつ最後の仮売上日^※2から160日後まで

※1 対象取引の更新が無い場合は原則180日でデータが削除され、以降は処理ができなくなります。
　　金額変更、仮売上有効期限延長により取引を更新した場合の最大日数が365日後となりますのでご注意ください。
※2 「最後の仮売上日」とは、仮売上、金額変更、仮売上有効期限延長の最終実施日を指します。

返金

キャンセル操作は取引状態によりキャンセル可能期間が異なります。

取引状態	キャンセル可能期間
仮売上	初回の仮売上日から365日後^※まで
実売上	初回の仮売上日から365日後^※までかつ実売上日から30日後まで
即時売上	即時売上日から30日後まで

※ 対象取引の更新が無い場合は原則180日でデータが削除され、以降は処理ができなくなります。
　金額変更、仮売上有効期限延長により取引を更新した場合の最大日数が365日後となりますのでご注意ください。

楽天ポイント/キャッシュ分の返還について

キャンセル可能期限を過ぎた場合、楽天ポイント/キャッシュは返還されません。
お客様とのトラブル防止のため、各処理期限までに実売上処理、またはキャンセル/返品を実施してください。
既定の期限を超過し実売上処理、またはキャンセル/返品をともに行えなくなった場合、楽天ポイント/キャッシュについては加盟店様にてお客様へ直接返金を実施してください。

在庫キャンセルについて

決済後に在庫の引き当てが出来なかった場合は、速やかにキャンセルを実施してください。
（お客様が期間限定ポイントを使用していた場合、トラブルに発展する可能性があるため。）

金額変更

増額・減額ともに可能です。
金額変更の回数に制限はありません。
取引状態により金額変更可能期間が異なります。

取引状態	金額変更可能期間
仮売上	初回の仮売上日から365日後^※1までかつ最後の仮売上日^※2から30日後まで
実売上	初回の仮売上日から365日後^※1までかつ実売上日から30日後まで
即時売上	即時売上日から30日後まで

※1 対象取引の更新が無い場合は原則180日でデータが削除され、以降は処理ができなくなります。
　金額変更、仮売上有効期限延長により取引を更新した場合の最大日数が365日後となりますのでご注意ください。
※2 「最後の仮売上日」とは、仮売上、金額変更、仮売上有効期限延長の最終実施日を指します。

期限切れ

利用承諾可能期間

決済実行後、30分以内にお客様が楽天ペイ利用承諾画面にログインする必要があります。
また、ログイン後、60分以内に利用承諾を完了する必要があります。

この期間を超過した場合、取引状態は期限切れとなります。

期限切れになるタイミング

状態が要求成功（REQSUCESS）または認証処理中（AUTHPROCESS）のまま処理期限が過ぎた取引については、毎日夜間に取引状態を期限切れ（EXPIRED）に更新します。

その他留意事項

楽天の管理画面（Dashboard）での操作

重要

楽天の管理画面（Dashboard）にて実売上、キャンセル、金額変更処理を実施しないでください。
処理内容が当サービスへ反映されないため、楽天と弊社間で状態不整合が発生し、トラブルの原因となります。
必ず当サービスを利用して処理を実施してください。

支払いボタンのレギュレーション

楽天ペイ選択後、楽天ログイン画面へ遷移させる遷移元画面に設置いただくボタンは楽天指定のソースコードである必要があります。
実装前に楽天レギュレーションをご確認ください。
詳細は楽天ペイメント株式会社へお問い合わせください。

お客様へのメール通知

以下の処理タイミングで楽天からお客様にメールが送信されます。

決済成功時
金額変更時（同額は含まない）
キャンセル時

ロゴ画像

ロゴ

必ずロゴマーク利用ガイドラインを確認の上ご利用ください。
ロゴはデザイン、カラーを変更せず十分な余白を用意し、そのままの状態で利用ください。

サイズ	URL
【大】300×88	https://checkout.rakuten.co.jp/rpay/logo/s_sb_30088.jpg
【中】200×59	https://checkout.rakuten.co.jp/rpay/logo/s_sb_20059.jpg
【小】100×30	https://checkout.rakuten.co.jp/rpay/logo/s_sb_10030.jpg
【大】140×127	https://checkout.rakuten.co.jp/rpay/logo/w_wb_140127.jpg
【中】100×91	https://checkout.rakuten.co.jp/rpay/logo/w_wb_10091.jpg
【小】60×55	https://checkout.rakuten.co.jp/rpay/logo/w_wb_6055.jpg

注文ボタン（「楽天IDでお支払い」ボタン）

注文ボタンを設置可能です。JavaScriptコードを支払ページに埋め込んで、ボタンを表示させてください。
「楽天IDでお支払い」というボタンが表示されます。

JavaScriptはボタンを表示させる機能のみを提供しており、Submit等の動作をする機能は提供していません。
注文ボタンを押下後に決済実行を呼び出すことを推奨しております。

注文ボタンの仕様の詳細は楽天ペイメント株式会社へお問い合わせください。

設定パラメータ

設定値	データ型	必須	説明
`src`	文字列	Y	注文ボタンを作成するための設定値。固定値： `https://contents.online.checkout.rakuten.co.jp/live/button/v1/rakuten-pay.js`
`class`	文字列	Y	注文ボタン作成するための設定値。固定値：`rakuten-checkout-button`
`data-button-type`	文字列	N	注文ボタンのデザインを指定する設定値。現在提供しているデザインは`default`のみ。
`data-button-width`	数字	N	注文ボタンのサイズを指定する設定値指定できる範囲：165～640 指定されていない場合は240になる。範囲外の値が指定された場合は、限界値のサイズになる。

サンプルコード

<button id="purchase" style="border: none; background:transparent">
<script src='https://contents.online.checkout.rakuten.co.jp/live/button/v1/rakuten-pay.js' class='rakuten-checkout-button' data-button-type='default' data-button-width='200'></script>
<noscript>Rakuten Payで購入する</noscript>
</button>

概要​

楽天ペイV2（随時決済）を始めるには​

接続方式のサポート​

利用承諾状態​

随時決済取引状態​

利用承諾​

パターン1：利用承諾のみ​

パターン2：利用承諾+都度決済​

実売上​

実売上可能期間​

仮売上有効期限の延長​

返金​

金額変更​

期限切れ​

利用承諾可能期間​

期限切れになるタイミング​

その他留意事項​

楽天の管理画面（Dashboard）での操作​

支払いボタンのレギュレーション​

お客様へのメール通知​

ロゴ画像​

ロゴ​

注文ボタン（「楽天IDでお支払い」ボタン）​

設定パラメータ​

サンプルコード​

概要