Cobre por Pix dentro da conversa: o fluxo gera o código, confirma o pagamento e libera a entrega.
2026-09-08
Com o app AbacatePay você cobra dentro da conversa: o fluxo gera o Pix, envia o copia e cola e o QR Code, confirma o pagamento e libera a entrega — tudo sem tirar o contato do WhatsApp.
Integração em beta
Esta integração ainda está em testes e pode apresentar falhas. Se algo não funcionar como descrito aqui, avise o suporte do NicoChat: estamos acompanhando esta integração de perto justamente para corrigir rápido e atender você melhor.
Antes de abrir o editor
Tempo de configuração: ~10 minutos. Você vai precisar de uma conta na AbacatePay e de uma chave de API.
Antes de começar
A AbacatePay trabalha com dois tipos de chave, e é a chave que define o ambiente:
Chave
O que acontece
dev_...
Modo de teste. As cobranças são simuladas, nada é debitado. Use para montar o fluxo.
prod_...
Modo real. Cobra de verdade e exige a conta aprovada no KYC.
Não existe chave de “teste em produção”: para virar a chave, basta reinstalar o app com a outra chave ou editar a credencial.
Guarde a chave em local seguro. Quem tem a chave pode criar cobranças na sua conta.
Passo 2 — Instalar o app no canal
1
Abra Configurações → Apps
No NicoChat. Em alguns planos o menu aparece como Mini Apps.
2
Procure por AbacatePay e clique em Instalar
3
Cole a chave de API no campo solicitado e salve
4
Escolha o canal onde o app ficará disponível
Pronto: as ações da AbacatePay já aparecem no editor de fluxo, no bloco Ação → Apps.
Passo 3 — Montar o fluxo de cobrança Pix
Um fluxo mínimo de venda tem cinco blocos:
text
[Pergunta: qual produto?]
|
v
[Acao: 01 Criar Cobranca Pix]
|
v
[Mensagem: envia o copia e cola + QR Code]
|
v
[Espera: 2 minutos]
|
v
[Acao: 02 Consultar Cobranca] -> status = PAID ? -> [Entrega]
| nao
v
[Volta para a espera]
3.1 Criar a cobrança
Adicione o bloco de ação 01 Criar Cobrança Pix e preencha:
Campo
O que colocar
Valor (R$)
O valor em reais: 99,90. O app converte para centavos sozinho.
Descrição
O que o cliente vai ver: “Plano Mensal – Academia X”.
Expira em (minutos)
30 costuma ser um bom número para venda no WhatsApp.
Nome / E-mail / CPF-CNPJ / Celular
Use as variáveis do contato. CPF e celular só com números.
ID Externo
Sua referência interna (nº do pedido, ID do contato). Opcional, mas recomendado.
Nas saídas, salve em campos do contato:
ID da Cobrança — obrigatório, é o que permite consultar e estornar depois.
Copia e Cola — o código Pix que você vai enviar.
QR Code Base64 — a imagem do QR Code.
Status e Expira em — úteis para a mensagem.
3.2 Enviar o Pix para o contato
Use um bloco de mensagem com o texto e deixe o código em uma mensagem separada, para o cliente conseguir copiar com um toque:
text
Prontinho! E so pagar o Pix abaixo
(o codigo expira em 30 minutos)
E logo abaixo, outra mensagem só com {{Copia e Cola}}.
3.3 Confirmar o pagamento
A AbacatePay não avisa o NicoChat sozinha — o fluxo é quem pergunta. Depois de um bloco de espera, chame 02 Consultar Cobrança passando o ID da Cobrança e verifique o Status com uma condição. Se ainda não estiver pago, volte para a espera. Faça isso de 3 a 5 vezes e, se não pagar, encerre com uma mensagem de carrinho abandonado.
Passo 4 — Testar
1
Instale o app com uma chave dev_
2
Rode o fluxo com um valor baixo
R$ 1,00 já basta para ver o caminho inteiro.
3
Confira o resultado
Se o copia e cola chegou e se a consulta devolve o status.
4
Troque para a chave prod_
Quando estiver satisfeito com o fluxo.
Outras ações disponíveis
Ação
Para quê
03 Estornar Cobrança
Devolve o valor de uma cobrança paga (sempre o valor total).
04 Criar Link de Pagamento
Gera um link com Pix e cartão, com produtos e URL de retorno.
05 Criar Cliente
Cadastra o contato na AbacatePay para reaproveitar em cobranças futuras.
06 Criar Produto
Cria o produto — necessário antes de criar assinatura.
07 Criar Assinatura
Cobrança recorrente: semanal, mensal, trimestral, semestral ou anual.
08 Cancelar Assinatura
Encerra a recorrência.
Assinatura tem ordem
Criar Produto (com o ciclo) → guardar o ID do produto → Criar Assinatura.
Problemas comuns
O campo Valor é em reais. Se você digitou 9990 esperando R$ 99,90, o app entendeu R$ 9.990,00. Escreva 99,90.
O app mostra a resposta crua da AbacatePay logo abaixo. A mensagem dela costuma nomear o campo que faltou — normalmente CPF/CNPJ ou e-mail inválido.
Com chave dev_ o pagamento é simulado: você precisa marcar a cobrança como paga no painel de desenvolvimento da AbacatePay para o status mudar.
O webhook da AbacatePay é configurado no painel deles e aponta para uma URL fixa — não dá para definir por cobrança. Por isso este app confirma pagamento por consulta, e não por gatilho.
