CreateYourVPN Academy
ガイド

lava.top で決済を受け付ける

ステップバイステップの手引き:顧客の支払いがそのままサブスクリプションになるよう、lava.top アカウントを CreateYourVPN に接続する方法 — API キー、Webhook 1 つ、オファーとプランの紐付け。

lava.top は、ルーブル・ドル・ユーロでカード、SBP、PayPal を受け付ける決済プロバイダーです。一度つなげば、ストアフロントでの支払いはそのまま有効なサブスクリプションになります。手作業でアクセスを付与する必要はありません。

お金はあなた自身の lava.top アカウントに入ります。CreateYourVPN は決済の仲介者ではなく、あなたの売上から手数料を取りません。

決済の受付は有料プラン Max に含まれます。ストアフロントを販売モードに切り替えるのもこのプランです。プラットフォームの料金については請求のレッスンをご覧ください。

必要なもの

  • lava.top のアカウント(販売する側の「作者」アカウント)
  • 初期設定のための 10〜15 分
  • テスト決済のための少額:lava.top にテスト環境はありません。設定全体を確認する方法は実際の購入だけです(最低 50 ₽ / 5 $ / 5 €)。

ステップ 1. 登録と本人確認

lava.top に登録し、プロフィールを埋めてください。プロフィールが空のままだと、購入者には決済ページが未完成に見えます。

その後 Balance → 本人確認へ進みます:書類と自撮り、18 歳以上、VPN はオフの状態で。

本人確認の前でも販売はできますが、確認なしでは出金できません。初回の出金まで先延ばしにしないでください。

ステップ 2. 商品を作成する

lava.top で、販売する各プランに対応する商品を作ります。

  • 継続課金のプランには商品タイプ「サブスクリプション」を選びます。lava.top が自動で課金し、更新のたびに当社側のアクセスも延長されます。
  • 買い切りの場合は、固定価格のデジタル商品、コース、またはコンサルティングを使います。
  • オファーには、対応通貨(RUB、USD、EUR)のうち少なくとも 1 つで価格を設定します。CreateYourVPN のプラン通貨が初期値になりますが、顧客はオファーにある任意の通貨へ切り替えられます。
  • 課金周期をプランの期間に合わせます:月額商品 ↔ 30 日、90 日 ↔ 90、といった具合です。
  • 商品は「非公開」の表示設定だけで公開の lava.top ページから隠してください。「価格は API 経由で応相談」は有効にしないでください。当社の連携は固定価格のオファーから決済を作成し、API で金額を送りません。lava.top ページからの直接購入は当社の目印なしで届き、「未紐付け」になることがあります。非公開の固定価格商品はオファー選択に引き続き表示されます。

lava.top は商品の価格をオファー(offer)と呼びます。1 つの商品に複数のオファー(通貨や期間の違い)を持たせられます。後で各プランに選ぶのが、まさにこのオファーです。

再購入したときの挙動

買い切り商品に更新はありません。顧客がもっと必要になれば、単に買い直します。これは通常の流れで、早めに買っても問題ありません。日数は残りに加算され、ゼロから数え直されることはありません。残り 10 日に新しい 1 か月を足せば 40 日です。

例外が 1 つ、プランが通信量も付与する場合です。容量は置き換えられ、合算されません。100 GB を購入して 30 GB 使い、同じプランを再購入した顧客は、170 GB ではなく新しい 100 GB になります。通信量付きプランの価格設定では、この点を考慮してください。

ステップ 3. CreateYourVPN でアカウントを接続する

lava.top 側で必要なものは 1 か所にまとまっています:左メニューの IntegrationsAPI のカードです。

lava.top の「Integrations」セクション:API と Web-Widget のカード

API キーを作成する

API カードを開き、「Create API key」を押します。キーが表示されるのは一度きりです。すぐにコピーしてください。lava.top は二度と表示せず、失くしたキーは新しいものに置き換えるしかありません。

API キーのページ:「Create API key」ボタンと Webhook 履歴へのリンク

キーを管理画面に貼り付ける

CreateYourVPN で**「マネタイズ」セクションを開き、lava.top のカードで「接続」を押し、キーを「lava.top の API キー」**欄に貼り付けて保存します。

キーはその場で検証し、「キーを受け付けました」(アカウントで見つかった商品数付き)または「lava.top はこのキーを受け付けませんでした」と返します。

保存直後、同じフォームにもう 2 つの値が現れます:Webhook URLwebhook キーです。次のステップでこれらを lava.top に貼り付けます。webhook キーは当社が生成するので、あなたが考える必要はありません。

Webhook を作成する

lava.top はキー作成の直後にこれを促します。**「+ Add Webhook」**を押してください。同じボタンは後から API ページにもあります。

「API key successfully added」ウィンドウと「+ Add Webhook」ボタン

Webhook は 1 つで足ります。イベントタイプの欄で、必要なタイプをまとめて選択します:

Webhook 追加フォーム:URL、イベントタイプ、認証方式、API キーの欄

URL — 管理画面の Webhook アドレス。lava.top は HTTPS しか受け付けませんが、当社のアドレスはまさにそれです。

Event type両方のタイプを選びます:「Payment result」「Recurring payment」。複数選択できるので、2 つ目の Webhook を作る必要はありません。

Type of authentication for Webhook — **「API key of your service」を選び、「API key」**欄に管理画面の webhook キーを貼り付けます。(Basic でも動きます。当社は受け付けますが、欄が 1 つではなく 2 つになります。)

