Recebendo pagamentos num funil com a Lava

Venda direto no chat — o comprador toca num botão, paga e o bot entrega o acesso sozinho. Passo a passo, incluindo as armadilhas em que já tropeçamos.

Seu funil pode receber dinheiro: a pessoa chega à etapa Pagamento, recebe um botão, paga — e o bot entrega o acesso e continua o funil sozinho. Você não precisa fazer nada, de dia ou de noite.

Os pagamentos passam pela Lava.top — um serviço de pagamento que trabalha com pessoas físicas e empreendedores individuais e aceita cartões e SBP (o sistema russo de transferências bancárias instantâneas).

Como funciona#

1. A pessoa passa pelo funil e chega à etapa Pagamento.
2. O bot cria uma cobrança pessoal na sua conta da Lava e envia um botão de pagamento — no Telegram, dois de uma vez: ⚡️ Pagar via SBP e 💳 Pagar com cartão.
3. A pessoa paga na página da Lava.
4. A Lava nos avisa, o bot reconhece o comprador e continua o funil — pela seta que sai da etapa Pagamento. É ali que você entrega o acesso: um link de canal, um convite para um chat, um arquivo.

Você só precisa configurar uma vez. Depois disso, o funil roda sozinho.

O que você vai precisar#

• Uma conta na lava.top com um método de saque confirmado.
• Um funil já montado na Craft (Telegram ou Instagram).
• 15 minutos.

Passo 1. Crie um produto na Lava#

No painel da Lava: Criar → Produto digital.

Preencha:

• Descrição — o que a pessoa está comprando.
• "Depois do pagamento" (a parte paga) — coloque aqui os links do seu canal/chat. A Lava também os envia por email ao comprador. Essa é a sua rede de segurança: mesmo que algo aconteça com o bot, o comprador recebe o acesso.
• Preço — você pode defini-lo em várias moedas ao mesmo tempo.

Depois publique o produto.

Os dois campos — descrição e parte paga — são obrigatórios: o produto não salva sem eles.

Quem define o preço: a Lava ou o funil#

O produto tem a opção "Preço sob demanda via API". Ela decide de onde vem o valor da cobrança, então escolha de propósito.

Um preço que nunca muda → deixe desativado, é mais simples. Planeja um timer "o preço sobe em 24 horas", promoções ou preços diferentes por ramo → ative: veja O funil define o preço.

Passo 2. Pegue o offerId#

Uma cobrança precisa do offerId — que NÃO é o número que você vê no endereço do produto.

Duas formas de obtê-lo:

O jeito fácil: mande para nós o link do produto e procuramos para você.

Por conta própria (se você se sente à vontade com a linha de comando) — use a sua chave da Lava:

curl -s "https://gate.lava.top/api/v2/products?showAllSubscriptionPeriods=true" \
  -H "X-Api-Key: YOUR_LAVA_KEY"

Encontre seu produto na resposta — o valor que você precisa fica em offers → id. Ele se parece com 8665127d-....

Passo 3. Conecte a Lava na Craft#

Na Craft: Configurações → "Pagamentos nos funis (Lava)". Cole sua chave de API da Lava (na Lava: Integrações → Public API) e clique em "Conectar". A Craft verifica a chave com a Lava na hora — uma chave errada aparece aqui, não na sua primeira venda.

Depois de conectar, a mesma página mostra o endereço do webhook e o segredo de que você precisa no próximo passo, além do botão "Produtos e seus ids", que lista seus produtos e o offerId exato usado pela etapa Pagamento.

Passo 4. Configure o webhook#

O webhook é como a Lava nos conta o que aconteceu com um pagamento: aprovado, recusado, reembolsado. Sem ele, o bot nunca fica sabendo do pagamento e não libera acesso.

Na Lava: Integrações → Public API → Add Webhook.

Passo 5. Monte a etapa Pagamento#

No construtor de funis, adicione uma etapa Pagamento e preencha:

• Produto da Lava (offerId) — o do passo 2.
• Preço (para exibição) e Moeda — afetam só o texto da mensagem; a Lava cobra o preço do próprio produto.
• Mensagem com o botão de pagamento — o texto da sua oferta; os botões aparecem abaixo dele.
• Texto do botão — usado quando há só um método de pagamento.
• Variável de email — onde fica guardado o email do comprador.

Como pedir para as pessoas não desistirem. "Vamos te enviar um recibo" soa opcional — o comprador pensa "não preciso de recibo" e simplesmente não responde. É uma perda cara: ele já tinha concordado em pagar. Não diga "não dá para continuar sem isso" — diga o que acontece quando ele enviar:

Falta um passo. Me manda seu email: vou usar para o seu pedido e já respondo com o botão de pagamento. O recibo também vai para lá. E o acesso ao curso eu mando aqui neste chat, logo depois do pagamento.

E dê a essa etapa Pergunta um tempo limite com lembrete — senão quem se distrai some em silêncio.

