使用 lava.top 收款
逐步指南：如何把你的 lava.top 帳戶接上 CreateYourVPN，讓客戶付款自動變成訂閱——API 金鑰、一個 webhook，以及把報價與方案綁定。
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。CreateYourVPN 中方案的幣別是預設選項，但客戶可以切換到報價中提供的任何幣別。
- 讓扣款週期對應方案時長：月方案商品 ↔ 30 天，90 天 ↔ 90，依此類推。
- 只用「隱藏」可見性把商品從公開的 lava.top 頁面隱藏起來。不要啟用「價格透過 API 詢價」：我們的整合從固定價格報價建立付款，不會透過 API 傳送金額。直接購買可能不帶我們的標記並成為「未關聯」。隱藏的固定價格商品仍會出現在報價選擇器中。
lava.top 把商品的價格稱為報價（offer）。一個商品可以有多個報價（不同幣別與週期）——之後你為每個方案挑選的正是報價。
重複購買會怎樣
一次性商品沒有續訂：客戶還想要時，直接再買一次。這是正常流程，提前購買也很安全——天數會加在剩餘期限上，不會重新計算。剩十天再加一個新的月份，就是四十天。
只有一個例外，如果方案還提供流量：配額是取代而非累加。買了 100 GB、用掉 30 GB 又重新購買同一方案的客戶，得到的是全新的 100 GB，而不是 170 GB。為流量方案定價時請把這點考慮進去。
步驟 3. 在 CreateYourVPN 接上帳戶
lava.top 這邊要做的事都在同一處：左側選單的 Integrations，API 卡片。
建立 API 金鑰
開啟 API 卡片並按下 「Create API key」。金鑰只會顯示一次——請立刻複製：lava.top 不會再顯示第二次，遺失的金鑰只能換成新的。
把金鑰貼進你的後台
在 CreateYourVPN 開啟**「收益化」區塊，於 lava.top 卡片按下「連接」，把金鑰貼進「lava.top API 金鑰」**欄位並儲存。
我們會立刻驗證金鑰，回覆「金鑰已接受」——並附上帳戶中找到的商品數量——或是「lava.top 不接受這個金鑰」。
儲存之後，同一份表單會再出現兩個值：webhook URL 與 webhook 金鑰。下一步就把它們貼進 lava.top。webhook 金鑰由我們產生——你不必自己想。
新增 webhook
建立金鑰後 lava.top 會立即提示——按下 「+ Add Webhook」。之後在 API 頁面也有同樣的按鈕。
只需要一個 webhook —— 在事件類型欄位裡把需要的類型一次全部勾選：
URL —— 你後台裡的 webhook 位址。lava.top 只接受 HTTPS；我們的位址正是如此。
Event type —— 兩種類型都勾選：「Payment result」與「Recurring payment」。此清單支援多選，不必再建立第二個 webhook。
Type of authentication for Webhook —— 選擇 「API key of your service」，把後台的 webhook 金鑰貼進 「API key」 欄位。（Basic 也可以——我們接受——但那是兩個欄位而不是一個。）
Comment —— 選填，寫給自己看：像「CreateYourVPN —— 付款」這樣的備註，在你有多個整合時很有幫助。
lava.top 根本沒有請求簽章，因此正是 webhook 金鑰在告訴我們的接收端：這筆推送來自你的帳戶——請像對待密碼一樣對待它。
如果你販售訂閱，請不要取消勾選 「Recurring payment」：少了這個事件類型，續訂不會到達我們這裡，付費客戶的使用期會直接到期。一次性商品只勾選 **「Payment result」**就夠了，但兩個都勾著也完全沒問題。
API 金鑰讓我們能做什麼
lava.top 沒有「唯讀」金鑰——API 金鑰給的是對作者帳戶的完整存取權。我們只用它做三件事：在客戶按下「付款」的那一刻建立付款；讀取你的商品目錄供報價選擇器使用；以及在客戶於自己後台關閉自動續訂時取消訂閱。我們不改價格、不碰你的銷售匯出，也不用這把金鑰做其他任何事。金鑰以加密方式保存，不會在任何地方再次顯示，也不會進入我們的日誌。若你想切斷存取——在後台刪除該連接，金鑰會一併刪除。
步驟 4. 把報價綁到方案上
開啟**「方案」**，進入某個方案並找到 lava.top 區塊：
按下**「載入商品」**——我們會從你的 lava.top 帳戶取回目錄。
選擇這個方案所使用的報價。清單中可看到商品、價格與扣款週期。
若出現警告請留意。後台會告訴你報價缺少方案幣別的價格，以及扣款週期與方案時長不一致（「每 30 天扣款一次，但方案提供 365 天」）。
剛在 lava.top 建好商品卻在清單裡看不到？按下**「重新整理列表」**——目錄會快取一分鐘。
客戶可以選擇報價中提供的任何幣別。盧布一次性付款支援信用卡與 SBP，盧布訂閱只支援信用卡；USD 與 EUR 支援信用卡與 PayPal。
步驟 5. 用一筆真實付款驗證
用自己店面上的客戶帳號，親自買下最便宜的方案。一分鐘內，方案應該會出現在該帳號中，付款則應在紀錄中顯示為**「已處理」（「收益化」**區塊）。
如果沒有出現：
- 紀錄中完全沒有事件 —— lava.top 的 webhook 位址錯誤、沒有勾選需要的事件類型，或 webhook 金鑰與後台中的不一致。lava.top 的 webhook 歷史紀錄附有重新傳送按鈕——從那裡開始排查；
- 事件在，但顯示「未關聯」 —— 我們無法判斷這是誰的付款、對應哪個方案。直接在紀錄中手動關聯即可：訂閱會由與自動付款相同的程式碼發放；
- 「待處理」 —— 這筆付款需要人來決定：客戶在你的後台被封鎖，或是付款建立之後方案被改掛到另一個 lava.top 商品上。這裡我們不會自行更動權限——由你決定。
扣款失敗不必驚慌：lava.top 會在 8 小時與 24 小時後重試，我們不會因為一次失敗就中斷存取。失敗通知只會在最後一次嘗試後傳送；若訂閱被取消，就不會進行下一次續訂，已付費週期仍會持續到結束。
關於錢
- lava.top 的手續費是每筆成功付款的 8 %。它會立即扣除，而且在你之後退款給客戶時不會退還。
- 退款在 lava.top 後台的「銷售」區塊辦理；訂閱的退款會取消該訂閱。lava.top 目前還沒有針對退款與拒付的專屬 webhook 類型，因此這些你會在 lava.top 後台看到，而不是在我們的紀錄裡。
- 取消自動續訂。 客戶可以在你店面的自有後台自行取消——這時我們會請 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 撤銷它，建立新的並貼進後台。