ギフトのサブスクリプション

アプリケーションに、ユーザーが他の人にサブスクリプションを贈る機能を含めることができます。これは、収益を高め、新しいユーザーを引き付けるのに役立ちます。

どのように動作するか

ユーザーは、アカウント情報を指定してシステム内の既存のユーザーにサブスクリプションを贈るか、メールアドレスを指定して新しいユーザーにサブスクリプションを贈ることができます。この場合、ギフトを送信するユーザーは、自分の名前を非表示にしたり、ギフトのメール通知にテキストメッセージを追加したりできます。サブスクリプションを作成すると、ギフトの受信者がその所有者になります。作成したサブスクリプションは一括払い更新タイプです。

既存のユーザーにサブスクリプションを贈るときのインタラクション フロー:

新規ユーザーにサブスクリプションを贈る際のインタラクションフロー:

設定方法

アプリでサブスクリプションを贈る機能を設定できます:

既存ユーザーへのギフト

  1. 次の要素を持つギフトサブスクリプションを購入するためのインターフェイスをアプリケーションに実装します:
    • ギフトの受取人のデータを入力するフィールド
    • 送信者からのメッセージを入力するフィールド(任意)
    • 匿名送信を選択するオプション(任意)
    • サブスクリプションプランを選択するための要素(任意)

  1. 決済に進む際にギフト内容を記入した後のトークン受け取りを実装します。これを行うには、次のパラメータを使用して、purchase.subscription.giftオブジェクトをトークンを作成するAPIコールに渡します。
    • recipient — サブスクリプション受信者のID。必須です。
    • email — 受信者のメールアドレス。必須です。
    • redirect_url — リダイレクトURL。ギフトされたサブスクリプションに関する追加情報を含むページ、またはプロジェクトのメインページへのリンクを提供します。
注意
redirect_urlがトークンで渡されない場合、ギフトの受取人はギフト通知メールからギフトのサブスクリプションに移動できません。

  • さらに、以下のパラメータをpurchase.subscriptionオブジェクトに渡すこともできます:
    • gift.anonymous — ギフトが匿名で送られたかどうか。 trueの場合、送信者の名前は電子メール通知に表示されません。デフォルトは false です。
    • gift.message — ギフトの送信者からのメッセージ。 ギフトのサブスクリプションに関する電子メール通知で送信されます。
    • plan_id — サブスクリプションプランのID。

トークンの受信リクエストの例:

Copy
Full screen
Small screen
{
  "purchase": {
    "checkout": {
      "currency": "USD",
      "amount": 10
    },
    "subscription": {
      "gift": {
        "recipient": "test_recipient_v1",
        "email": "recipient_email@email.com",
        "redirect_url": "https://example.com/",
        "anonymous": true,
        "message": "Happy birthday!"
      }
    }
  },
  "settings": {
    "currency": "USD",
    "language": "en",
    "project_id": 16184,
    "ui": {
      "components": {
        "virtual_currency": {
          "custom_amount": true
        }
      },
      "desktop": {
        "virtual_item_list": {
          "button_with_price": true,
          "layout": "list"
        }
      },
      "size": "medium"
    }
  },
  "user": {
    "country": {
      "allow_modify": true,
      "value": "US"
    },
    "age": 19,
    "email": {
      "value": "john.smith@mail.com"
    },
    "id": {
      "value": "user_2"
    },
    "name": {
      "value": "John Smith"
    }
  }
}
  1. ステップ2で受け取ったトークンを使用して、新しいウィンドウでIframeで、またはPay Station Embedを使用して決済インターフェイスを開きます。

新規ユーザーへのギフト

  1. 以下の要素を含むギフト サブスクリプションを購入するためのインターフェイスをアプリケーションに実装します:
    • ギフト受取人のメールアドレスを入力するフィールド
    • 入力フィールド送信者からのメッセージ(任意)
    • 匿名送信を選択するオプション(任意)
    • サブスクリプションプランを選択するための要素(任意)
  2. 新しいユーザーの作成を実装し、システム内でそのユーザーにIDを割り当てます。
  3. ユーザーアカウントをアクティブ化するためのリンクを作成します。
お知らせ
サブスクリプションは、許可されたユーザーにのみ販売できます。
  1. 決済に進む際にギフト内容を記入した上でトークンを受け取る実装を行います。これを行うには、purchase.subscription.giftオブジェクトをパラメータとともにトークンを作成するAPIコール:
    • recipient — ステップ2で作成したサブスクリプション受取人ID
    • email — 受取人のメールアドレス。
    • redirect_url — ステップ3で作成したアクティベーションURL。
注意
redirect_urlがトークンで渡されない場合、ギフトの受取人はギフト通知メールからギフトのサブスクリプションに移動できません。

  • さらに、以下のパラメータをpurchase.subscriptionオブジェクトに渡すこともできます:
    • gift.anonymous — ギフトが匿名で送られたかどうか。 trueの場合、送信者の名前は電子メール通知に表示されません。デフォルトは false です。
    • gift.message — ギフトの送信者からのメッセージ。 ギフトのサブスクリプションに関する電子メール通知で送信されます。
    • plan_id — サブスクリプションプランのID。

トークンの受信リクエストの例:

Copy
Full screen
Small screen
{
  "purchase": {
    "checkout": {
      "currency": "USD",
      "amount": 10
    },
    "subscription": {
      "gift": {
        "recipient": "test_recipient_v1",
        "email": "recipient_email@email.com",
        "redirect_url": "https://example.com/",
        "anonymous": true,
        "message": "Happy birthday!"
      }
    }
  },
  "settings": {
    "currency": "USD",
    "language": "en",
    "project_id": 16184,
    "ui": {
      "components": {
        "virtual_currency": {
          "custom_amount": true
        }
      },
      "desktop": {
        "virtual_item_list": {
          "button_with_price": true,
          "layout": "list"
        }
      },
      "size": "medium"
    }
  },
  "user": {
    "country": {
      "allow_modify": true,
      "value": "US"
    },
    "age": 19,
    "email": {
      "value": "john.smith@mail.com"
    },
    "id": {
      "value": "user_2"
    },
    "name": {
      "value": "John Smith"
    }
  }
}
  1. ステップ4で受け取ったトークンを使用して、新しいウィンドウでIframeで、またはPay Station Embedを使用して決済インターフェイスを開きます。
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2024年1月22日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!