Skip to main content
v6.1 — Abril 2026
Documentación Mintlify (esta publicación)

Cambios en la documentación

  • Nueva estructura de navegación en Mintlify con tabs separadas: Empezar, Guías, API Reference, Recetas, Soporte.
  • Glosario de siglas agregado al inicio del documento.
  • Guía rápida de 10 minutos con código en cURL, Node.js, Python.
  • Diagramas de secuencia con Mermaid para el flujo completo y la sonda.
  • Parser de referencia completo para str_res_pago en JavaScript, Python y C#.
  • FAQ con los 15 errores más comunes al integrar.
  • Tabla consolidada de todos los estados de int_estado_pago con acciones recomendadas.
  • Endpoints separados para InicioPago y VerificacionPago con ejemplos en Postman embebidos.

Hallazgos pendientes de validación con TI

  • Valor correcto de int_modalidad (doc oficial tiene contradicción: texto dice -1, ejemplo JSON usa 1).
  • Disponibilidad de un endpoint REST sandbox público.
  • Normalización de mensajes de error (actualmente se expone "Object reference not set…" crudo).
  • Documentación del algoritmo de hash del token rut en la URL del ciclo de pago.
v6.0 — Junio 2025
Versión del instructivo oficial I-TI-008
  • Se modificaron los parámetros de retorno de InicioPago (sección 7.1.2).
  • Se consolidaron ejemplos de integración en C#.
v5.0 — Mayo 2025
  • Se eliminaron los estados obsoletos 777, 1003 y 1004.
v4.0 — Agosto 2024
  • Se modificaron los parámetros de retorno (sección 7.1.2).
v3.0 — Marzo 2024
Nuevos medios de pago
  • Se agregan los códigos int_id_forma_pago:
    • 47 Sistecrédito
    • 48 Bancolombia
    • 51 Codensa
    • 77 Mefía
  • Se eliminan los códigos 42 (Gana) y 45 (Tarjeta Tuya).
  • Nueva información específica para los medios de pago 47, 48 y 51.
v2.9 — Octubre 2021
  • Corrección de párrafo duplicado en la sección de sonda.
v2.8 — Septiembre 2021
  • Se agrega el estado 1003 en int_estado_pago (posteriormente obsoletado en v5.0).
v2.6 — Octubre 2020
  • Modificación del tipo y tamaño de int_cod_aprobacion para el medio de pago 32 (TC).
v2.5 — Septiembre 2020
  • Nota aclaratoria sobre int_cod_aprobacion para TC.
v2.4 — Marzo 2020
Obligatoriedad de campos
  • Se actualiza la obligatoriedad de los siguientes parámetros:
    • flt_valor_iva
    • str_id_cliente
    • str_tipo_id
    • int_modalidad
    • int_no_pago
  • Modificación del diagrama general y del diagrama de funcionamiento de la sonda.
v2.3 — Junio 2019
Reorganización
  • Se agrega el estado 1002 a int_estado_pago.
  • Se corrige el tamaño de str_id_pago y la descripción de los campos opcionales.
  • Nota aclaratoria en id_pago: no puede tener ceros a la izquierda.
v2.2 — Mayo 2019
Cobro en dólares y cobro por transacción
  • Nuevos códigos de AdicionalesConfiguracion:
    • 116: habilita cobro en dólares para TC.
    • 117: moneda de conversión (CO/US).
  • Se agregan parámetros para cobro por transacción en PSE y TC: 500, 50001-50008, 501, 50101-50108.
v2.0 — Marzo 2019
  • Se agrega int_ped_numero en los parámetros de salida.
  • Se corrigen las variables int_cantidad_pago → int_cantidad_pagos y str_re_pago → str_res_pago.
v1.0 — Septiembre 2018
Versión inicial
  • Publicación inicial del instructivo para el nuevo core transaccional.

Suscríbete a actualizaciones

Para recibir notificaciones de cambios en el API, escríbenos a soporte@zonapagos.com con el asunto [SUSCRIPCIÓN CHANGELOG] indicando tu int_id_comercio y el correo técnico de contacto.