Dashboard

Tu panel de control. Desde aquí gestionas credenciales, configuraciones, operaciones, usuarios y cuentas beneficiarias. Esta página recorre cada área paso a paso.

Sandbox

dashboard-sandbox.zertiban.com

Producción

dashboard.zertiban.com

Vista principal del Dashboard tras completar el onboarding.

¿Qué obtienes al terminar?

Los 6 valores que necesitarás como variables de entorno para integrar PagaFactu o ZertiPay desde tu backend. Los encontrarás resumidos al final de la página.

1 Generar credenciales API

Desde Desarrolladores generas, rotas y revocas los pares clientId / clientSecret que autentican cada llamada OAuth2.

Ve a Desarrolladores → Nueva credencial

El sistema genera automáticamente el par clientId / clientSecret.

Sección Desarrolladores con el botón Nueva credencial

Copia el clientSecret inmediatamente

El secret se muestra solo una vez. Guárdalo en tu gestor de secretos antes de cerrar el modal: no hay forma de recuperarlo después.

No expongas el secret

No incluyas el clientSecret en código cliente (frontend, apps móviles). Mantenlo siempre en tu backend.

Rota antes de los 180 días

Las credenciales caducan cada 180 días. Puedes tener varias activas: crea la nueva, despliega a producción y revoca la vieja sin downtime.

Elimina credenciales que ya no uses

Cuando una credencial deja de ser necesaria, elimínala desde el listado de Desarrolladores. La eliminación revoca el par clientId / clientSecret de forma permanente: cualquier llamada OAuth2 con esa credencial empezará a fallar.

Antes de eliminar

Confirma que ningún servicio en producción sigue usando la credencial. Si es la que está activa, despliega primero la nueva y verifica que las peticiones llegan firmadas con ella antes de eliminar la antigua.

2 Crear una configuración de flujo

Una configuración agrupa apariencia visual, comportamiento de operaciones y URLs de redirección. Puedes tener varias (ej. "Cobros 30 días", "Urgente 7 días") y elegir cuál usar en cada llamada API.

Ve a Configuración → Configuraciones de operaciones

Verás el listado de configuraciones existentes con su ID, nombre, descripción y fecha de creación.

Haz clic en Nueva configuración (arriba a la derecha).

Listado de Configuraciones con el botón Nueva configuración

Rellena los bloques del formulario

La pestaña Configuración General (obligatoria) agrupa cuatro bloques:

• Identifica tu configuración: nombre interno (máx. 50) y descripción opcional (máx. 255). No los ve tu cliente.
• Establecer configuración predeterminada: toggle para marcarla como la que se usará por defecto.
• Personaliza la pantalla de pago: logo, colores e idioma (todos obligatorios).
• Textos y opciones de la WebApp: comportamiento de la navegación para el pagador.

La pestaña Configuración Avanzado es opcional (comportamiento de operación, URLs de redirección con parámetros dinámicos como {operationId} o {operationStatus}). Si no la rellenas, se usan los valores predeterminados.

Formulario de Nueva configuración de operación

Guarda y copia el configurationUuid

Al hacer clic en Crear configuración aterrizas en la vista de detalle. El ID que aparece bajo el nombre es el configurationUuid que referenciarás en cada llamada API: usa el botón de copia para llevártelo al portapapeles.

Desde esta misma vista puedes Duplicar la configuración para crear una variante sin empezar de cero.

Vista de detalle con el configurationUuid visible

3 Gestionar operaciones transaccionales

La pestaña Operaciones muestra el listado completo de cobros y pagos generados desde el API o desde el propio Dashboard. Es el sitio donde monitorizar estados, investigar incidencias y reconciliar con tu ERP.

Abre Operaciones y aplica filtros

Combina filtros para encontrar una operación concreta o un rango específico:

• Estado CREATED OPENED COMPLETED REJECTED EXPIRED CANCELLED
• Rango de fechas: fecha de creación o de expiración
• externalId: identificador interno que envía tu ERP
• Importe: rango mínimo / máximo
• Configuración: filtra por configurationUuid

