Portal del comercio · Conceptos
Roles y permisos del comercio
En el portal, que alguien pueda o no hacer algo no depende de una sola cosa. Dependen de tres preguntas independientes, y las tres tienen que decir que sí:
Permiso efectivo = capacidad del comercio + rol del usuario + alcance de la clave (si hay clave)
flowchart LR A["¿Tu comercio tiene<br/>esta capacidad?"] -->|sí| B["¿Tu usuario tiene<br/>este permiso?"] B -->|sí| C["¿La clave cubre<br/>esta operación?"] C -->|sí| OK["Se hace"] A -->|no| N1["«Esta función no está<br/>habilitada para tu comercio»"] B -->|no| N2["«Necesitas el permiso…;<br/>pídeselo a tu administrador»"] C -->|no| N3["La clave no tiene alcance"]
1. La capacidad del comercio
Sección titulada «1. La capacidad del comercio»La decide FINORA (o el adquirente) para el comercio entero. Es un interruptor por función:
| Capacidad | Qué habilita | ¿Mueve dinero? |
|---|---|---|
| Desarrollador | Claves de API, secreto de los webhooks, checkout y documentación | No |
| Cobro sin terminal propio | Cobrar desde el portal, empujar cobros a un equipo, enlaces de pago | Sí |
| Marketplace | Ver y descargar aplicaciones | No |
| Equipos | Generar códigos de enrolamiento | No |
| Devoluciones | Pedir devoluciones y vueltos | Sí |
| Liquidaciones | Ver liquidaciones y estados de cuenta | No |
| Monitoreo en vivo | La Torre y sus pantallas de TV | No |
| Usuarios | Crear usuarios del comercio | No |
Hay plantillas de un clic (básica, integrador, cadena) que fijan todas a la vez. Apagar una capacidad bloquea empezar cosas nuevas, nunca terminar las que están en curso: revocar una clave filtrada, aprobar una devolución a medio camino o el autoactualizador de un equipo ya instalado siguen funcionando.
2. El rol del usuario
Sección titulada «2. El rol del usuario»Lo asigna el administrador de tu comercio a cada persona. Hay roles para cada trabajo, de menos a más:
| Rol | Para quién |
|---|---|
| Solo lectura | Quien solo consulta |
| Autorizado a instalar | Quien descarga aplicaciones y enrola equipos; no crea claves ni usuarios ni cobra |
| Soporte | Quien gobierna la flota sin tocar el dinero |
| Analista | Quien lee ventas, lotes y liquidaciones |
| Disputas | Quien atiende contracargos |
| Desarrollador | Quien integra el ERP o la tienda web |
| Gerente (administrador) | Quien administra el comercio: claves, usuarios, medios, devoluciones, cobros |
| Propietario | El único que nombra o retira propietarios y administradores |
3. El alcance de la clave
Sección titulada «3. El alcance de la clave»Solo aplica cuando un sistema (tu ERP, tu tienda web) llama a la API con una clave. Cada clave tiene un alcance:
| Alcance | Cubre |
|---|---|
| Integración | Cobros, checkout, webhooks y consultas. Para un ERP, una tienda web o un sistema de facturación |
| Equipos | Activar y actualizar terminales. No mueve dinero. Solo para instalaciones de TI; para un equipo nuevo se usa el código de enrolamiento |
| Completo | Todo lo que tu comercio puede hacer en la API. Úsalo solo si de verdad lo necesitas |
Cómo lo ves en el portal
Sección titulada «Cómo lo ves en el portal»- Si tu comercio no tiene la capacidad, la sección no aparece; si entras por el enlace directo, ves «Esta función no está habilitada para tu comercio; pídela a FINORA».
- Si tu usuario no tiene el permiso, la sección aparece atenuada y con candado; al entrar, el portal te dice qué permiso falta, qué rol lo trae y te deja un mensaje listo para copiar a tu administrador. Ver Pedir un permiso que te falta.
Lo que necesitas recordar
Sección titulada «Lo que necesitas recordar»- Tres comprobaciones independientes: comercio, usuario y clave.
- El comercio lo decide FINORA; el usuario, tu administrador; la clave, quien la crea.
- Apagar algo nunca deja una operación a medias.