Integrar pagos en línea: qué revisar antes de salir

Respuesta corta: Una integración de pagos se rompe en los bordes, no en el camino feliz. Antes de salir a producción revisa cinco conductas: qué pasa si el cliente cierra el navegador después de pagar, si un doble clic puede generar dos cobros, cómo se concilia lo que dice tu sistema contra lo que dice el medio de pago, cómo se procesa una reversa o anulación, y qué ve el cliente cuando el resultado queda en duda. Ninguna requiere acceso a credenciales para conversarse. La prueba más útil no es una compra exitosa: es interrumpir una compra a medio camino y revisar en qué estado quedaron el pedido y el cobro.

El caso que rompe integraciones: el cliente cierra el navegador

El cliente paga y cierra la pestaña antes de volver a tu sitio. El medio de pago registró la transacción; tu sistema quizá no. Si la confirmación depende únicamente de que el navegador regrese, acabas de perder la trazabilidad de un cobro real.

Pregunta cómo se entera tu sistema del resultado cuando el usuario no vuelve. Debe existir un camino que no dependa del navegador: una confirmación servidor a servidor o una consulta posterior del estado. Si no existe, la operación va a descuadrar y alguien lo va a resolver a mano.

Cinco conductas que conviene ver demostradas

Estas cinco se prueban en el ambiente de integración del medio de pago, sin dinero real. Pedir verlas no es desconfianza: es la forma de saber si el diseño contempló los bordes.

La conciliación no es opcional

Tu sistema tiene una versión de la verdad y el medio de pago tiene otra. La pregunta útil es quién compara ambas y con qué frecuencia. Si la respuesta es «nadie, salvo que un cliente reclame», el descuadre existe igual: solo que aún no lo has visto.

Acuerda desde el inicio con qué dato se cruzan los registros, con qué periodicidad y quién revisa las diferencias. Un identificador propio en cada intento de pago hace toda la diferencia cuando hay que reconstruir un caso meses después.

Qué no debe verse nunca en tus registros

Los datos de la tarjeta no deben quedar en los logs de tu aplicación, ni completos ni parciales más allá de lo que el medio de pago permita. Revisa qué se está registrando hoy, no qué se pretendía registrar. Es una de las diferencias más frecuentes entre lo documentado y lo implementado.

Prepara la conversación

Ordena los antecedentes con nuestro checklist de integración de sistemas. Si necesitas una revisión antes de habilitar pagos, mira el alcance de la evaluación de integraciones y APIs y cuéntanos qué medio de pago usas y en qué fecha quieres salir.

Preguntas frecuentes

¿Por qué aparecen cobros duplicados si el sistema funciona?

Habitualmente porque la operación no es idempotente: dos envíos del mismo formulario producen dos intentos distintos. Se previene identificando el intento de pago con una clave estable y rechazando el repetido, no confiando en que el usuario no haga doble clic.

¿Necesito entregar credenciales para que revisen la integración?

No para una revisión de diseño y conducta. Se puede trabajar con la documentación, el código y un ambiente de pruebas del medio de pago. Cualquier acceso mayor se acuerda por escrito y con alcance definido.

Fuentes oficiales