22 de novembro de 2026

Pix no Lovable: como receber Pix no app que você criou com IA

Pix no Lovable: a doc dos pagamentos nativos não cita Pix. Veja como receber no app com API, Edge Function, webhook assinado e modo teste.

Para ter Pix no Lovable, você chama a API de um gateway brasileiro numa função de backend (Edge Function do Supabase ou Lovable Cloud) e só libera o acesso quando o webhook confirma o pagamento. Os pagamentos nativos do Lovable rodam na Stripe e na Paddle, e a doc deles não cita Pix. Se ainda está decidindo entre o nativo e um gateway, veja o que os pagamentos nativos do Lovable cobrem no Brasil.

Este tutorial mostra o caminho com a AbacatePay: a chave fica no backend, a cobrança sai como link de checkout ou QR Code dentro do app, o webhook chega assinado e tudo pode ser testado sem dinheiro real.


O Lovable aceita Pix?

Os pagamentos nativos do Lovable rodam na Stripe e na Paddle, pedem plano Pro e a doc deles não cita Pix; para Pix, você usa um conector brasileiro (a doc do Lovable lista Mercado Pago e Asaas) ou chama a API de um gateway, como a AbacatePay, numa função de backend.

Caminho Pix citado na doc Plano do Lovable Onde a chave fica Quem confirma o pagamento
Nativo (Stripe ou Paddle) Não: a doc dos nativos não cita Pix Pro ou superior (no Free, dá para conectar a sua própria conta Stripe) O Lovable cuida da conexão com o provedor O provedor, pela integração que o Lovable monta
Conector (Mercado Pago ou Asaas) Sim: QR Code Pix e copia e cola na página do app A doc do conector não fala em plano Pro Na conexão do conector, com o token ou a chave da sua conta O app marca o pedido como pago depois que o provedor confirma
API de gateway (AbacatePay, via Edge Function) Sim: Pix por checkout hospedado ou QR Code no app Não depende dos pagamentos nativos Nos secrets do backend (Edge Function), nunca no front O webhook assinado da AbacatePay

Na página de integrações da AbacatePay, o Lovable aparece como integração “Via API”, feita pela API e pelos webhooks. É o caminho que este post mostra.


O que você precisa antes de começar

Você precisa de três coisas: uma conta na AbacatePay no Modo Teste (a chave de teste começa com abc_dev_ e não é preciso verificar a conta para testar), um backend no projeto do Lovable (Lovable Cloud ou o seu Supabase) e um secret para o webhook, que você define ao cadastrar o endpoint.


Passo 1: peça a integração ao Lovable com o llms.txt

Cole o endereço do llms.txt da AbacatePay no chat do Lovable e peça uma função de backend que crie a cobrança Pix e um endpoint de webhook; é o caminho que a página de integrações da AbacatePay recomenda para o Lovable, com a chave numa Edge Function e o webhook avisando o app.

O llms.txt fica em https://docs.abacatepay.com/llms.txt e resume a API para o modelo ler. Um prompt de partida:

Leia https://docs.abacatepay.com/llms.txt e integre a AbacatePay neste app para receber Pix.

1. Crie uma Edge Function que cria a cobrança na API v2 da AbacatePay.
   A chave de API fica no secret ABACATEPAY_API_KEY, nunca no front.
   O valor do produto vem do banco de dados, não do navegador.
2. Mostre o QR Code Pix e o copia e cola na tela de pagamento.
3. Crie uma Edge Function de webhook com o pacote @abacatepay/supabase,
   usando o secret ABACATEPAY_WEBHOOK_SECRET.
   Só marque o pedido como pago em transparent.completed ou checkout.completed,
   e ignore entregas com um id que já foi processado.
4. Use a chave do Modo Teste (abc_dev_) por enquanto.

Revise o código que o Lovable gerar antes de publicar, principalmente onde a chave é lida e quando o acesso é liberado.


A função de backend chama a API com a chave e devolve ao front só o que ele precisa: o link do checkout hospedado ou o QR Code do Checkout Transparente (brCode e brCodeBase64) para mostrar dentro do app.

Os dois caminhos da API v2, segundo o llms.txt:

O preço vem do servidor, nunca do navegador: a função lê o valor do produto no banco e ignora qualquer valor que o front mande. As duas chaves usam a mesma URL, https://api.abacatepay.com/v2; o que muda o ambiente é a chave.


Passo 3: confirme o pagamento pelo webhook antes de liberar o acesso

