CreateYourVPN Academy
指南

使用 lava.top 收款

逐步指南:如何把 lava.top 接上 CreateYourVPN,讓客戶在你的店面為餘額儲值。API 金鑰、webhook、儲值金額與自動儲值。

lava.top 支援以盧布、美元和歐元收取銀行卡、SBP 與 PayPal 付款。客戶透過它在你店面的個人中心為餘額儲值,再用餘額購買方案:不需要手動開通權限。

lava.top 採用固定金額:客戶從你設定的儲值金額中選擇一個,每個金額都有自己的、價格相同的 offer。客戶無法自行輸入金額。如果需要任意金額,請再接上 PayHot。

錢進的是你自己的 lava.top 帳戶。CreateYourVPN 不是付款的中間方,也不從你的銷售額抽成。

收款功能在付費的 Max 方案中提供:使用這個方案時,你的店面開始銷售,客戶餘額也會自動啟用。平台價格請見計費課程。

你需要準備

  • 一個 lava.top 帳戶(「作者」帳戶,也就是負責銷售的帳戶);
  • 10–15 分鐘進行初次設定;
  • 一小筆錢做測試儲值:lava.top 沒有測試模式,要完整驗證設定只能靠一次真實付款(最低 50 ₽ / 5 $ / 5 €)。

步驟 1. 註冊與驗證

在 lava.top 註冊並填好個人資料:資料空白時,付款頁在買家眼中像是還沒做完。

接著在 Balance → 驗證 中完成驗證:證件與自拍,18 歲以上,不要開著 VPN。

驗證之前也可以販售,但沒有驗證就無法提領。別拖到第一次結算才做。

步驟 2. 建立商品

lava.top 中 offer 的價格就是儲值金額。你想提供客戶多少種金額,就建立多少個 offer。

  • 單次儲值:固定價格的數位商品、課程或諮詢。一個 offer 對應一個金額,例如 300、500 或 1000 ₽。
  • 自動儲值:「訂閱」類型的商品。lava.top 會依 offer 自己的週期(每月、每 3 個月、每 6 個月或每年)扣取 offer 的價格,每次扣款都會為客戶餘額儲值。
  • offer 需要有客戶帳戶幣別的價格。幣別可以在「收益化」區塊的「客戶餘額」卡片上看到。lava.top 接受盧布、美元和歐元。
  • 用隱藏可見性把商品從你公開的 lava.top 頁面隱藏起來。不要啟用「價格透過 API 詢價」:CreateYourVPN 使用固定價格的 offer。直接在你的 lava.top 頁面完成的購買不帶我們的標記,我們無法得知這是誰的付款。隱藏的固定價格商品仍會顯示在你的後台中。

lava.top 中的 offer 是以特定價格與扣款週期銷售商品的一種方式。一個商品可以有多個 offer,你在後台為每個金額選擇合適的那一個。

步驟 3. 在 CreateYourVPN 接上帳戶

lava.top 這邊要做的事都在同一處:左側選單的 Integrations,API 卡片。

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 未接受此金鑰」。

儲存之後,同一份表單會立刻再出現兩個值:Webhook URL 與 webhook 金鑰。下一步就把它們貼進 lava.top。webhook 金鑰由我們產生,你不必自己想。

新增 webhook

建立金鑰後 lava.top 會立即提示:按下「+ Add Webhook」。之後在 API 頁面也有同樣的按鈕。

「API key successfully added」視窗與「+ Add Webhook」按鈕

只需要一個 webhook:事件類型欄位可以一次勾選全部事件。

新增 webhook 的表單:URL、事件類型、驗證方式與 API 金鑰欄位

URL:你後台裡的 webhook URL。lava.top 只接受 HTTPS,我們的位址本來就是 HTTPS。

事件類型:勾選清單中的全部事件。這是多選,不需要再建立第二個 webhook。

Type of authentication for Webhook:選擇「API key of your service」,把後台的 webhook 金鑰貼進「API key」欄位。Basic 也可以,我們也接受,但那是兩個欄位而不是一個。

Comment:選填,寫給自己看。像「CreateYourVPN,收款」這樣的備註,在你有多個整合時很有幫助。

lava.top 不為請求內文提供加密簽章,因此由 webhook 金鑰來驗證推送。請像對待密碼一樣對待它。

不要留下任何未勾選的事件:沒有定期付款的事件,客戶的自動儲值就無法進入餘額。全部勾選永遠是安全的。

API 金鑰讓我們能做什麼

lava.top 沒有「唯讀」金鑰:API 金鑰給的是對作者帳戶的完整存取權。我們只用它做三件事:在客戶按下「支付」時建立付款;讀取你的商品目錄,讓你在後台選擇 offer;在客戶於個人中心關閉自動儲值或自動續訂時取消訂閱。我們不改價格、不匯出你的銷售資料,也不用它做其他任何事。金鑰以加密方式保存,不會再次顯示,也不會進入我們的日誌。若你想切斷存取,請在後台刪除該連接:金鑰會一併刪除。

步驟 4. 新增儲值金額

開啟「方案」,找到「餘額儲值」區塊。

