Skip to main content
Array de objetos enviado en /InicioPago que configura cómo se comporta el ciclo de pago. Cada elemento tiene la forma: 
{ "int_codigo": 50, "str_valor": "2701" }

​
Objeto base

​
int_codigo
integer
required
Código de la configuración. Ver tabla abajo.
​
str_valor
string
required
Valor de la configuración. El formato depende del código.

​
Catálogo de códigos

​
Configuración general

CódigoObligatorioValorDescripción
50Si hay PSEString numéricoCódigo de servicio PSE. ZonaPagos lo asigna a tu comercio.
100Opcional"1" o "2"Permite dividir pago en varios medios. 1 = sí, 2 = no. Default: 0 (no dividir).
101Opcional"1" o "0"Permite dividir en varias TC. Aplica solo si 100: "1".
102Opcional"1" o "0"Permite dividir en varios PSE. Aplica solo si 100: "1".
103Opcional"1" o "0"Desactivar PSE. 1 = desactivar.
104OpcionalURL completaURL de retorno del cliente. Sobrescribe la config estática del comercio.
105OpcionalEnteroValor mínimo por fracción (si hay división).
106OpcionalEnteroNúmero máximo de fracciones.
107Opcional"1" o "0"Desactivar TC. 1 = desactivar.
108Opcional"1" o "0"Activa por defecto el checkbox de términos y condiciones.
109Opcional"1" o "0"Habilita pagos mixtos.
110Opcional"1" o "0"Pago total del saldo si se hace por PSE.
111Opcional"1" o "0"Oculta campo “nombre en tarjeta” al pagar con TC.
112OpcionalEnteroValor mixto a pagar por defecto (monto de la primera fracción).
113Opcional"1" o "0"Habilita pagos recurrentes.
114OpcionalEntero (meses)Plazo total de la recurrencia.
115OpcionalEntero (meses)Frecuencia del cobro recurrente.
116Opcional"1" o "0"Habilita cobro en dólares para TC.
117Opcional"CO" o "US"Moneda: CO = pesos, US = dólares.
Inconsistencia en el código 100: la documentación oficial indica valores 1 o 2, pero también menciona que “si no se envía se toma 0”. El comportamiento con 0 no está documentado. Recomendación: si no quieres dividir pago, omite el código; si quieres dividirlo, envía "1".

​
Cobro por transacción — PSE

CódigoValorDescripción
500"1" o "0"Habilita cobro por transacción PSE.
50001"1" o "0"Tipo de cobro: 1 = porcentaje, 0 = valor fijo.
50002String 4 dígitosPorcentaje (formato propietario). Ver abajo.
50003EnteroMonto mínimo para aplicar cobro porcentual.
50004EnteroMonto máximo para aplicar cobro porcentual.
50005EnteroValor fijo por transacción (ej. "1200" = $1.200).
50006EnteroMonto máximo del valor fijo.
50007EnteroIVA de la transacción (informativo).
50008"1" o "0"Aproximación del porcentaje: 1 = hacia arriba, 0 = hacia abajo.

​
Cobro por transacción — TC

CódigoValorDescripción
501"1" o "0"Habilita cobro por transacción TC.
50101"1" o "0"Tipo de cobro: 1 = porcentaje, 0 = valor fijo.
50102String 4 dígitosPorcentaje.
50103EnteroMonto mínimo.
50104EnteroMonto máximo.
50105EnteroValor fijo.
50106EnteroMáximo fijo.
50107EnteroIVA (informativo).
50108"1" o "0"Aproximación.

​
Formato de porcentaje (códigos 50002 y 50102)

Este formato es propietario y propenso a errores. Léelo dos veces.
El campo acepta un string de 4 dígitos donde los dos últimos son los decimales:
StringRepresenta
"0050"0.50%
"0100"1.00%
"0195"1.95%
"0200"2.00%
"0250"2.50%
"1000"10.00%
"1500"15.00%
"2500"25.00%

​
Excepción documentada

Para valores menores a 1%, la doc oficial menciona una convención alternativa con 2 dígitos:
  • "02" = 2%
  • "09" = 9%
  • "10", "15", "25" para 10%, 15%, 25%
Esta ambigüedad existe en el instructivo oficial v6.0. Hay dos convenciones superpuestas:
  • 2 dígitos: "02" = 2%
  • 4 dígitos: "0195" = 1.95%
Para evitar errores, usa siempre 4 dígitos con padding de ceros: "0200" = 2%, "0900" = 9%, "1000" = 10%. [Pendiente de validación con TI.]

​
Ejemplos

​
Mínimo viable (solo PSE)

"AdicionalesConfiguracion": [
  { "int_codigo": 50, "str_valor": "2701" }
]

​
PSE + TC con URL de retorno custom

"AdicionalesConfiguracion": [
  { "int_codigo": 50,  "str_valor": "2701" },
  { "int_codigo": 104, "str_valor": "https://micomercio.com/retorno" }
]

​
Pagos mixtos habilitados, máximo 3 fracciones, mínimo $10.000

"AdicionalesConfiguracion": [
  { "int_codigo": 50,  "str_valor": "2701" },
  { "int_codigo": 100, "str_valor": "1" },
  { "int_codigo": 109, "str_valor": "1" },
  { "int_codigo": 105, "str_valor": "10000" },
  { "int_codigo": 106, "str_valor": "3" }
]

​
Cobro por transacción PSE del 1.95%, aproximando hacia arriba

"AdicionalesConfiguracion": [
  { "int_codigo": 50,    "str_valor": "2701" },
  { "int_codigo": 500,   "str_valor": "1" },
  { "int_codigo": 50001, "str_valor": "1" },
  { "int_codigo": 50002, "str_valor": "0195" },
  { "int_codigo": 50008, "str_valor": "1" }
]

​
Pagos recurrentes TC: 12 meses, cobro mensual

"AdicionalesConfiguracion": [
  { "int_codigo": 50,  "str_valor": "2701" },
  { "int_codigo": 113, "str_valor": "1" },
  { "int_codigo": 114, "str_valor": "12" },
  { "int_codigo": 115, "str_valor": "1" }
]

​
Cobro en dólares para TC

"AdicionalesConfiguracion": [
  { "int_codigo": 50,  "str_valor": "2701" },
  { "int_codigo": 116, "str_valor": "1" },
  { "int_codigo": 117, "str_valor": "US" }
]

​
Ver también

Cobro por transacción

Detalle de los fees y cómo se calculan.

Casos de uso

Ejemplos de integración por escenario.