Planifica, prueba y monitoriza webhooks
Los webhooks notifican a un sistema externo cuando ocurren eventos importantes de AtomicPay. Úsalos para automatizaciones, actualizaciones CRM, aprovisionamiento de acceso, flujos de soporte o informes internos.
Áreas del flujo de webhooks
| Área | Propósito |
|---|---|
| Eventos | Define qué acciones de AtomicPay deben disparar un webhook. |
| URL del endpoint | La URL externa que recibe solicitudes de webhook. |
| Simulador | Envía eventos de prueba antes del tráfico de producción. |
| Logs | Muestra intentos de entrega y fallos. |
| Seguridad | Protege tu endpoint de solicitudes no deseadas o no confiables. |
Eventos comunes
| Tipo de evento | Úsalo para |
|---|---|
| Compra aprobada o completada | Crear acceso, actualizar CRM o notificar fulfillment. |
| Compra rechazada | Disparar recuperación o seguimiento de soporte. |
| PIX generado | Rastrear flujos de pago PIX pendientes. |
| Carrito abandonado | Disparar automatización de recordatorio cuando esté soportado. |
| Trial iniciado | Iniciar onboarding para usuarios en trial. |
| Suscripción cancelada o renovada | Actualizar acceso y sistemas de ciclo de vida. |
| Reembolso o chargeback | Actualizar flujos de finanzas, acceso o riesgo. |
Crea y prueba un webhook
- Decide qué sistema externo debe recibir eventos.
[Captura: Diagrama de flujo — objetivo CRM, acceso o notificación identificado.]
- Elige los eventos necesarios para el flujo.
[Captura: Lista de verificación de eventos — compra aprobada, suscripción, reembolso, etc. seleccionados.]
- Crea el endpoint en tu sistema externo.
[Captura: URL del endpoint externo — ruta del servidor o catch URL lista.]
- Añade la URL del webhook en AtomicPay.
[Captura: Página de Webhooks — crear webhook con URL del endpoint.]
- Guarda el webhook.
[Captura: Webhook guardado — estado activo con eventos seleccionados.]
- Usa el simulador para enviar eventos de prueba.
[Captura: Simulador de webhook — evento de prueba enviado con éxito.]
- Revisa logs para estado, intentos y comportamiento de respuesta.
[Captura: Logs de webhook — estado de entrega y códigos de respuesta visibles.]
- Corrige entregas fallidas antes de depender de la automatización.
[Captura: Entrega fallida corregida — reintento exitoso en logs.]
Buenas prácticas
- Empieza solo con los eventos que tu sistema necesita.
- Haz tu endpoint idempotente para que eventos repetidos no dupliquen trabajo.
- Registra eventos recibidos en tu lado.
- Diseña manejo de reintentos y fallos antes del lanzamiento.
- Mantén detalles de payload y autenticación en el flujo de documentación API.
FAQ
¿Dónde están documentados los detalles del payload de webhook?
Usa AtomicPay API Docs para referencia de endpoint, autenticación y payload. Este centro de ayuda se centra en el flujo del vendedor.
¿Qué debo hacer si un webhook no se dispara?
Revisa los eventos seleccionados, contexto de producto o negocio, URL del endpoint, estado del webhook, resultado del simulador, logs y si el evento de venta o suscripción que lo dispara realmente ocurrió.
¿Puedo conectar webhooks a Zapier o Make?
Sí, cuando esas herramientas proporcionan una URL de webhook. Prueba el evento y confirma que la automatización maneja reintentos o fallos con seguridad.