Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.equipozonapagos.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Endpoint sugerido

POST /ApiPagosN3/api/NotificarPagos Método de la mensajería: POST Formato de la mensajería: JSON

​
Ejemplo de notificación

{
  "IdComercio": 2652,
  "Password": "PagosN3",
  "IdCliente": "123456789",
  "IdFactura": "FAC001",
  "EstadoPago": 1,
  "FormaPago": 29,
  "ValorTotalPagado": 150000,
  "FechaPago": "13/10/2025 08:48:17",
  "IdPago": 2653,
  "TicketID": 20100180,
  "NombreBanco": "Bancolombia"
}

​
Respuesta esperada del comercio

{
  "CodEstado": 0,
  "DescripcionEstado": "Se realizó exitosamente la actualización del pago."
}

​
Parametros

PARÁMETROTIPODESCRIPCIÓN
IdComercioIntegerIdentificación del comercio
PasswordStringContraseña compartida
IdClienteStringIdentificación cliente
IdFacturaStringNúmero de factura
EstadoPagoInteger1 = OK, 0 = error
El comercio debe controlar el doble asentamiento usando el IdPago.
Esto garantiza idempotencia en el procesamiento del webhook.
Si se reciben múltiples notificaciones con el mismo IdPago, se debe procesar solo una.

​
Seguridad

​
Recomendaciones

  • Nunca exponer str_clave
  • Validar IPs autorizadas.
  • Implementar HTTPS obligatorio.
  • Registrar logs de auditoría.
  • Validar firmas o tokens si son configurados.
  • Implementar control de reintentos.