Aceitar pagamentos com o lava.top
Guia passo a passo: como ligar a sua conta lava.top ao CreateYourVPN para que o pagamento de um cliente se transforme sozinho numa subscrição — chave de API, um webhook e a associação das ofertas aos seus planos.
O lava.top é um fornecedor de pagamentos que aceita cartões, SBP e PayPal em rublos, dólares e euros. Liga-o uma vez — e o pagamento na sua montra transforma-se sozinho numa subscrição ativa: não precisa de conceder o acesso à mão.
O dinheiro vai para a sua própria conta lava.top. O CreateYourVPN não é intermediário nos pagamentos e não cobra comissão sobre as suas vendas.
Aceitar pagamentos faz parte do plano pago Max — é ele que coloca a montra em modo de venda. Sobre os preços da plataforma, veja a lição sobre faturação.
Do que vai precisar
- uma conta em lava.top (uma conta de autor — a que vende);
- 10 a 15 minutos para a configuração inicial;
- uma quantia pequena para um pagamento de teste: o lava.top não tem ambiente de testes, por isso a única forma de verificar toda a configuração é uma compra real (mínimo 50 ₽ / 5 $ / 5 €).
Passo 1. Registo e verificação
Registe-se no lava.top e preencha o perfil — com o perfil vazio, a página de pagamento parece inacabada ao comprador.
Depois vá a Balance → verificação: documento e selfie, 18+, sem VPN ligada.
Vender pode mesmo antes da verificação, mas levantar o dinheiro sem ela não. Não a deixe para o primeiro pagamento.
Passo 2. Crie os seus produtos
No lava.top crie um ou mais produtos para os seus planos. Cada plano do CreateYourVPN precisa de uma oferta correspondente, mas um produto do lava.top pode conter várias ofertas, por exemplo mensal e anual.
- Para um plano recorrente escolha o tipo de produto «Subscrição» — o lava.top cobrará sozinho e cada renovação prolongará o acesso connosco.
- Para uma compra única, use um produto digital, curso ou consulta com preço fixo.
- Confirme que a oferta tem preço em pelo menos uma moeda suportada: RUB, USD ou EUR. A moeda do plano fica pré-selecionada na montra, mas o comprador pode mudar para qualquer outra moeda disponível na oferta.
- Alinhe o período de cobrança com a duração do plano: produto mensal ↔ 30 dias, 90 dias ↔ 90, e assim por diante.
- Esconda os produtos da sua página pública do lava.top através da definição de visibilidade. Não ative «Preço sob consulta via API»: o CreateYourVPN funciona atualmente com ofertas de preço fixo. Uma compra direta na página do lava.top chega sem a nossa marca e pode não ser associada a um plano; nesse caso surge como «Sem vínculo». Os produtos ocultos de preço fixo continuam visíveis no nosso seletor de ofertas.
Uma oferta é uma forma de vender o produto com determinado preço e período de cobrança. Um produto pode ter várias ofertas; depois escolherá a adequada para cada plano.
O que acontece numa compra repetida
Um produto único não tem renovações: quando o cliente quer mais, simplesmente compra outra vez. É um cenário normal, e comprar com antecedência é seguro — os dias somam-se ao que resta, não recomeçam do zero. Dez dias restantes mais um mês novo dão quarenta dias.
Uma exceção, se o plano também conceder tráfego: a quota é substituída, não somada. Um cliente que comprou 100 GB, gastou 30 e compra o mesmo plano de novo fica com 100 GB novos, não com 170. Tenha isso em conta no preço dos planos com tráfego.
Passo 3. Ligue a conta no CreateYourVPN
Tudo o que é preciso do lado do lava.top está num só sítio: Integrations no menu à esquerda, o cartão API.
Crie uma chave de API
Abra o cartão API e prima «Create API key». A chave é mostrada uma única vez — copie-a de imediato: o lava.top não a mostra uma segunda vez e uma chave perdida só pode ser substituída por uma nova.
Cole a chave no seu painel
No CreateYourVPN abra a secção «Monetização», prima «Conectar» no cartão lava.top, cole a chave no campo «Chave de API do lava.top» e guarde.
Verificamos a chave de imediato e respondemos «Chave aceite» — com o número de produtos encontrados na conta — ou «o lava.top não aceitou esta chave».
Logo depois de guardar aparecem no mesmo formulário mais dois valores: o URL do webhook e a chave do webhook. São esses que vai colar no lava.top no passo seguinte. A chave do webhook somos nós que a geramos — não tem de inventar nada.
Crie o webhook
O lava.top propõe isso logo a seguir à criação da chave — prima «+ Add Webhook». O mesmo botão continua disponível depois, na página de API.
Basta um webhook: no campo do tipo de evento marcam-se de uma vez todos os tipos necessários:
URL — o endereço do webhook do seu painel. O lava.top só aceita HTTPS; o nosso já é.
Event type — marque os dois tipos: «Payment result» e «Recurring payment». A lista é de seleção múltipla, por isso não é preciso um segundo webhook.
Type of authentication for Webhook — escolha «API key of your service» e cole no campo «API key» a chave do webhook do painel. (Basic também serve — aceitamos —, mas são dois campos em vez de um.)
Comment — opcional, para si: uma nota como «CreateYourVPN — pagamentos» ajuda quando tem várias integrações.
O lava.top não adiciona uma assinatura criptográfica ao corpo do pedido, por isso a chave secreta do webhook autentica a entrega. Trate-a como uma palavra-passe.
Não desmarque «Recurring payment» se vende subscrições: sem esse tipo de evento as renovações não nos chegam e o acesso de um cliente que paga acaba por expirar. Para produtos de pagamento único chega «Payment result», mas deixar os dois marcados é igualmente seguro.
O que nos dá a chave de API
O lava.top não tem chaves «só de leitura» — uma chave de API dá acesso total à conta de autor. Usamo-la para exatamente três coisas: criar um pagamento no momento em que o cliente carrega em «Pagar»; ler o seu catálogo de produtos para o seletor de ofertas; cancelar uma subscrição quando o cliente desliga a renovação automática no painel dele. Não alteramos preços, não mexemos na exportação das suas vendas e não fazemos mais nada com esta chave. Fica guardada cifrada, não volta a ser mostrada em lado nenhum e não aparece nos nossos registos. Se quiser cortar o acesso, elimine a ligação no painel — a chave é apagada com ela.
Passo 4. Associe as ofertas aos seus planos
Abra «Planos», entre num plano e encontre o bloco lava.top:
Prima «Carregar produtos» — vamos buscar o catálogo à sua conta lava.top.
Escolha a oferta com que este plano é vendido. Na lista vê-se o produto, o preço e o período de cobrança.
Verifique os avisos, se aparecerem. O painel dir-lhe-á quando a oferta não tem preço na moeda do plano e quando o período de cobrança não coincide com a duração do plano («cobra a cada 30 dias, mas o plano concede 365»).
Acabou de criar um produto no lava.top e não o vê na lista? Prima «Atualizar lista» — o catálogo fica em cache durante um minuto.
O comprador pode alternar entre todas as moedas disponíveis na oferta selecionada. Para um pagamento único em rublos mostramos cartão e SBP; para uma subscrição em rublos, apenas cartão. Em dólares e euros estão disponíveis cartão e PayPal.
Passo 5. Verifique com um pagamento real
Compre você mesmo o plano mais barato, a partir de uma conta de cliente na sua montra. Dentro de um minuto o plano deve aparecer nessa conta e o pagamento no registo com o estado «Processado» (secção «Monetização»).
Se não acontecer:
- o evento não está de todo no registo — o webhook no lava.top aponta para o endereço errado, não tem marcados os tipos de evento necessários, ou a sua chave não coincide com a do painel. O lava.top guarda um histórico de webhooks com botão de reenvio — comece por aí;
- o evento está lá, mas «Sem vínculo» — não percebemos de quem é o pagamento nem por que plano. Associe-o à mão no próprio registo: a subscrição será concedida pelo mesmo código de um pagamento automático;
- «Precisa de atenção» — o pagamento exige uma decisão humana: o cliente está bloqueado no seu painel, ou o plano passou a apontar para outro produto do lava.top depois de o pagamento ter sido criado. Aqui não mexemos no acesso por iniciativa própria — quem decide é você.
Se não for possível cobrar uma renovação, o lava.top faz mais duas tentativas, após 8 e 24 horas, e envia o aviso de falha apenas depois da última. Não retiramos o acesso por uma cobrança falhada: o período já pago vai sempre até ao fim. Um aviso de cancelamento apenas indica que não haverá outra renovação.
Sobre o dinheiro
- A comissão do lava.top é de 8 % sobre cada pagamento bem-sucedido. É retida de imediato e não é devolvida se depois reembolsar o cliente.
- O reembolso faz-se no painel do lava.top, secção «Vendas»; um reembolso numa subscrição cancela-a. O lava.top ainda não tem um tipo de webhook próprio para reembolsos e chargebacks, por isso vê-los-á no painel do lava.top e não no nosso registo.
- Cancelar a renovação automática. O cliente pode fazê-lo sozinho no painel dele na sua montra — pedimos então ao lava.top que cancele a subscrição — ou na própria conta lava.top; também pode cancelá-la por ele a partir do seu painel lava.top. O cancelamento não retira o acesso: ele vigora até ao fim do período já pago, e nós deixamos simplesmente de esperar a cobrança seguinte.
- Um chargeback pode ser aberto até 540 dias após o pagamento, e tem 3 dias para apresentar provas. Guarde as condições da sua montra e a correspondência com o cliente — as provas são exatamente isso.
- Os limites dependem do tipo de produto. O mínimo é sempre 50 ₽ / 5 $ / 5 €. Para subscrições, o máximo é 300 000 ₽ / 3 000 $ / 3 000 €; para produtos de pagamento único, 1 000 000 ₽ / 10 000 $ / 10 000 €.
Se uma chave for exposta
No cartão do lava.top há dois botões diferentes, e fazem coisas diferentes:
- «Renovar a chave do webhook» — emite uma chave nova para as notificações recebidas. O novo valor tem de ser colado no webhook do lava.top; até o fazer, os pagamentos não serão confirmados.
- «Rotacionar URL do webhook» — emite um endereço novo. O antigo deixa de funcionar de imediato e também tem de ser atualizado no webhook.
Se foi a própria chave de API a ser exposta, revogue-a no lava.top, crie uma nova e cole-a no painel.
Como configurar o seu servidor (modo «Servidor único»)
Guia passo a passo: como ligar o seu VPS ao CreateYourVPN no modo «Servidor único» — desde alugar um servidor até ter uma VPN pessoal pronta em poucos minutos.
Happ
Como instalar o aplicativo Happ no seu celular ou computador, o que fazer se ele estiver indisponível no seu país e como se conectar usando o link da sua conta.