本ガイドの内容

本ガイドは、株式会社DGフィナンシャルテクノロジーが提供するVeriTrans4Gの「楽天ペイ（オンライン決済）V2」をインターネット店舗等でご利用いただくため、専用ソフトウェアMDK（Merchant Development Kit）を導入する開発者向けのガイドです。

都度決済について

【都度決済機能】

消費者の購入した商品などについて、1回だけ決済を行います。
都度決済機能には以下の特徴があります。

1. 都度決済の申込は、「課金種別」を未指定、あるいは都度決済を指定して行います。
2. 都度決済の申込は、消費者の端末から行います。
3. 与信取消、売上、売上後の返金はMDKまたは管理画面（MAP）から可能です。

随時決済について

【随時決済機能】

随時決済は定期購入商品/サービスの提供にのみご利用いただけます。
店舗様と利用者の継続的な利用の承諾に基づき、商品などの提供状況に応じて加盟店の処理要求単位に課金することができます。

1. 随時決済の申込（利用承諾）は、「課金種別」に随時決済を指定し、都度決済と同様のフローで行います。
   ※申込フローでは利用承諾のみを行うため金額指定はできません。
2. 随時決済の申込は、消費者の端末から行います。
3. 課金する場合には、①の取引IDを元取引IDに指定し、新しい取引IDで再与信することにより金額を確保します。
   ※withCaptureを指定することで同時に売上処理も可能です。
4. ③の取引IDに対して、与信変更、取消、売上を実施します。
   再与信した取引の取消、売上はMDKまたは管理画面（MAP）から可能です。
5. ③と④を何度でも実施できますが、一定期間(1年)再与信を行わなかった場合、再度申込（利用承諾）から実施していただきます。

機能一覧（決済要求コマンド）

使用可能な決済要求コマンドを下記表に示します。

また、他随時決済に実装されている「解約」コマンドについてですが、将来的には実装される可能性がありますが、現在楽天側に機能が用意されていないため実装されておりません。

※1 ご利用の際は、必ず「6-5 Authorize以降のコマンドに関する注意事項」をご参照ください。

※2 物品販売の場合は、商品を発送する前に売上を行うことは禁止されていますので、商品の発送後に売上を行うか、多少の前後は問題ございませんので、できる限り消費者への商品発送と同じタイミングで売上を行うようにしてください。楽天ペイ（オンライン決済）V2のレギュレーション事項となりますので、詳細は楽天ペイメント株式会社にお問い合わせください。

以下で各決済のコマンドの実施可能タイミングを図示します。

【都度決済】

【随時決済】

承諾状態が継続する限り、申込取引に対して再与信を繰り返し実施可能です。

決済処理シーケンス

【楽天ペイ（オンライン決済）V2：決済申込時の処理】

※1 FormをSubmit(POST)するHTMLコンテンツが返戻されます。HTMLコンテンツには、Formを自動SubmitするJavaScriptが含まれていますので、そのまま消費者に送信すれば（JavaScriptを利用可能な端末では）自動で画面遷移します。
リダイレクト先のURLのみの返戻もあるので、そちらを使用して独自に遷移処理を作成いただいてもかまいません。

※2 処理結果応答失敗時に、消費者が支払情報を変更することで決済が成功する可能性がある場合、再度楽天の支払いページへのリダイレクトを指示し、消費者の申込を促します。

【楽天ペイ（オンライン決済）V2：再与信要求時の処理】

【楽天ペイ（オンライン決済）V2：与信変更要求時の処理】

【楽天ペイ（オンライン決済）V2：売上要求時の処理】

【楽天ペイ（オンライン決済）V2：取消要求時の処理】

結果通知受信処理の対象

楽天ペイ（オンライン決済）V2の結果通知受信処理の対象は以下の機能です。

通信電文仕様（共通部）および店舗受信後応答仕様は、『VeriTrans4G 開発ガイド（MDKモジュール方式）』をご参照ください。
楽天ペイ固有の通知電文インターフェイスにつきましては、「5.3.3結果通知項目」をご参照ください。

楽天ペイ（オンライン決済）V2

共通

結果通知電文

楽天ペイ（オンライン決済）V2への移行について

