Skip to main content
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:
ValorTipo
"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"
}