/VerificacionPago es el único mecanismo autoritativo para saber qué pasó con un pago.
¿Cuándo consultar?
1
Al recibir el callback del usuario
Inmediatamente. Única fuente de verdad antes de entregar producto.
2
Desde la sonda cada 10-15 min (obligatorio PSE)
Para pagos en estado
999, 4001, etc.3
Bajo demanda desde un panel admin
Tu equipo de soporte puede consultar un pago específico para reconciliar con el cliente.
Request
int_no_pago: -1 obtienes todos los intentos asociados al str_id_pago. Si un pago fue mixto tendrás varios intentos.
Response
Código de verificación
Actuar según la respuesta
Aprobado (1)
Pendiente (888, 999, 4001)
Rechazado (1000, 1001, 4000, 4003)
Pagos mixtos (varios intentos)
Cuando el usuario paga con pagos mixtos,int_cantidad_pagos > 1 y cada elemento de intentos es un pago parcial.
Buenas prácticas
Timeout razonable (15s). Un VerificacionPago que tarda 30s bloquea tu callback.
Log completo del response (oculta la clave del request). Útil para auditoría PSE.
Nunca confíes solo en el callback — siempre verifica.
Persiste el CUS (
str_codigo_transaccion) para reclamos ante el banco.Maneja
int_cantidad_pagos: 0 — puede significar que el usuario no inició el pago (el request a InicioPago fue exitoso pero el usuario nunca abrió la URL).Próximo paso
Implementar sonda →
Job programado para pagos que quedaron pendientes.