Libere o acesso só quando chegar checkout.completed ou transparent.completed, depois de conferir o secret e a assinatura HMAC; o pacote @abacatepay/supabase faz essa conferência e entrega o evento validado à sua função.

Cada entrega é um POST JSON com o secret na URL (?webhookSecret=) e no header X-Webhook-Secret, e a assinatura HMAC-SHA256 do corpo no header X-Webhook-Signature. O pacote confere o secret com comparação segura, valida a assinatura e o payload, e só então chama o handler do evento. O uso, seguindo o README do pacote:

import { Webhooks } from '@abacatepay/supabase';

const { ok, handler, error } = Webhooks({
    secret: Deno.env.get('ABACATEPAY_WEBHOOK_SECRET'),
    onCheckoutCompleted(evento) {
        // checkout hospedado pago: libere o acesso do pedido
    },
    onTransparentCompleted(evento) {
        // Pix do QR Code no app pago: libere o acesso do pedido
    },
});

if (!ok) throw new Error(error);

export const POST = handler;

O handler recebe um Request e devolve um Response. Numa Edge Function do Supabase, que atende com Deno.serve, passe o mesmo handler: Deno.serve(handler).

Duas regras para não liberar errado:

O passo a passo da confirmação está em como confirmar automaticamente que um Pix foi pago.

Fale com o time sobre receber Pix no seu app.


Passo 4: teste sem dinheiro real (Modo Teste e CLI)

No Modo Teste os pagamentos são simulados e nada é cobrado; com a CLI, você paga o Pix de teste por um comando e recebe o webhook no localhost com a mesma assinatura da produção.

Com a CLI da AbacatePay (macOS, Linux e Windows), o ciclo fica assim:

abacatepay login
abacatepay listen --forward-to http://localhost:3000/webhooks/abacatepay
abacatepay payments simulate <id-da-cobranca>

O login abre o navegador para você aprovar o acesso, o listen traz os webhooks do Modo Teste para a URL local e o simulate paga o Pix de teste sem abrir o app do banco. Nos eventos de teste, o campo devMode vem true.

Na produção, troque a chave abc_dev_ pela abc_prod_. A URL da API continua a mesma, e os webhooks de produção são cadastrados de novo, com o Modo Teste desligado.


Erros comuns

Os três erros que mais quebram a cobrança são chave de API no front, preço vindo do navegador e liberar acesso duas vezes porque o webhook foi reenviado.


Quanto custa receber Pix no app

Na AbacatePay, cada Pix custa R$ 0,80, sem mensalidade; o cartão tem ativação sob consulta, com recebimento no prazo que você escolhe na dashboard (D+1, D+7, D+15 ou D+30) e as taxas publicadas na página de preços.

Os pagamentos do Modo Teste são simulados e não são cobrados.


Perguntas frequentes

O Lovable aceita Pix?

A doc dos pagamentos nativos do Lovable, que rodam na Stripe e na Paddle, não cita Pix. Para cobrar em Pix, você usa um conector brasileiro que a doc do Lovable lista (Mercado Pago ou Asaas) ou chama a API de um gateway, como a AbacatePay, numa função de backend.

Como integrar Pix no Lovable?

Cole o llms.txt da AbacatePay no chat e peça uma Edge Function que crie a cobrança e outra que receba o webhook. A chave fica nos secrets do backend, a cobrança volta como link ou QR Code, e o acesso só é liberado quando o webhook confirma o pagamento.

Onde guardar a chave de API no Lovable?

Nos secrets do backend (Lovable Cloud ou Supabase), lida pela Edge Function. Nunca no código do front, que qualquer pessoa consegue ler no navegador.

Como saber que o Pix foi pago?

Pelo webhook: transparent.completed (QR Code no app) ou checkout.completed (checkout hospedado). Antes de liberar, confira o secret e a assinatura HMAC; o pacote @abacatepay/supabase faz isso e entrega o evento já validado.

Dá para testar sem pagar de verdade?

Sim. No Modo Teste, com a chave abc_dev_, os pagamentos são simulados e nada é cobrado. Com a CLI, abacatepay payments simulate paga o Pix de teste e abacatepay listen entrega o webhook no localhost.

O QR Code do Checkout Transparente (brCode e brCodeBase64) deixa o cliente pagar sem sair do app. O checkout hospedado é mais rápido de montar, porque a página de pagamento é da AbacatePay. Nos dois casos, quem libera o acesso é o webhook.


Fale com o time sobre receber Pix no seu app.

Você pode se interessar por