PayPal IPN: investigar el error «handshake invalid»

Al integrar PayPal IPN encontré el error «handshake invalid». La codificación del mensaje puede ser una causa, pero no es la única. Cambiar el juego de caracteres de la cuenta no debe ser la respuesta automática a cualquier validación fallida.

Qué está verificando IPN

El receptor recibe una notificación y la valida con PayPal siguiendo su protocolo. La petición de verificación debe conservar correctamente los datos recibidos y añadir el comando previsto para esa comprobación. Reconstruir campos alterando codificación, orden o valores puede introducir errores.

Comprueba que utilizas el endpoint HTTPS del entorno correcto: producción y sandbox no son intercambiables.

Validar no basta para marcar un pago

Una respuesta VERIFIED confirma la validación del mensaje, pero la aplicación todavía debe comprobar el destinatario, el estado del pago, el importe, la moneda y su relación con el pedido. También debe evitar procesar dos veces el mismo identificador de transacción.

IPN puede reenviar notificaciones. Una integración robusta debe ser idempotente: repetir el mensaje no debería duplicar una entrega ni un abono.

Investigar sin perder el mensaje original

Registra el resultado de la validación y los datos estrictamente necesarios para diagnosticarlo. Compara el cuerpo recibido con lo enviado a verificar y revisa la codificación configurada. No publiques registros que contengan datos personales o credenciales.

Referencia: implementación de IPN, PayPal.