A seta que sai da etapa Pagamento é por onde o funil continua depois de um pagamento aprovado. É a etapa em que você entrega o acesso: o link do canal privado, o convite para o chat, o arquivo.

Métodos de pagamento#

No Telegram, o comprador recebe dois botões: "⚡️ Pagar via SBP" e "💳 Pagar com cartão (cartões russos)". Isso converte melhor — as pessoas pagam com o que estão acostumadas.

• Moeda que não seja o rublo → só cartão (o SBP é em rublos).
• Se um dos métodos não estiver habilitado na sua conta da Lava, os outros botões chegam mesmo assim — o funil não quebra.

Cartões estrangeiros têm um botão próprio. "💳 Pagar com cartão (cartões russos)" emite uma cobrança em rublos, e ela não aceita cartões estrangeiros: a página de pagamento trava e a cobrança nunca chega ao banco (confirmado com um pagamento real). Se parte dos seus compradores está no exterior, preencha "Preço para cartões estrangeiros" na etapa Pagamento — por exemplo, $49. Aparece um terceiro botão, "🌍 Pagar com cartão estrangeiro": uma cobrança em dólar ou euro que aceita cartões de qualquer país.

• Funciona com "O funil define o preço" marcado. Se o produto da Lava define o preço, o produto precisa de um preço nessa moeda.
• Escolha um número redondo próximo do preço em rublos — por exemplo, 3.490 ₽ → $49.
• Só no Telegram por enquanto.
• Apple Pay. Abaixo do campo de preço há uma caixa de seleção, "Botão '🍎 Apple Pay com cartão estrangeiro'" — mais um botão pelo mesmo preço estrangeiro. A página do cartão estrangeiro não oferece Apple Pay sozinha, então ele ganha um botão próprio. Funciona no iPhone e no Mac com um cartão estrangeiro na Carteira: cartões russos não podem ser adicionados ao Apple Pay, e a Lava não o aceita em rublos.
• PayPal. Mais uma caixa de seleção — "Botão '🅿️ Pagar com PayPal'": uma cobrança pelo mesmo preço estrangeiro para quem não tem um cartão adequado. O PayPal precisa estar habilitado na sua conta da Lava — se não estiver, a Lava recusa e o comprador simplesmente não vê esse botão (os outros continuam).
• Página de pagamento em inglês. Os botões estrangeiros (cartão, Apple Pay, PayPal) abrem a página da Lava e os emails de pagamento em inglês — já que são os compradores do exterior que os usam. Os botões em rublos continuam em russo.
• A confirmação demora mais. Um pagamento em rublos chega ao bot em alguns segundos; um estrangeiro às vezes leva 5–10 minutos: a página de pagamento manda o comprador direto de volta ao bot, e o acesso chega quando o banco liquida a cobrança. Para o comprador não entrar em pânico nem pagar duas vezes, diga isso no texto da etapa Pagamento — por exemplo: "Às vezes o banco leva 5–10 minutos para confirmar um pagamento — seu acesso vai chegar aqui sozinho mesmo assim, não precisa pagar de novo."

No Instagram chega um único botão de pagamento — cartão. Mais um motivo para levar os compradores para o Telegram se você vende na Rússia.

Quando alguém não paga#

O ponto mais caro de um funil é a pessoa que abriu a página de pagamento e fechou. Para ela não ficar no silêncio, a etapa Pagamento tem o campo "Lembrete se não pagar": quanto tempo esperar pelo pagamento antes de mandá-la para um ramo separado.

Preencha e a etapa ganha uma segunda saída, "Não pagou". Para onde essa seta levar é por onde o funil vai se o pagamento nunca chegar.

O que escrever nessa mensagem: geralmente a pessoa não pagou não porque mudou de ideia, mas porque o banco recusou a cobrança ou o link abriu no navegador errado. Ofereça o outro método de pagamento (cartão em vez de SBP ou o contrário) e o seu contato pessoal. E adicione um botão que leva de volta à etapa Pagamento — ele emite uma cobrança nova.

Uma espera razoável é de 10–20 minutos: as pessoas pagam na hora ou já seguiram em frente.

Deixe o campo vazio e não há ramo — quem não paga não ouve mais nada.

Quando o banco recusa o pagamento#

É outro caso: a pessoa queria pagar, mas o cartão não passou — saldo insuficiente, o banco bloqueou, o código não foi confirmado. Aqui o bot age sozinho, nada para configurar:

1. Ele diz à pessoa por que falhou, em palavras simples, e sugere outro método — cartão em vez de SBP, ou outro cartão.
2. Ele envia na hora novos botões de pagamento na mesma etapa, pelo mesmo preço.
3. Ele avisa você: quem, quanto, qual método e o que o banco disse. Se a pessoa não pagar logo, escreva para ela você mesmo — essa pessoa queria comprar.

Se alguém tentou SBP e depois pagou com cartão, não recebe a mensagem "não passou". Duas falhas seguidas geram uma mensagem, não duas.

Depois de pagar ou falhar, a Lava manda a pessoa de volta ao chat com o bot em vez de deixá-la na página dela.

