Notificaciones de pago de PayPal (webhooks)
Configuramos las notificaciones de pago de PayPal, los webhooks, para que tus pedidos se actualicen solos cuando PayPal confirma un pago, procesa un reembolso o registra una disputa. Verificamos la autenticidad de cada aviso con PayPal y resolvemos los pagos que quedan pendientes antes de completarse.
Te respondemos con una propuesta concreta. Sin compromiso.
Qué hacemos
Un webhook de PayPal es un mensaje que PayPal envía a una URL de tu servidor cuando ocurre un evento relacionado con tu cuenta: una captura completada, un reembolso, una disputa o un cambio en una suscripción. Los webhooks se configuran por aplicación en el panel de desarrolladores de PayPal, con una URL y una lista de eventos para sandbox y otra para producción.
En PayPal son especialmente importantes porque no todas las capturas se completan en el momento. Algunas quedan pendientes, por ejemplo mientras PayPal revisa la operación, y se resuelven más tarde. El webhook es lo que le avisa a tu sistema que ese pago finalmente se completó o se rechazó.
Eventos de PayPal que procesamos
| Evento | Qué hace tu sistema |
|---|---|
| PAYMENT.CAPTURE.COMPLETED | Marca el pedido como pagado |
| PAYMENT.CAPTURE.PENDING | Mantiene el pedido en espera y avisa al equipo |
| PAYMENT.CAPTURE.DENIED | Cancela el pedido y libera el stock |
| PAYMENT.CAPTURE.REFUNDED | Registra la devolución total o parcial |
| CUSTOMER.DISPUTE.CREATED | Genera una alerta para responder dentro del plazo |
| BILLING.SUBSCRIPTION.CANCELLED | Ajusta el acceso del cliente |
Innovación en emprendimientos
¿Lo pensamos para tu proyecto?
Señales de que necesitás webhooks de PayPal
- Pedidos que quedaron "en espera" y nadie sabe si PayPal terminó cobrando.
- Reembolsos hechos desde el panel de PayPal que no se reflejan en tu tienda.
- Disputas que descubrís cuando ya venció el plazo para responder.
- Una integración vieja que todavía depende de IPN, el sistema de notificaciones de las integraciones antiguas de PayPal.
Cómo configuramos los webhooks de PayPal
- Registro. Creamos el webhook en tu aplicación de PayPal con la URL de tu servidor y los eventos necesarios, por separado para sandbox y producción.
- Verificación. Validamos cada aviso con el servicio de verificación de firmas de PayPal, usando los encabezados de la transmisión y el identificador del webhook.
- Consulta del recurso. Ante eventos clave, consultamos la orden o la captura en la API de PayPal para confirmar el estado antes de actuar.
- Procesamiento seguro. Respondemos enseguida, procesamos en segundo plano y descartamos eventos repetidos por su identificador.
- Pruebas. Usamos el simulador de webhooks de PayPal y pagos de sandbox para recorrer cada evento.
Qué recibís
- Webhooks de PayPal registrados y verificados.
- Pedidos, reembolsos y disputas sincronizados con tu sistema.
- Alertas para tu equipo ante pagos pendientes y disputas.
- Un registro de cada notificación recibida.
Este servicio es parte de nuestra integración de PayPal. Si también cobrás en Argentina, hacemos el mismo trabajo con las notificaciones de pago de Mercado Pago, con sus propios eventos y su propio método de validación. Para planes recurrentes, se complementa con las suscripciones con PayPal.
Preguntas frecuentes
¿Tenés otra duda? Escribinos por WhatsApp.
¿Qué diferencia hay entre los webhooks y las notificaciones IPN de PayPal?
IPN es el sistema de notificaciones que usaban las integraciones antiguas de PayPal, como PayPal Standard. Los webhooks son el mecanismo de las integraciones actuales con la API REST: permiten elegir eventos por tipo y verificar cada aviso con PayPal. En proyectos nuevos usamos webhooks, y en integraciones viejas evaluamos la migración junto con la actualización del checkout.
¿Por qué un pago de PayPal puede quedar pendiente?
Una captura puede quedar pendiente por distintos motivos: PayPal revisa la operación, la cuenta del vendedor tiene que aceptar un pago en una moneda que no tiene habilitada o hay una verificación en curso. En esos casos el pedido no debe despacharse. El webhook avisa cuando la captura se completa o se rechaza, y tu sistema actúa en consecuencia.
¿Cómo se verifica que una notificación viene de PayPal?
Cada aviso trae encabezados con la firma de la transmisión y el certificado usado. Tu servidor envía esos datos, junto con el identificador del webhook, al servicio de verificación de PayPal, que confirma si el mensaje es auténtico. Solo después de esa confirmación procesamos el evento y actualizamos el pedido.
¿Mi sistema se entera cuando un cliente abre una disputa?
Sí, si se escucha el evento de disputa creada. Configuramos ese aviso para que tu equipo reciba una alerta con los datos del pedido y pueda responder en el Centro de resoluciones de PayPal dentro del plazo. Responder a tiempo y con la documentación de la venta es clave para no perder el caso.
¿Se pueden probar los webhooks de PayPal sin pagos reales?
Sí. El panel de desarrolladores de PayPal incluye un simulador que envía eventos de ejemplo a tu URL, y el entorno sandbox genera eventos reales a partir de pagos de prueba. Usamos las dos herramientas para verificar que cada tipo de evento produzca la acción correcta en tu sistema antes de pasar a producción.
Pedí tu presupuesto
Notificaciones de pago de PayPal (webhooks), pensado para tu emprendimiento. Contanos qué necesitás y te respondemos con una propuesta.
- Tres pasos, menos de dos minutos.
- Propuesta concreta, sin compromiso.
- Si preferís, lo hablamos por WhatsApp.
- Qué necesitás
- Tu proyecto
- Tus datos
También te puede servir
- Notificaciones de pago de Mercado Pago (webhooks) Mercado Pago
- Webhooks de Stripe para sincronizar pagos y suscripciones Stripe
- Integración entre aplicaciones con n8n Flujos de automatización
- Botones de pago de PayPal en tu sitio web PayPal
- PayPal en WooCommerce con el plugin PayPal Payments PayPal
- Integración de PayPal en Next.js y Laravel PayPal