リダイレクトの構成方法

概要

ユーザーが支払いを完了した後に別のページにリダイレクトするには、パブリッシャーアカウントまたはAPI経由でリダイレクトを設定できます。さまざまな支払いステータス（支払い完了またはキャンセル）に対して、次のリダイレクトを構成できます：

• 自動 — 設定された遅延時間でリダイレクトされます。
• 手動 — ユーザーがリダイレクトボタンをクリックした後、リダイレクトされます。

自動的にリダイレクトを設定することと手動でのリダイレクトを同時に構成することができます。ユーザーは引き続き、アプリケーションに戻るためのリダイレクトボタンをクリックすることができます。それ以外の場合、構成された遅延時間が経過すると自動的にリダイレクトされます。

• user_id — ユーザーID。
• foreigninvoice — external_idパラメータで渡されるトランザクションID。
• invoice_id — トランザクションID。
• status — トランザクション状況。以下の値を持つことができます：

ユーザーがリダイレクトされるURLの例： {Return URL}?user_id=[value]&foreignInvoice=[value]&invoice_id=[value]&status=done

ユーザーが支払いを完了する前に決済UIタブを閉じた場合、次の形式で指定されたリダイレクトURLにリダイレクトされます：{Return URL}?user_id=[value]&invoice_id=. 決済UIがPay Station Embedで開いた場合、決済UIを閉じるとウィジェットが閉じ、ユーザーはゲームに戻ります。

自動リダイレクトを構成する

以下の場所で自動リダイレクトを構成することができます：

パブリッシャーアカウントでの自動リダイレクトを構成する

1. パブリッシャーアカウントでプロジェクトを開き、決済ソリューション > 決済インタフェース > 一般設定セクションに移動します。
2. リダイレクトポリシーセクションに移動します。

3. リターンURLフィールドに、支払完了後にユーザーがリダイレクトされるURLアドレスまたはパス（ディープリンク）を入力してください。ユーザーがゲームのモバイルアプリケーションで決済UIを開いた際のユーザー体験を向上させるために、リターンURLとしてディープリンクを指定することを推奨します。
4. ドロップダウンリストから、自動リダイレクト条件を選択します：
   • なし — リダイレクトしない。
   • 支払い成功 — 支払いが成功した場合にリダイレクトする。
   • 支払い成功またはキャンセル — 支払いが成功またはキャンセルされた場合にリダイレクトする。
   • 任意の支払い — どの支払いステータスであってもリダイレクトする。
5. 遅延フィールドに、リダイレクトまでのタイムアウト時間（秒単位）を入力してください。デフォルトでは、リダイレクトは0秒で有効になります。
6. リダイレクトボタンを追加せず、自動リダイレクトのみを設定したい場合は、手動リダイレクト条件ドロップダウンリストで、なし — リダイレクトしないを選択してください。
7. 「変更内容を保存」をクリックします。

API経由で自動リダイレクトを構成する

リダイレクトを構成するには、トークンを作成する APIコールで以下のデータを渡します：

手動リダイレクトを構成する

以下の場所で手動リダイレクトを構成することができます：

• パブリッシャーアカウントで
• API経由で

パブリッシャーアカウントでの手動リダイレクトを構成する

1. パブリッシャーアカウントでプロジェクトを開き、決済ソリューション > 決済インタフェース > 一般設定セクションに移動します。
2. リダイレクトポリシーセクションに移動します。

3. リターンURLフィールドに、支払完了後にユーザーがリダイレクトされるURLアドレスまたはパス（ディープリンク）を入力してください。ユーザーがゲームのモバイルアプリケーションで決済UIを開いた際のユーザー体験を向上させるために、リターンURLとしてディープリンクを指定することを推奨します。
4. 手動リダイレクトのみを設定したい場合は、自動リダイレクト条件ドロップダウンリストでなし — リダイレクトしないを選択してください。
5. 遅延フィールドは空欄のままにしてください。
6. 手動リダイレクト条件ドロップダウンリストで、リダイレクトボタンが表示される支払いステータスを選択します：
   • なし — リダイレクトしない。
   • 支払い成功 — 支払いが成功した場合にリダイレクトする。
   • 支払い成功またはキャンセル — 支払いが成功またはキャンセルされた場合にリダイレクトする。
   • 任意の支払い — どの支払いステータスであってもリダイレクトする。
7. リダイレクトボタンのキャプションフィールドに、ユーザーをリターンURLへリダイレクトするボタンに表示するテキストを入力します。
8. 「変更内容を保存」をクリックします。

API経由で手動リダイレクトを構成する

リダイレクトを構成するには、トークンを作成する APIコールで以下のデータを渡します：

リダイレクト構成の例

パブリッシャーアカウントで、3秒間の遅延を伴う自動リダイレクトを設定しました。この操作は、モバイル版とデスクトップ版の両方の決済UIに適用されます。パブリッシャーアカウントで設定されたコンフィギュレーションは次のようになります：

ゲームのモバイルアプリケーションで決済UIを開くための設定を更新する必要がある場合、つまり、リダイレクトボタンを追加したり、リターンURLとしてディープリンクを指定したりするには、トークンで渡された設定を更新する必要があります：

 1{
 2    "user": {
 3        "country": {
 4            "value": "US"
 5        },
 6        "id": {
 7            "value": "1234abCd"
 8        },
 9        "name": {
10            "value": "John Smith"
11        }
12    },
13    "settings": {
14        "currency": "USD",
15        "project_id": 123456,
16        "language": "en",
17        "return_url": "myapp://payment/successful",
18        "ui": {
19            "desktop": {
20                "header": {
21                    "visible_logo": true
22                }
23            }
24        },
25        "redirect_policy": {
26            "redirect_conditions": "any",
27            "redirect_button_caption": "Back to Store",
28            "manual_redirection_action": "redirect",
29            "status_for_manual_redirection": "any"
30        },
31        "external_id": "1a2b3c"
32    },
33    "custom_parameters": {
34        "timestamp": 1234512345123,
35        "sku": "testSKU",
36        "amount": "10"
37    },
38    "purchase": {
39        "virtual_items": {
40            "items": [
41                {
42                    "sku": "testSKU",
43                    "amount": 1
44                }
45            ]
46        }
47    }
48}