Skip to main content
Consultar el estado con /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

Observa que los campos tienen nombres diferentes a los de /InicioPago:
  • str_usuariostr_usr_comercio
  • str_clavestr_pwd_Comercio (con C mayúscula)
Con 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.