O mesmo vale para a etapa "Pergunta" que você usa para coletar o email: ela tem um tempo limite e uma saída "Sem resposta". Sem isso, quem começa a compra e desiste no campo de email também some em silêncio. Defina 5 minutos e um lembrete: "Ainda estou esperando o seu email."

O funil define o preço (promoções e timers)#

Normalmente o preço fica no produto da Lava. Então "o preço sobe em 24 horas" ou "um desconto para este ramo" exige um segundo produto — e a partir daí você fica administrando dois produtos e dois offerIds.

Há um segundo modo: o funil define o valor da cobrança. Um produto da Lava serve para qualquer preço, e aumentos de preço e promoções são montados como ramos do funil.

Como ativar:

1. Na Lava, ative "Preço sob demanda via API" no produto (a essa altura você já deve ter o offerId — veja o aviso no passo 2).
2. Na etapa Pagamento, marque "Este funil define o preço".
3. O valor vem do campo "Preço" dessa etapa. Precisa de um segundo preço? Adicione uma segunda etapa Pagamento em outro ramo com um preço diferente.

O que você ganha: o preço na mensagem e o preço na cobrança passam a ser o mesmo número do mesmo campo — nada pode se desencontrar. Um timer "a promoção acaba em", preços diferentes por palavra-chave, um visitante que volta vendo o preço novo — tudo isso são ramos de um funil.

O que saber de antemão:

Como testar#

Primeiro as verificações mais baratas.

Sem gastar dinheiro:

1. Passe pelo seu próprio funil até a etapa Pagamento e espere os botões. Os botões apareceram — sua chave funciona, o produto está publicado e o offerId está certo.
2. Toque no botão e olhe a página: há escolha de método, o valor certo, o nome certo do produto? Não pague — criar uma cobrança por si só não mexe em dinheiro.
3. Confira se o funil pede um email antes do pagamento e o guarda.

Com dinheiro (a verificação final, uma vez):

A Lava não tem modo de teste — é a resposta oficial deles. Então a única forma de verificar a cadeia inteira é um pagamento real de valor pequeno.

1. Defina temporariamente um preço pequeno (no produto da Lava, ou no campo "Preço" da etapa Pagamento se o funil define o preço).
2. Pague você mesmo, uma vez por método se você vende com cartão e SBP.
3. Confirme que o acesso chega no bot automaticamente.
4. Restaure o preço real na hora.

Testando o funil inteiro#

Se o seu funil tem lembretes com timers e mais de um preço, testá-lo "como está" leva um dia. O jeito rápido:

1. Salve suas configurações reais antes — anote o atraso de cada etapa antes de mudar qualquer coisa, senão você não vai restaurar os tempos com exatidão.
2. Defina todos os atrasos como 5 segundos e os preços como valores pequenos e diferentes (por exemplo, 50 ₽ e 55 ₽), para o valor dizer qual ramo disparou.
3. Percorra o funil com outra conta que nunca passou por ele: quem já passou cai no meio do funil, não no início.
4. Percorra duas vezes: uma sem tocar em nada — você verá a cadeia inteira de lembretes; outra tocando em tudo — você verá o caminho curto.
5. Pague os dois ramos com os valores pequenos e confirme que o acesso chega sozinho.
6. Restaure os atrasos e preços reais.

Pagaram, mas não receberam acesso#

Confira nesta ordem — nove em cada dez vezes é um dos dois primeiros.

1. O webhook está configurado na Lava, o segredo certo está no campo "Chave de API" e os quatro eventos estão marcados (passo 3)? Sem webhook, a Lava nunca nos contou do pagamento, então o bot não tinha como reagir.
2. Instagram e a regra das 24 horas. Se o pagamento aconteceu mais de um dia depois da última mensagem da pessoa, a Meta não deixa o bot escrever para ela.
3. A pessoa comprou pelo botão do funil, e não por um link direto do produto (veja o aviso acima)?
4. O email chegou à etapa de pagamento? Uma variável de email vazia significa nenhuma cobrança.

Ainda travado — escreva para nós no Telegram com o horário do pagamento e o email do comprador. Vamos verificar o que chegou do nosso lado e, se necessário, liberar o acesso manualmente — o comprador recebe no bot exatamente como num pagamento normal.

Erros comuns#

Ainda não suportado#

Sendo transparentes sobre os limites, para não haver surpresas:

• Remoção automática do acesso em caso de reembolso. Avisamos na hora sobre um reembolso ou uma contestação bancária, mas remover a pessoa do canal ou do chat fica com você.
• Assinaturas e pagamentos recorrentes. Só compras avulsas por enquanto.
• Preços definidos pelo funil e a escolha do método de pagamento são só do Telegram. No Instagram, o preço fica no produto da Lava e há um único botão.
• Conectar as chaves sozinho. Por enquanto passa por nós e leva minutos.

Precisa de algo desta lista — conte para nós. Construímos o que as pessoas realmente pedem.