Markdownをコピー
リンクタイプ Plus 楽天ペイV2
概要
リンクタイプ Plusでは、楽天ペイV2を利用できます。
- 楽天ペイV2を利用する場合は、実行パラメータセットに楽天ペイV2固有の必要項目を渡してください。
URLの生成方法は3通りです。- 管理画面で生成：新規取引作成画面にて必要項目を入力してください。
- APIで生成：API呼び出し時にパラメータを指定してください。
- パラメータ型URL生成：パラメータ付きURLの生成時にパラメータを指定してください。
- 決済完了後は遷移先URLに楽天ペイV2の結果パラメータを返却します。
実行パラメータ仕様
楽天ペイV2固有の実行パラメータは以下の通りです。
| json key | 説明 | 必須 | 形式 | 加盟店デフォルト値※1の登録可否 | システム デフォルト値※2 |
|---|---|---|---|---|---|
rakutenpayv2 | 楽天ペイV2固有実行パラメータ（親要素） 楽天ペイV2の実行パラメータセットです。 | — | — | — | — |
rakutenpayv2.JobCd | 処理区分 以下のいずれかを設定します。 AUTH：仮売上CAPTURE：即時売上 | ✔ | — | ✔ | AUTH |
rakutenpayv2.Description | 楽天説明文 楽天ペイ管理画面で表示される説明文です。 設定値には制約がありますので、詳細は楽天のレギュレーションをご参照ください。 | — | 全半角300桁 | ✔ | (null) |
rakutenpayv2.PriorityVersion | 優先バージョン 楽天ペイ、楽天ペイV2共に利用可能な場合、どちらを利用するかを指定します。 1：楽天ペイ2：楽天ペイV2※楽天ペイのみ利用可能な状態で「 2：楽天ペイV2」を指定しても楽天ペイV2は利用できません。楽天ペイ、楽天ペイV2共に利用可能であり、楽天ペイを利用したい場合に「 1：楽天ペイ」を指定することを推奨します。 | — | 半角数字1桁 | ✔ | 2 |
※1 加盟店デフォルト値：設定IDに紐づけて加盟店様ごとに設定されたデフォルト値。ショップ管理画面で設定してください。都度のパラメータ指定がない場合に適用されます。
※2 システムデフォルト値：システムで設定されているデフォルト値。都度のパラメータ指定および加盟店デフォルト値がない場合に適用されます。
結果パラメータ仕様
楽天ペイV2を選択した場合に返却される固有の結果パラメータは以下の通りです。
| パラメータ | 説明 | 形式 |
|---|---|---|
rakutenpayv2 | 楽天ペイV2固有部（親要素） 楽天ペイV2固有の結果パラメータセットです。 | 半角英数32桁 固定 |
rakutenpayv2.Status | 取引状態 取引の状態を示す以下の値が設定されます。 AUTH：仮売上CAPTURE：即時売上PAYFAIL：決済失敗（決済がエラーとなり支払いに失敗してしまった状態） | — |
rakutenpayv2.RakutenChargeID | 楽天チャージID 楽天チャージIDが設定されます。 | 半角英数32桁 |
rakutenpayv2.TranDate | 決済日時 決済を行った日時が設定されます。 （yyyyMMddHHmmss形式） | 半角数字14桁 |
画面遷移
楽天ペイV2を選択した場合の画面遷移は以下の通りです。
- 決済選択/入力画面：決済手段として楽天ペイV2を選択
- 決済事業者画面（楽天ペイV2）：楽天ペイV2サイトにて決済手続き
- レシート画面：決済完了
ワンポイント
確認画面、レシート画面はスキップ可能です。
スキップする場合は、共通パラメータのConfirmSkipFlagおよびReceiptSkipFlagを設定してください。
画面構成
決済選択/入力画面
- 決済選択コンボボックスで「楽天ペイ」をクリック
- 「楽天IDでお支払い」をクリック
決済事業者画面（楽天ペイ）
お客様は楽天ペイV2サイトにて決済手続きを行います。
レシート画面
楽天ペイV2サイトにて決済手続きが完了した際に表示されます。
