Cobra por Pix dentro de la conversación: el flujo genera el código, confirma el pago y libera la entrega.
2026-09-08
Con la app de AbacatePay cobras dentro de la conversación: el flujo genera el Pix, envía el código de copiar y pegar y el Código QR, confirma el pago y libera la entrega, todo sin sacar al contacto de WhatsApp.
Integración en beta
Esta integración todavía está en pruebas y puede presentar fallas. Si algo no funciona como se describe aquí, avisa al soporte de NicoChat: estamos siguiendo esta integración de cerca justamente para corregir rápido y atenderte mejor.
Antes de abrir el editor
Tiempo de configuración: ~10 minutos. Vas a necesitar una cuenta en AbacatePay y una clave de API.
Antes de empezar
AbacatePay trabaja con dos tipos de clave, y es la clave la que define el entorno:
Clave
Qué pasa
dev_...
Modo de prueba. Los cobros son simulados, no se debita nada. Úsala para armar el flujo.
prod_...
Modo real. Cobra de verdad y exige la cuenta aprobada en el KYC.
No existe una clave de “prueba en producción”: para cambiar la clave, basta con reinstalar la app con la otra clave o editar la credencial.
Es donde están las credenciales de los dos entornos.
4
Copia la clave
Empieza con dev_ o prod_.
La clave es tu cuenta
Guarda la clave en un lugar seguro. Quien tenga la clave puede crear cobros en tu cuenta.
Paso 2 — Instalar la app en el canal
1
Abre Configuración → Apps
En NicoChat. En algunos planes el menú aparece como Mini Apps.
2
Busca AbacatePay y haz clic en Instalar
3
Pega la clave de API en el campo solicitado y guarda
4
Elige el canal donde la app estará disponible
Listo: las acciones de AbacatePay ya aparecen en el editor de flujo, en el bloque Acción → Apps.
Paso 3 — Armar el flujo de cobro Pix
Un flujo mínimo de venta tiene cinco bloques:
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 Crear el cobro
Agrega el bloque de acción 01 Criar Cobrança Pix y completa:
Campo
Qué poner
Valor (R$)
El valor en reales: 99,90. La app lo convierte a centavos por su cuenta.
Descripción
Lo que el cliente va a ver: “Plan Mensual – Gimnasio X”.
Expira en (minutos)
30 suele ser un buen número para vender por WhatsApp.
Nombre / E-mail / CPF-CNPJ / Celular
Usa las variables del contacto. El CPF y el celular solo con números.
ID Externo
Tu referencia interna (n.º de pedido, ID del contacto). Opcional, pero recomendado.
En las salidas, guarda en campos del contacto:
ID del Cobro: obligatorio, es lo que permite consultar y reembolsar después.
Copiar y Pegar: el código Pix que vas a enviar.
QR Code Base64: la imagen del Código QR.
Status y Expira en: útiles para el mensaje.
3.2 Enviar el Pix al contacto
Usa un bloque de mensaje con el texto y deja el código en un mensaje aparte, para que el cliente pueda copiarlo con un toque:
text
Prontinho! E so pagar o Pix abaixo
(o codigo expira em 30 minutos)
Y justo debajo, otro mensaje solo con {{Copia e Cola}}.
3.3 Confirmar el pago
AbacatePay no avisa a NicoChat por su cuenta: es el flujo el que pregunta. Después de un bloque de espera, llama a 02 Consultar Cobrança pasando el ID del Cobro y verifica el Status con una condición. Si todavía no está pagado, vuelve a la espera. Haz esto de 3 a 5 veces y, si no paga, cierra con un mensaje de carrito abandonado.
Paso 4 — Probar
1
Instala la app con una clave dev_
2
Ejecuta el flujo con un valor bajo
R$ 1,00 ya alcanza para ver todo el recorrido.
3
Revisa el resultado
Si el código de copiar y pegar llegó y si la consulta devuelve el estado.
4
Cambia a la clave prod_
Cuando estés conforme con el flujo.
Otras acciones disponibles
Acción
Para qué
03 Estornar Cobrança
Devuelve el valor de un cobro pagado (siempre el valor total).
04 Criar Link de Pagamento
Genera un enlace con Pix y tarjeta, con productos y URL de retorno.
05 Criar Cliente
Registra al contacto en AbacatePay para reutilizarlo en cobros futuros.
06 Criar Produto
Crea el producto: es necesario antes de crear una suscripción.
07 Criar Assinatura
Cobro recurrente: semanal, mensual, trimestral, semestral o anual.
08 Cancelar Assinatura
Finaliza la recurrencia.
La suscripción tiene un orden
Crear Producto (con el ciclo) → guardar el ID del producto → Crear Suscripción.
Problemas comunes
El campo Valor es en reales. Si escribiste 9990 esperando R$ 99,90, la app entendió R$ 9.990,00. Escribe 99,90.
La app muestra la respuesta cruda de AbacatePay justo debajo. Su mensaje suele nombrar el campo que faltó: normalmente CPF/CNPJ o e-mail inválido.
Con la clave dev_ el pago es simulado: necesitas marcar el cobro como pagado en el panel de desarrollo de AbacatePay para que el estado cambie.
El webhook de AbacatePay se configura en el panel de ellos y apunta a una URL fija: no se puede definir por cobro. Por eso esta app confirma el pago por consulta y no por disparador.