古いバージョンの楽天ペイ（オンライン決済）（V1）から楽天ペイ（オンライン決済）V2に移行するためには、楽天ペイメント株式会社とのご契約後に発行されるV2のアカウント情報（接続情報）を弊社にご連携いただき、弊社決済サーバー側で「V2」のアカウント登録を行います。

アカウント登録の完了後に、V2のインタフェースでのリクエストに変更すれば、V1からV2へ切り替えたということになります。 なお、V2のアカウント登録完了後でも、V1のインターフェースは使用可能で、V1で作成した取引の後続処理（売上、取消）を実行することができます。ただし、V1の新規の申込（与信）については、契約上許可されていません。

楽天ペイ（オンライン決済）V2のレギュレーションについて

楽天ペイ（オンライン決済）V2の導入には、楽天ペイメント株式会社が規定するレギュレーションを遵守していただく必要があります。
楽天グループに関する名称、サービス名称や、ロゴ・ボタン等に関する表記審査をはじめ、ご利用のオプション機能用のレギュレーションがございますので、詳細につきましては、楽天ペイメント株式会社にお問い合わせください。

チャージバックに関する注意事項

チャージバック発生時の諸手続きは、楽天ペイメント株式会社より加盟店様へご連絡が行われ、手続きについてのご案内がございますが、チャージバックの情報は弊社の決済サーバーには連携しておりませんので、以下の点にご注意ください。

• チャージバック対象の取引につきまして、楽天システム側でキャンセル処理が行われた場合、 弊社の管理画面（以下、MAP）で表示される当該取引の状態は 、売上が成立した状態のまま残ります。
• 楽天システム側でチャージバックによるキャンセル処理が行われた取引に対して、 MAPから、またはAPI(MDK)で取消を行うことはできません（取消が要求された場合は、エラー応答となります） 。

チャージバックに関する詳細につきましては、楽天ペイメント株式会社にお問い合わせください。

Authorizeコマンドに関する注意事項

在庫切れによるリスク回避のためAuthorizeコマンドを実施する時点で在庫確認を行うことを推奨いたします。
また、その場合にAuthorizeの結果が失敗であった場合や結果の返却が一定時間ない場合には在庫をリリースするようお願いいたします。

申込（与信のみ）時の注意点

決済後にサービス提供を行わない場合は、速やかに取消を実施してください。申込（与信のみ）後、取消可能期限を過ぎた場合、楽天ポイント/楽天キャッシュは返還されません。
期間限定ポイントを使用していた場合、トラブルに発展する可能性があるため、各処理期限までに売上、または取消/返品を実施してください。
申込（与信のみ）のまま既定の期限を超過し売上、または取消/返品をともに行えなくなった場合、楽天ポイント/楽天キャッシュについては消費者へ直接返金してください。

Authorize以降のコマンドに関する注意事項

保留等の取引の確認

以下の場合に、弊社のシステムで状態を確認し、ステータス等を変更する場合がございます。

• 例えば、「与信保留」の取引について状態を確認し、成功していたためステータスを「与信成功」と変更する。

結果通知対象の有無については、「4-1 結果通知受信処理の対象」を参照してください。

楽天ポイントを利用した決済に関する注意点

楽天ポイントを利用した決済では、消費者が楽天ペイ（オンライン決済）V2の購入画面で利用額を設定します。
以下に、楽天ポイントを利用した決済についての注意点を示します。

決済金額の変更時にはポイント利用額が変更される場合があります。

金額の変更（部分売上、部分取消、与信変更(金額変更)）が発生した場合、クレジットカードの利用額を優先して減額が行われますが、ポイント・キャッシュ（以下、ポイント）充当設定額を下回った場合にはポイント利用額が減額されます。

• 例えば、購入金額1,000円 （うちポイント利用額900円）で申込が成立した取引について、部分売上で800円の売上を確定した場合は全額がポイント利用となるため、ポイント利用額は800円に変更されます。

ポイント利用額が変更となった場合に、ポイントが消費者へ返却されるタイミングは以下となります。

