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