按下「新增儲值」,在「lava.top offer」清單中選擇一個一次性 offer,然後在視窗中按下「新增儲值」。金額即為 offer 的價格。用這種方式逐一新增金額,最多 20 個。

如需自動儲值,按下「新增自動儲值」,選擇一個 lava.top 訂閱,然後在視窗中按下「新增自動儲值」。金額與頻率由 offer 決定,例如每月 500 ₽。後台會提示這樣的儲值足夠支付哪個方案。

如果某一行出現提示,請檢查。當 offer 沒有餘額幣別的價格、offer 的價格與金額不一致,或 offer 已從 lava.top 消失時,後台都會提示。

剛在 lava.top 建好商品卻在清單裡看不到?按下「重新整理列表」:目錄會快取一分鐘。

在你新增金額或接上 PayHot 之前,客戶無法儲值:「餘額儲值」視窗會顯示「暫時無法儲值」。請至少新增一個不低於你最貴方案價格的金額:這樣餘額為零的客戶就能透過「儲值並購買」按鈕,一次付款完成儲值並購買方案。

在方案本身中不需要選擇 offer:以帳戶幣別定價的方案,客戶用餘額購買。例外的是以其他幣別定價、且先前已綁定 offer 的方案:客戶直接透過 lava.top 為它付款。

客戶會看到什麼

在你店面的個人中心裡,客戶按下「儲值」。在「單次」分頁中,客戶選擇你設定的某個金額與付款方式:銀行卡、SBP(僅限盧布),或在 offer 有美元或歐元價格時選擇 PayPal。在「自動」分頁中,客戶開啟自動儲值:可用銀行卡或 PayPal,因為 lava.top 訂閱不支援 SBP。即使客戶以其他幣別付款,餘額收到的也一律是以帳戶幣別計的儲值金額。

自動儲值需要一個有期限、並以帳戶幣別定價的訂閱方案:沒有這樣的方案,客戶就看不到「自動」分頁。自動儲值與從餘額自動續訂方案搭配運作:客戶開啟自動儲值時,自動續訂會隨之開啟;如果客戶還沒有方案,第一次扣款就會購買方案。每位客戶只有一個自動儲值。

步驟 5. 用一筆真實付款驗證

用你店面上的客戶帳號,以最小的金額為餘額儲值。一分鐘內,錢應該會出現在餘額中,而在「收益化」區塊的「付款紀錄」中,應該會出現一筆狀態為「已處理」的餘額儲值。接著用餘額購買一個方案。

如果沒有出現:

  • 紀錄中完全沒有事件:lava.top 的 webhook 指向錯誤的位址、沒有勾選全部事件,或 webhook 金鑰與後台中的不一致。lava.top 有附重新傳送按鈕的 webhook 歷史紀錄,從那裡開始排查;
  • 有事件,但錢不在餘額裡:事件會帶有「未計入餘額」的標註與提示。請在 lava.top 核對這筆付款,並在客戶卡片中透過調整計入該金額;
  • 「未關聯」:我們無法判斷這是誰的付款。客戶繞過店面、直接在你的 lava.top 頁面購買商品時會發生這種情況。找到這位客戶,在其客戶卡片中透過調整計入該金額;
  • 「待處理」:這個事件需要你來決定,事件本身會寫明該怎麼做。

如果訂閱扣款失敗,lava.top 會在 8 小時與 24 小時後再嘗試兩次,並且只在最後一次嘗試之後才傳送失敗通知。客戶會在個人中心看到最近一次扣款未成功。已經在餘額裡的錢仍歸客戶所有。

關於錢

  • lava.top 的手續費:每筆成功付款的 8 %。立即扣除,之後你退款給客戶時不會退還。
  • 退款在 lava.top 後台的「銷售」區塊辦理;訂閱的退款會取消該訂閱。退款或拒付的通知會以「待處理」狀態進入紀錄。退款後客戶的餘額不會自動減少:請在客戶卡片中透過調整扣減相同金額。
  • 關閉自動儲值。 客戶可以在你店面的個人中心自行關閉,我們會請 lava.top 取消訂閱。如果客戶關閉方案的自動續訂,自動儲值也會隨之關閉。你也可以在 lava.top 後台取消訂閱。無論哪種情況,餘額裡的錢都不會作廢。
  • 拒付(chargeback) 可在付款後 540 天內提出,而你只有 3 天提交證據。請保存銷售條款、與客戶的往來紀錄,以及已提供存取權的證明。
  • 付款限額取決於商品類型。 最低一律為 50 ₽ / 5 $ / 5 €。訂閱最高為 300 000 ₽ / 3 000 $ / 3 000 €,一次性商品最高為 1 000 000 ₽ / 10 000 $ / 10 000 €。

如果金鑰外洩

lava.top 卡片上有兩個不同的按鈕,作用各不相同:

  • 「重新產生 webhook 金鑰」會為傳入通知簽發新金鑰。新值必須貼到 lava.top 的 webhook 中;在此之前付款不會被確認。
  • 「輪替 Webhook URL」會簽發新位址。舊位址會立刻失效,同樣必須在 webhook 中更新。

如果外洩的是 API 金鑰本身,請在 lava.top 撤銷它,建立新的並貼進後台。

On this page