Si tu empresa integra PagaFactu con su ERP/CRM o con un sistema propio, lo habitual es trabajar mediante la API de Zertiban. Para ello, necesitarás dos cosas: acceder a la documentación técnica y disponer de credenciales (Client ID / Secret) para autenticar tus llamadas.
Dónde encontrar la documentación de la API
La documentación oficial está disponible en el portal de desarrolladores:
https://developer.zertiban.com/
El acceso se realiza con las mismas credenciales que utilizas en el Dashboard de Zertiban (usuario y contraseña).
Sección “Desarrolladores” dentro del Dashboard
Desde el Dashboard de Zertiban, en el menú lateral encontrarás la sección Desarrolladores. Esta pantalla está pensada para que puedas trabajar con la integración sin salir del entorno del dashboard: desde ahí se incluye el acceso directo al portal de documentación y, sobre todo, la gestión de las client credentials.
Las client credentials son las credenciales que usa tu aplicación para autenticarse contra la API. Normalmente se componen de un Client ID y un Secret.
Crear una credencial (Client ID y Secret)
Para generar una credencial nueva, entra en Desarrolladores y pulsa Crear credential. El sistema te pedirá un nombre para identificarla (por ejemplo, “Test”, “App” o “Producción”) y, al confirmar, se generará el Client ID junto con el Secret.
Aquí hay un punto importante: el Secret es un dato sensible y se muestra para que lo copies y lo guardes, pero no podrás volver a consultarlo más adelante. Por eso, conviene almacenarlo en un lugar seguro (por ejemplo, un vault corporativo o un gestor de secretos) y evitar compartirlo por canales no seguros.
Cuando vuelvas a la pantalla principal de Desarrolladores, verás la credencial ya creada en el listado, junto con información de trazabilidad como quién la creó y cuándo.
Visualizar credenciales existentes
En la misma sección Desarrolladores aparece la tabla con las credenciales disponibles. Si todavía no se ha creado ninguna, verás la pantalla en estado vacío indicando que no hay credenciales registradas.
Este listado es útil para gestionar entornos (por ejemplo, tener una credencial para pruebas y otra para producción) y para controlar qué credenciales siguen activas.
Eliminar una credencial (revocar acceso)
Si eliminas una credencial, estás revocando su uso: cualquier integración que esté utilizando ese Client ID/Secret dejará de funcionar. Además, una credencial eliminada no se puede recuperar, así que antes de borrarla es recomendable confirmar que ya no está en uso o que existe una credencial alternativa preparada.
Para eliminarla, simplemente usa la opción de eliminar en la fila correspondiente y confirma la acción en el modal.
2FA para acceder a la sección de Desarrolladores
Por seguridad, el acceso a esta sección puede requerir tener activa la identificación en dos pasos (2FA). Si no está activada, el sistema te guiará para configurarla y te pedirá un código de verificación generado por una app de autenticación (por ejemplo Google Authenticator o similar).
Activar y desactivar integraciones
La activación y desactivación de integraciones se gestiona desde el Dashboard de Zertiban. El portal de desarrolladores (developer.zertiban.com) se utiliza para consultar la documentación técnica, pero las acciones operativas de integración se realizan en el propio dashboard.
Si necesitas activar o desactivar una integración y no ves la opción disponible, es posible que te falten permisos: en ese caso, debe revisarlo el administrador de tu organización en Zertiban.