InformacionPago

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

Campos

number

required

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

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.

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)

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"

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.

string

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

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.

string

Nombre del cliente. Máximo 50 caracteres.

string

Apellido del cliente. Máximo 50 caracteres.

string

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

string

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

string

Campo opcional libre. Máximo 70 caracteres.

string

Campo opcional libre. Máximo 70 caracteres.

string

Campo opcional libre. Máximo 70 caracteres.

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

Plugins

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