使用 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 卡片。

创建 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 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 撤销它,创建一个新的并粘贴到后台。