InformacionPago

Objeto que se envía en el cuerpo de /InicioPago con los datos del pago a procesar.

Campos

flt_total_con_iva

number

required

Total a pagar con IVA incluido. Máximo 2 decimales.Ejemplos: 50000, 83000.50, 125000

flt_valor_iva

number

Total del IVA (incluido en flt_total_con_iva). Máximo 2 decimales. Si no hay IVA, envía 0.Obligatorio para certificación PSE. Opcional en otros casos.

str_id_pago

string

required

Identificador único del pago que tú defines. Puede ser número de factura, UUID, etc.

Máximo 30 caracteres.
No puede tener ceros a la izquierda.
Debe ser único por comercio (no reutilizar).

Ejemplos válidos: "ORDEN-001", "FAC-2026-04-21-8912", "180924" Ejemplos inválidos: "0009" (ceros a la izquierda), "ORDEN-0001-con-mas-de-treinta-caracteres" (demasiado largo)

str_descripcion_pago

string

required

Concepto o descripción del pago. Máximo 70 caracteres. El usuario lo verá en el formulario.Ejemplo: "Compra de camisa talla M"

str_email

string

Correo del cliente. Máximo 70 caracteres.

Aunque es opcional, envíalo siempre. Zonapagos envía al cliente un correo con el comprobante del pago si este campo está presente.

str_id_cliente

string

Documento de identificación del cliente (número de cédula, NIT, etc.). Máximo 30 caracteres.Obligatorio para certificación PSE.

str_tipo_id

string

Tipo de documento. Se envía el código numérico como string:

Valor	Tipo
`"0"`	No Identificado
`"1"`	Cédula de Ciudadanía (CC)
`"2"`	Cédula de Extranjería (CE)
`"3"`	NIT
`"4"`	NUIP
`"5"`	Tarjeta de Identidad (TI)
`"6"`	Pasaporte (PP)
`"7"`	Identificador Único del Cliente (IDC)
`"8"`	Celular (CEL)
`"9"`	Registro Civil (RC)
`"10"`	Documento de Identificación Extranjero (DE)
`"11"`	Otro no tipificado

Obligatorio para certificación PSE.Ver Tipos de identificación para más detalle.

str_nombre_cliente

string

Nombre del cliente. Máximo 50 caracteres.

str_apellido_cliente

string

Apellido del cliente. Máximo 50 caracteres.

str_telefono_cliente

string

Teléfono del cliente. Máximo 50 caracteres.

str_opcional1

string

Campo opcional libre. Máximo 70 caracteres. Se devuelve en VerificacionPago.

str_opcional2

string

Campo opcional libre. Máximo 70 caracteres.

str_opcional3

string

Campo opcional libre. Máximo 70 caracteres.

str_opcional4

string

Campo opcional libre. Máximo 70 caracteres.

str_opcional5

string

Campo opcional libre. Máximo 70 caracteres.

Ejemplo completo

{
  "flt_total_con_iva": 83000,
  "flt_valor_iva": 13250,
  "str_id_pago": "ORDEN-2026-04-21-8912",
  "str_descripcion_pago": "Suscripción mensual Plan Pro",
  "str_email": "cliente@ejemplo.com",
  "str_id_cliente": "1020304050",
  "str_tipo_id": "1",
  "str_nombre_cliente": "Juan",
  "str_apellido_cliente": "Perez",
  "str_telefono_cliente": "3001234567",
  "str_opcional1": "canal-web",
  "str_opcional2": "campaña-abril-2026",
  "str_opcional3": "plan-pro-mensual"
}

Ejemplo mínimo

Solo los obligatorios (fuera de PSE):

{
  "flt_total_con_iva": 50000,
  "str_id_pago": "ORDEN-001",
  "str_descripcion_pago": "Compra test"
}

Ejemplo mínimo para certificación PSE

{
  "flt_total_con_iva": 50000,
  "flt_valor_iva": 7983,
  "str_id_pago": "ORDEN-001",
  "str_descripcion_pago": "Compra test",
  "str_id_cliente": "1020304050",
  "str_tipo_id": "1"
}

Empieza ahora

Zonapay - Pasarelas de pagos

Zonarecaudo

Zonaexpress - Formulario de pago

Tokenización

Link de cobro

Campos

Ejemplo completo

Ejemplo mínimo

Ejemplo mínimo para certificación PSE

​Campos

​Ejemplo completo

​Ejemplo mínimo

​Ejemplo mínimo para certificación PSE

Campos

Ejemplo completo

Ejemplo mínimo

Ejemplo mínimo para certificación PSE