Listado de operaciones con filtros

Abre el detalle de una operación

Haz clic en una fila para ver:

• Cabecera: operationUuid, externalId, estado, importe y concepto
• Pagador: nombre, email, IBAN detectado y banco seleccionado
• Cuenta beneficiaria: creditorAccountUuid y alias del IBAN destino
• Histórico: timeline con cada cambio de estado y su timestamp
• Documentos: PDF con QR, recibo y adjuntos
• Webhooks: notificaciones enviadas, respuesta HTTP y reintentos

Vista de una operación con todos los detalles

Acciones disponibles

Acción	Cuándo usarla
Descargar	Descarga los documentos asociados a la operación.
Cancelar	Disponible para operaciones en estado CREATED o OPENED sin un pago en curso.
Editar caducidad	Disponible para operaciones en estado CREATED o OPENED.

4 Gestionar usuarios e invitaciones

La pestaña Usuarios controla quién tiene acceso a tu businessUuid y con qué nivel de permisos.

Revisa los roles disponibles

Zertiban maneja únicamente dos roles:

• Administrador Acceso completo al dashboard. Puede gestionar usuarios, configuraciones, credenciales técnicas y todos los datos de la organización.
• Colaborador Acceso operativo. Puede consultar y gestionar operaciones y flujos, y visualizar los datos de la organización.

Listado de usuarios con columna de rol

Invita a un usuario

Haz clic en Invitar usuario y rellena:

• Email del usuario invitado
• Rol inicial (Administrador o Colaborador)

El invitado recibe un enlace único que expira en 7 días. Si no se acepta, reenvíalo desde el listado.

Modal de invitar usuario

Gestiona accesos de usuarios e invitaciones

• Cambiar rol: alterna entre Administrador y Colaborador en cualquier momento.
• Bloquear: revoca el acceso temporalmente sin perder el historial.
• Eliminar: revoca permanentemente. Las credenciales técnicas creadas por ese usuario siguen activas: rótalas manualmente si hace falta.
• Reenviar invitación: para invitaciones pendientes expiradas.

5 Cuentas beneficiarias

Cada cuenta beneficiaria registrada en Zertiban dispone de un creditorAccountUuid único. Este identificador asocia cada operación con la cuenta bancaria concreta en la que se recibirán los fondos procesados a través de la plataforma.

Ve a Configuración → Cuentas beneficiarias

Verás el listado completo de cuentas asociadas a tu businessUuid, junto con el creditorAccountUuid necesario para referenciarlas desde la API.

La primera cuenta se registra durante el onboarding: en sandbox por email a [email protected] y en producción en el Paso 2 (pago de 0,01 € de verificación).

Listado de cuentas beneficiarias con sus creditorAccountUuid

Habilita, deshabilita y edita cuentas

Desde el Dashboard gestionas el estado y los metadatos de cada cuenta según las necesidades operativas de tu organización:

• Habilitar / deshabilitar: controla qué cuentas pueden recibir nuevas operaciones. Las cuentas deshabilitadas no pueden utilizarse en operaciones ni peticiones API nuevas.
• Cuenta predeterminada: cambia cuál se usa por defecto cuando una petición API no incluye explícitamente un creditorAccountUuid.
• Alias: edita el nombre descriptivo asociado a cada cuenta para facilitar su identificación y gestión interna.

Restricciones al deshabilitar

Zertiban no permite deshabilitar todas las cuentas existentes ni la cuenta marcada como predeterminada. Cambia primero la predeterminada si necesitas deshabilitar la actual.

✓ Checkpoint: tienes los 6 valores

Guarda los 6 valores como variables de entorno. Con estos valores ya puedes usar PagaFactu y ZertiPay, ambos utilizan las mismas credenciales.

ZERTIBAN_BUSINESS_UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ZERTIBAN_CONFIG_UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ZERTIBAN_CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ZERTIBAN_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ZERTIBAN_CREDITOR_UUID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ZERTIBAN_WEBHOOK_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

¿Necesitas ayuda?

Contacta con [email protected] para que el equipo de Zertiban te acompañe durante el proceso.