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 / Client 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, que es de acceso público:
https://developer-nc.zertiban.com/
Puedes consultar la documentación sin iniciar sesión. La gestión de credenciales se realiza desde la sección Desarrolladores de tu Dashboard de Zertiban.
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: incluye el acceso a la documentación y la gestión de las client credentials.
La gestión de credenciales está disponible únicamente para usuarios con rol de Administrador. Las client credentials son las credenciales que usa tu aplicación para autenticarse contra la API, y se componen de un Client ID y un Client Secret.
Crear una credencial (Client ID y Client Secret)
Para generar una credencial nueva, entra en Desarrolladores y pulsa Crear credencial. El sistema te pedirá un alias para identificarla (por ejemplo, "Test", "App" o "Producción") y, al confirmar, se generarán el Client ID y el Client Secret.
Un punto importante: el Client Secret es un dato sensible y se muestra una sola vez, en el momento de la creación, para que lo copies. No podrás volver a consultarlo más adelante. Por eso conviene almacenarlo en un lugar seguro (por ejemplo, un gestor de secretos). Si lo pierdes, tendrás que eliminar la credencial y crear una nueva.
Cuando vuelvas a la pantalla principal de Desarrolladores, verás la credencial ya creada en el listado, junto con información como el alias, el Client ID, la fecha de creación y quién la creó.
Visualizar credenciales existentes
En la misma sección Desarrolladores aparece la tabla con las credenciales disponibles, que muestra el Client ID, el alias, la fecha de creación, quién la creó y las acciones disponibles. El Client Secret no aparece en el listado. Si todavía no se ha creado ninguna credencial, verás la pantalla en estado vacío.
Este listado es útil para gestionar entornos (por ejemplo, una credencial para pruebas y otra para producción) y para controlar qué credenciales siguen activas.
Eliminar una credencial (revocar acceso)
Desde la tabla puedes eliminar una credencial. Al hacerlo, estás revocando su uso: cualquier integración que utilice ese Client ID / Client Secret dejará de poder generar nuevos tokens. La eliminación requiere confirmación.
La eliminación es definitiva: una vez eliminada, la credencial no se puede recuperar ni volver a ver. Por eso, antes de borrarla conviene confirmar que ya no está en uso o que existe una credencial alternativa preparada. (Los tokens ya emitidos siguen siendo válidos hasta que caducan de forma natural.)