Aceitar pagamentos com o lava.top
Guia passo a passo: conecte o lava.top ao CreateYourVPN para que seus clientes recarreguem o saldo na sua vitrine. Chave de API, webhook, valores de recarga e recarga automática.
O lava.top aceita cartões, SBP e PayPal em rublos, dólares e euros. Seus clientes o usam para recarregar o saldo na área do cliente da sua vitrine e compram os planos com esse saldo: você não precisa liberar o acesso manualmente.
O lava.top trabalha com valores fixos: o cliente escolhe um dos valores de recarga que você configurar, e cada valor tem a sua própria oferta com o mesmo preço. O cliente não pode digitar um valor próprio. Se você quiser aceitar qualquer valor, conecte também o PayHot.
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 está disponível no plano pago Max: com ele, a sua vitrine começa a vender e o saldo dos clientes é ativado sozinho. Sobre os preços da plataforma, veja a aula sobre cobrança.
Do que você vai precisar
- uma conta no lava.top (uma conta de autor, ou seja, a que vende);
- 10 a 15 minutos para a configuração inicial;
- um pequeno valor para uma recarga de teste: o lava.top não tem modo de teste, então a única forma de verificar toda a configuração é um pagamento real (o mínimo é 50 ₽ / 5 $ / 5 €).
Passo 1. Cadastro e verificação
Cadastre-se no lava.top e preencha o perfil: com o perfil vazio, a página de pagamento parece inacabada para o comprador.
Depois vá em Balance → verificação e conclua-a: documento e selfie, 18+, sem VPN ligada.
Você pode vender antes da verificação, mas não pode sacar o dinheiro sem ela. Não deixe a verificação para o primeiro saque.
Passo 2. Crie seus produtos
O preço de uma oferta do lava.top é o valor da recarga. Crie tantas ofertas quantos forem os valores que você quer oferecer aos clientes.
- Recarga avulsa: um produto digital, curso ou consultoria com preço fixo. Uma oferta dá um valor, por exemplo 300, 500 ou 1000 ₽.
- Recarga automática: um produto do tipo «Assinatura». O lava.top cobra o preço da oferta automaticamente, na periodicidade dela (todo mês, a cada 3 meses, a cada 6 meses ou todo ano), e cada cobrança recarrega o saldo do cliente.
- A oferta precisa ter preço na moeda da conta dos clientes. A moeda aparece na seção «Monetização», no cartão «Saldo dos clientes». O lava.top aceita rublos, dólares e euros.
- Oculte os produtos da sua página pública do lava.top pela configuração de visibilidade. Não ative «Preço sob consulta via API»: o CreateYourVPN funciona com ofertas de preço fixo. Uma compra feita direto na sua página do lava.top chega sem a nossa marca, e não vamos saber de quem é o pagamento. Os produtos ocultos de preço fixo continuam aparecendo no seu painel.
Uma oferta no lava.top é uma forma de vender um produto com determinado preço e período de cobrança. Um produto pode ter várias ofertas, e no painel você escolhe a certa para cada valor.
Passo 3. Conecte a conta no CreateYourVPN
Tudo o que é preciso do lado do lava.top fica num só lugar: Integrations no menu à esquerda, o cartão API.
Crie uma chave de API
Abra o cartão API e clique em «Create API key». A chave é mostrada uma única vez, então copie-a na hora: o lava.top não a mostra de novo, e uma chave perdida só pode ser substituída por uma nova.
Cole a chave no seu painel
No CreateYourVPN, abra a seção «Monetização», clique em «Conectar» no cartão lava.top, cole a chave no campo «Chave de API do lava.top» e salve.
Verificamos a chave na hora e respondemos «Chave aceita», com o número de produtos encontrados na conta, ou «O lava.top não aceitou esta chave».
Logo depois de salvar, aparecem no mesmo formulário mais dois valores: Webhook URL e chave do webhook. São eles que você vai colar no lava.top no próximo passo. A chave do webhook é gerada por nós, você não precisa inventar nada.
Adicione o webhook
O lava.top oferece isso logo depois que a chave é criada: clique em «+ Add Webhook». O mesmo botão continua disponível depois, na página de API.
Basta um webhook: no campo «Tipo de evento», todos os eventos são marcados de uma vez.
URL: o endereço do webhook do seu painel. O lava.top só aceita HTTPS, e o nosso já é.
Tipo de evento: marque todos os eventos da lista. A seleção é múltipla, então 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 seu painel. Basic também serve, nós aceitamos, mas são dois campos em vez de um.
Comment: opcional, para você. Uma nota como «CreateYourVPN, pagamentos» ajuda quando há várias integrações.
O lava.top não adiciona uma assinatura criptográfica ao corpo da requisição, por isso é a chave do webhook que autentica a entrega. Trate-a como uma senha.
Não deixe nenhum evento desmarcado: sem os eventos de pagamentos recorrentes, as recargas automáticas dos seus clientes nunca chegam ao saldo. Marcar tudo é sempre seguro.
O que a chave de API nos dá
O lava.top não tem chaves «somente leitura»: uma chave de API dá acesso total à conta de autor. Nós a usamos para exatamente três coisas: criar um pagamento quando um cliente clica em «Pagar»; ler o seu catálogo de produtos para você escolher as ofertas no painel; e cancelar uma assinatura quando um cliente desativa a recarga automática ou a renovação automática na área do cliente. Nunca alteramos preços, nunca exportamos as suas vendas e não mexemos em mais nada. A chave fica guardada criptografada, nunca mais é exibida e nunca aparece nos nossos logs. Se um dia você quiser cortar o acesso, remova a conexão no painel: a chave é excluída junto com ela.
Passo 4. Adicione os valores de recarga
Abra «Planos» e encontre o bloco «Recarga de saldo».
Clique em «Adicionar recarga», escolha uma oferta avulsa na lista «Oferta do lava.top» e clique em «Adicionar recarga» na janela. O valor fica igual ao preço da oferta. Adicione assim cada valor, até 20.
Para uma recarga automática, clique em «Adicionar recarga automática», escolha uma assinatura do lava.top e clique em «Adicionar recarga automática» na janela. A oferta define o valor e a frequência, por exemplo 500 ₽ todo mês. O painel mostra para qual plano essa recarga dá.
Confira os avisos nas linhas, se houver. O painel avisa quando a oferta não tem preço na moeda do saldo, quando o preço dela difere do valor e quando ela não existe mais no lava.top.
Acabou de criar um produto no lava.top e não o vê na lista? Clique em «Atualizar lista»: o catálogo fica em cache por um minuto.
Enquanto você não adicionar nenhum valor nem conectar o PayHot, seus clientes não têm como recarregar: na janela «Recarregar saldo» eles veem «A recarga ainda não está disponível». Adicione pelo menos um valor igual ou maior que o preço do seu plano mais caro: assim um cliente com o saldo zerado pode recarregar e comprar o plano com um só pagamento, pelo botão «Recarregar e comprar».
No próprio plano não se escolhe oferta: um plano na moeda da conta é comprado com o saldo. A exceção é um plano com preço em outra moeda e vinculado antes a uma oferta: o cliente paga por ele diretamente pelo lava.top.
O que o cliente vê
Na área do cliente da sua vitrine, o cliente clica em «Recarregar». Na aba «Única», ele escolhe um dos seus valores e uma forma de pagamento: cartão, SBP (só rublos) ou PayPal, se a oferta tiver preço em dólares ou euros. Na aba «Automática», ele ativa uma recarga automática: com cartão ou PayPal, porque as assinaturas do lava.top não aceitam SBP. O saldo sempre recebe o valor da recarga na moeda da conta, mesmo quando o cliente pagou em outra moeda.
A recarga automática precisa de um plano do tipo assinatura com duração e preço na moeda da conta: sem ele, o cliente não tem a aba «Automática». Ela funciona junto com a renovação automática do plano com o saldo: a renovação automática é ativada sozinha quando o cliente ativa a recarga automática, e, se o cliente ainda não tiver um plano, a primeira cobrança o compra. Cada cliente tem uma única recarga automática.
Passo 5. Verifique com um pagamento real
A partir de uma conta de cliente na sua vitrine, recarregue o saldo com o menor valor. Em até um minuto, o dinheiro deve aparecer no saldo, e na seção «Monetização», no «Registro de pagamentos», deve aparecer uma recarga de saldo com o status «Processado». Depois compre um plano com o saldo.
Se isso não acontecer:
- o evento nem aparece no registro: o webhook no lava.top aponta para o endereço errado, não tem todos os eventos marcados ou a chave dele não bate com a do painel. O lava.top tem um histórico de webhooks com botão de reenvio, um bom ponto de partida;
- o evento está lá, mas o dinheiro não está no saldo: o evento traz a nota «Não creditado no saldo» com uma dica. Verifique o pagamento no lava.top e credite o valor com um ajuste no cartão do cliente;
- «Sem vínculo»: não conseguimos saber de quem é o pagamento. Isso acontece quando um cliente comprou um produto direto na sua página do lava.top, sem passar pela vitrine. Encontre o cliente e credite o valor com um ajuste no cartão dele;
- «Precisa de atenção»: o evento precisa de uma decisão sua, e o próprio evento diz o que fazer.
Se uma cobrança da assinatura falhar, o lava.top faz mais duas tentativas, depois de 8 e 24 horas, e só envia o aviso de falha depois da última. O cliente vê na área do cliente que a última cobrança não foi concluída. O dinheiro que já está no saldo continua com o cliente.
Sobre o dinheiro
- Comissão do lava.top: 8 % de cada pagamento bem-sucedido. Ela é descontada na hora e não é devolvida se você reembolsar o cliente depois.
- Os reembolsos são feitos no painel do lava.top, na seção «Vendas»; um reembolso de uma assinatura cancela a assinatura. O aviso de reembolso ou chargeback chega ao registro com o status «Precisa de atenção». O saldo do cliente não diminui sozinho depois de um reembolso: debite o mesmo valor com um ajuste no cartão do cliente.
- Desativar a recarga automática. O cliente a desativa na área do cliente da sua vitrine, e pedimos ao lava.top que cancele a assinatura. Se o cliente desativar a renovação automática do plano, a recarga automática é desativada junto. Você também pode cancelar a assinatura no painel do lava.top. Em todo caso, o dinheiro no saldo não se perde.
- Um chargeback pode ser aberto até 540 dias depois do pagamento, e você tem 3 dias para apresentar provas. Guarde os seus termos de venda, a correspondência com o cliente e as provas de que o acesso foi liberado.
- Os limites de pagamento dependem do tipo de produto. O mínimo é sempre 50 ₽ / 5 $ / 5 €. Para assinaturas, o máximo é 300 000 ₽ / 3 000 $ / 3 000 €; para produtos avulsos, 1 000 000 ₽ / 10 000 $ / 10 000 €.
Se uma chave for exposta
No cartão do lava.top há dois botões diferentes, e eles fazem coisas diferentes:
- «Renovar a chave do webhook» emite uma chave nova para as notificações recebidas. Cole o novo valor no webhook do lava.top; enquanto você não fizer isso, os pagamentos não serão confirmados.
- «Rotacionar URL do webhook» emite um endereço novo. O antigo para de funcionar na hora; atualize-o também no webhook.
Se a própria chave de API foi 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.
Aceitar pagamentos com o PayHot
Guia passo a passo: conecte o PayHot ao CreateYourVPN para que seus clientes recarreguem o saldo com qualquer valor por cartão, SBP ou criptomoeda. Solicitação de cadastro, chave de API, webhook, métodos de pagamento e recarga automática.