取消処理、または金額の変更（部分売上、部分取消）により、注文金額がポイント充当設定額を下回った場合には、各処理が正常に完了した時点で消費者へポイントが返却されます。
ただし、期間限定ポイントを利用している、かつ、取消日が有効期限を経過していると失効となり返還されません。
また、加盟店様側にて、売上および取消の要求可能期間^（※1）内に売上処理、または取消処理が完了していない取引に関しましては、消費者の楽天ポイントは返却されず利用された状態のままとなります。

加盟店様にて、与信の状態のまま、売上処理、または取消処理を行わずに要求可能期間切れとなりますと、楽天側にて自動でキャンセルされますが（この際、消費者へのキャンセルメールの送信はされません）、可能な限り加盟店様側で適宜売上または取消処理を行っていただくようお願いいたします。
与信の時点で既に楽天ポイントが引き落とされているため、後続処理をお願いいたします。与信の時点で既に楽天ポイントが引き落とされているため、後続処理を行わずに放置してしまうと後のトラブルに繋がる可能性がございます。

※1：売上および取消の要求可能期間については、「6.4.1要求可能期間」をご参照ください。

デビットカード利用について

消費者がデビットカードを利用した注文に対して、与信変更や部分売上、部分取消時にはその都度消費者の銀行口座より引き落とされる可能性があります。 その後通常自動で返金処理は行われますが、処理タイミングや方法はカード会社によって異なるためご注意ください。

楽天から消費者に送信されるメール

楽天ペイ（オンライン決済）V2において、楽天から消費者に送信されるメールの送信タイミングを以下に示します。

検索（Search）に関する補足（詳細コマンドタイプ/詳細オーダー決済状態/承諾状態）

管理サーバーでは、楽天ペイ（オンライン決済）V2のシステム内部データとして詳細コマンド（処理要求の種類）と詳細な決済状態（その取引がどのような状態にあるか）を管理しています。
通常の運用では、店舗様システムではこれらの内部情報を利用する必要はありませんが、店舗様システムにおいて取引の状態検索が必要なケースや、障害等のお問い合わせ時の参照情報として、これらの内部データをSearchコマンドで公開しています。
下表にSearchコマンドにて利用可能な内部データの一覧を示します。

注） 一覧に記載していないコマンドタイプと状態も存在します。

API Keyの取得方法

楽天Payをご利用になる際に、マスタ登録に必要なAPI Key情報を楽天様ご提供管理画面（Dashboard）
https://dashboard.online.checkout.rakuten.co.jpより、ログインし、「アカウント管理」メニューより取得してください。

なお、「API Key 更新ボタン」を押下した場合、古いAPI Keyが使えなくなりますのでご注意ください。

決済申込時のエラーをシミュレートする

決済サーバーに接続し、テストを実施するための各種手続き・手順の詳細につきましては、『導入テストガイド』を参照してください。

弊社では、楽天ペイ（オンライン決済）V2のテストのための疑似環境を提供しています。
Authorizeコマンドの結果として返戻されたレスポンスコンテンツをブラウザに返戻すると、疑似環境に自動的に遷移します。

コマンドのエラーをシミュレートする

要求金額（"amount "）の下一桁の値を調整することで、意図的にエラーを発生させることができます。
要求金額の下一桁と、返戻されるvResultCodeの対応表を以下に記載します。

• 金額未指定(Authorize以外)の場合、全額が要求されたものとして動作します。

また、Authorizeで随時決済の場合、itemNameの値で意図的にエラーを発生させることができます。

保留となった取引について、一定時間後自動で確認を行い以下の結果に遷移します。

また、Authorize成功後、一定時間を過ぎてもお支払い画面での結果選択が行われなかった場合、都度決済ではFG26として決済失敗となり、随時決済ではF001として決済成功となります。

• 返戻されるエラーコード（vResultCode）につきましては、今後、予告なしに変更させていただく場合がございます。

WebView等を利用したスマートフォンアプリへの実装に関する注意事項

楽天ペイの仕様上、WebView等を利用したスマートフォンアプリへの実装については動作保証対象外となっております。

※実際にご利用いただいている例もございますので、加盟店様にて十分にテストしていただき、問題ないことをご確認のうえリリースしていただきますようお願いいたします。