Comment — 任意、自分用のメモです。「CreateYourVPN — 決済」のような書き方は、連携が複数あるときに役立ちます。

lava.top にはリクエスト署名がまったくないため、この受信が本当にあなたのアカウントから来たと当社の受け口に伝えるのは Webhook のキーだけです。パスワードと同じように扱ってください。

サブスクリプションを販売するなら **「Recurring payment」**の選択を外さないでください。このイベントタイプがないと更新が当社に届かず、支払っている顧客のアクセスがそのまま切れてしまいます。買い切り商品なら **「Payment result」**だけで十分ですが、両方を選んだままでも問題ありません。

API キーで当社ができること

lava.top に「読み取り専用」のキーはありません。API キーは作者アカウントへの完全なアクセスを与えます。当社が使うのは厳密に 3 つだけです:顧客が「支払う」を押した瞬間に決済を作成すること、オファー選択のためにあなたの商品カタログを読むこと、そして顧客が自分のページで自動更新をオフにしたときにサブスクリプションを解約することです。価格の変更も、売上のエクスポートへの関与も、それ以外の操作も一切しません。キーは暗号化して保管され、どこにも再表示されず、当社のログにも残りません。アクセスを断ちたくなったら、管理画面で接続を削除してください。キーも一緒に消えます。

ステップ 4. オファーをプランに紐付ける

**「プラン」**を開き、プランに入って lava.top のブロックを探します:

**「商品を読み込む」**を押します。あなたの lava.top アカウントからカタログを取得します。

このプランを販売するオファーを選びます。一覧には商品名、価格、課金周期が表示されます。

警告が出たら確認してください。オファーにプランの通貨での価格がない場合や、課金周期がプランの期間と食い違う場合(「30 日ごとに課金されますが、プランは 365 日を付与します」)に管理画面が知らせます。

lava.top で商品を作ったばかりなのに一覧に出ない? **「リストを更新」**を押してください。カタログは 1 分間キャッシュされます。

顧客はオファーにある任意の通貨を選べます。ルーブルの買い切り決済ではカードSBP、ルーブルのサブスクリプションではカードのみ、USD と EUR ではカードPayPalを利用できます。

ステップ 5. 実際の支払いで確認する

いちばん安いプランを、自分のストアフロントの顧客アカウントから自分で購入してみてください。1 分以内にそのアカウントにプランが現れ、支払いは記録に**「処理済み」として表示されるはずです(「マネタイズ」**セクション)。

そうならない場合:

  • 記録にイベントがまったくない — lava.top の Webhook の宛先が違う、必要なイベントタイプが選ばれていない、または Webhook のキーが管理画面のものと一致していません。lava.top には再送ボタン付きの Webhook 履歴があります。まずはそこから確認してください;
  • イベントはあるが「未紐付け」 — 誰のどのプランの支払いか判別できませんでした。記録の中で手動で紐付けてください。サブスクリプションは自動決済と同じコードで付与されます;
  • 「要対応」 — その支払いには人の判断が必要です:顧客が管理画面でブロックされている、あるいは支払いの作成後にプランが別の lava.top 商品へ紐付け直された、といった場合です。ここで当社が独断でアクセスに手を触れることはありません。決めるのはあなたです。

課金の失敗は慌てる理由になりません。lava.top は 8 時間後と 24 時間後に再試行し、当社は 1 回の失敗でアクセスを切りません。失敗通知は最後の試行後にだけ送られます。サブスクリプションが解約された場合、次回更新は行われず、支払い済み期間は最後まで有効です。

お金のこと

  • lava.top の手数料は成功した決済ごとに 8 % です。即座に差し引かれ、後から顧客に返金しても戻ってきません
  • 返金は lava.top の管理画面、「売上」セクションから行います。サブスクリプションの返金はそのサブスクリプションを解約します。返金とチャージバック専用の Webhook タイプは lava.top にまだないため、これらは当社の記録ではなく lava.top の管理画面で確認することになります。
  • 自動更新の解約。 顧客はあなたのストアフロントの自分のページで自分で解約できます(その際、当社が lava.top にサブスクリプションの解約を依頼します)。自身の lava.top アカウントで行うこともできますし、あなたが lava.top の管理画面から代わりに解約することもできます。解約でアクセスが取り上げられることはありません。支払い済み期間の終わりまで有効で、当社は次回の課金を待つのをやめるだけです。
  • チャージバックは支払いから 540 日以内に申し立てられ、証拠の提出期限は3 日です。ストアフロントの利用条件と顧客とのやり取りを保管してください。証拠とはそういうものです。
  • 決済の上限と下限: 最低は常に 50 ₽ / 5 $ / 5 €。上限はサブスクリプションが 300 000 ₽ / 3 000 $ / 3 000 €、買い切り商品が 1 000 000 ₽ / 10 000 $ / 10 000 € です。

キーが漏れたら

lava.top のカードには 2 つのボタンがあり、それぞれ役割が違います:

  • 「webhook キーを再発行」 — 受信通知用の新しいキーを発行します。新しい値を lava.top の Webhook に貼り付ける必要があります。それまで決済は確定されません。
  • 「Webhook URLをローテーション」 — 新しいアドレスを発行します。古いアドレスは即座に無効になるので、これも Webhook で更新してください。

API キーそのものが漏れた場合は、lava.top で失効させ、新しいものを作って管理画面に貼り付けてください。

On this page