Skip to main content
ZonaPagos permite que el comercio cobre al usuario un fee adicional por transacción (por ejemplo, para cubrir la comisión del medio de pago). Se configura en AdicionalesConfiguracion.
Este cobro es opcional y lo define el comercio. No tiene relación con la tarifa que ZonaPagos cobra al comercio, que se acuerda comercialmente.

​
Modalidades

Hay dos modalidades de fee, excluyentes entre sí:
El fee es un % del valor de la transacción.Ejemplo: 1.95% sobre 100.000=100.000 = 1.950 adicionales.

​
Configuración para PSE

CódigoValorQué hace
500"1"Activa el cobro por transacción PSE.
50001"1" o "0"1 = porcentaje, 0 = fijo.
50002String 4 dígitosPorcentaje si modalidad = porcentaje.
50003EnteroMonto mínimo para aplicar el cobro porcentual.
50004EnteroMonto máximo para aplicar el cobro porcentual.
50005EnteroValor fijo a cobrar si modalidad = fijo.
50006EnteroMonto máximo para el cobro fijo.
50007EnteroIVA asociado al fee (informativo).
50008"1" o "0"Aproximación del resultado: 1 = a mayor, 0 = a menor.

​
Configuración para TC

Simétrico a PSE, con códigos 501, 50101 – 50108.

​
Ejemplos

​
PSE con fee porcentual del 1.95%

"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" }
]
Efecto: una transacción de 100.000cobra100.000 cobra 1.950 adicionales al usuario (aproximado hacia arriba si hay decimales).

​
PSE con fee fijo de $1.200

"AdicionalesConfiguracion": [
  { "int_codigo": 50,    "str_valor": "2701" },
  { "int_codigo": 500,   "str_valor": "1" },
  { "int_codigo": 50001, "str_valor": "0" },
  { "int_codigo": 50005, "str_valor": "1200" }
]

​
TC con fee porcentual del 2.5%

"AdicionalesConfiguracion": [
  { "int_codigo": 50,    "str_valor": "2701" },
  { "int_codigo": 501,   "str_valor": "1" },
  { "int_codigo": 50101, "str_valor": "1" },
  { "int_codigo": 50102, "str_valor": "0250" },
  { "int_codigo": 50108, "str_valor": "1" }
]

​
Consideraciones

El cobro por transacción se suma al flt_total_con_iva que envías. El usuario ve el total final en el formulario de pago. Comunícalo claramente en tu checkout para no generar confusión.
Regulación: verifica con tu área legal si cobrar un fee adicional al usuario cumple con la regulación de tu país y categoría comercial.
Experiencia de usuario: considera mostrar el fee en el carrito antes del checkout, no como sorpresa al final.
Aproximación: las redes de pago no aceptan decimales. Si usas porcentaje, configura el código 50008 / 50108 según prefieras redondear a mayor (más ingreso) o a menor (mejor UX).

​
Ver también

AdicionalesConfiguracion

Catálogo completo de códigos.

Caso de uso: cobro por transacción

Implementación paso a paso.