URL base
Endpoints
| Método | Ruta | Propósito |
|---|---|---|
| POST | /InicioPago | Crear una transacción y obtener la URL del ciclo de pago. |
| POST | /VerificacionPago | Consultar el estado de una o más transacciones. |
| GET | callback del comercio | ZonaPagos redirige al usuario a tu URL de retorno con id_comercio e id_pago. |
Resumen de diseño
- REST sobre HTTPS. Nunca llames por HTTP plano.
- Formato:
application/jsontanto en request como en response. - Siempre HTTP 200. Los errores de negocio se señalan vía
int_codigo: 2dentro del cuerpo JSON. Códigos HTTP distintos a 200 indican error de infraestructura (URL mal escrita, content-type faltante, caída de red, etc.). - Autenticación por credenciales en el body (no hay headers de Authorization). Ver Autenticación.
- Endpoints sin paginación ni límites de rate publicados. Si necesitas hacer consultas masivas, coordina con soporte.
Modelo de objetos
InformacionPago
Datos del pago y del cliente.
InformacionSeguridad
Credenciales del comercio.
AdicionalPago
Array de información adicional del pago.
AdicionalConfiguracion
Array de configuración del comportamiento del ciclo de pago.
RespuestaInicioPago
Estructura del response de
InicioPago.RespuestaVerificacion
Estructura del response de
VerificacionPago.Tablas de referencia
Estados de pago
Todos los valores de
int_estado_pago con su acción recomendada.Medios de pago
Códigos
int_id_forma_pago y campos adicionales por medio.Tipos de identificación
Valores válidos para
str_tipo_id.Configuraciones adicionales
Todos los códigos de
AdicionalesConfiguracion.Formatos especiales
El API usa dos formatos que merecen atención especial:Parsear str_res_pago
El campo viene como texto plano con separadores
| y |;|. Tenemos parser en JS, Python y C#.Campos por medio de pago
Cada medio de pago añade campos extra al final de
str_res_pago.Próximo paso
Ir a /InicioPago →
El endpoint donde empieza todo.