¿Qué son la Clave Pública y la Clave Secreta?

Para poder conectarte a nuestra API, necesitas introducir las Claves Pública y Secreta en el plugin o en tu código.

Tienes que hacerlo para cada entorno de prueba o producción que quieras utilizar.

Para saber más de la integración con nuestra API visita esta guía o si prefieres utilizar un plugin visita esta guía.

✋ Es muy importante que cuides de estas claves y no las pegues en cualquier lugar.

¿Cómo encontrar tus Claves API?

Para cada entorno puedes encontrar las claves en tu panel de Zru.

🧐 Recuerda que las claves son distintas en cada entorno.

Sigue los siguientes pasos:

• En el panel, asegúrate de estar en el entorno que deseas.
• En el menú vertical izquierdo, selecciona "Configuración".
• Haz clic en el tile "Integración".
• En el bloque Claves API verás una ficha por cada clave, con su nombre, su estado, la Clave pública, la Clave secreta, la Fecha de creación y el Último uso.
• Haz clic en el icono de copiar de la clave pública o de la secreta para pegarla en tu código o plugin.

🧐 Por cuestiones de seguridad, la Clave Secreta no se puede visualizar en el panel, pero puedes copiarla y pegarla donde necesites.

🧐 Si una clave todavía no se ha utilizado, en Último uso verás Nunca.

Tener varias Claves API en un mismo entorno

Puedes tener varias Claves API en el mismo entorno, en lugar de un único par de claves. Así puedes asignar una clave a cada aplicación o integración e identificar de un vistazo con qué se está utilizando cada una.

La Clave predeterminada del entorno aparece como una ficha más, pero no se puede editar ni desactivar.

🧐 Las notificaciones que Zru envía a tus webhooks se firman siempre con la Clave predeterminada del entorno. Tenlo en cuenta si validas la firma en tu servidor.

Crear una Clave API

• Ve a Configuración ▶︎ Integración.
• En el bloque Claves API, haz clic en Crear claves.
• En Nombre de la clave, escribe un nombre descriptivo que identifique su propósito o la aplicación con la que se va a utilizar.
• Activa Solo lectura si quieres que las peticiones firmadas con esa clave solo puedan consultar información, nunca crear ni modificar.
• En Estado de la clave, deja la clave activa o créala desactivada.
• Haz clic en Crear clave.

⚠️ Solo lectura se decide al crear la clave y no se puede cambiar después. Si necesitas otra configuración, crea una clave nueva.

Editar o desactivar una Clave API

En el menú ... de cada ficha tienes dos acciones:

• Editar: cambia el Nombre de la clave o su Estado, y haz clic en Guardar cambios.
• Desactivar: la clave deja de aceptar peticiones de inmediato.

⚠️ Al desactivar una clave, las integraciones que la usen empezarán a fallar hasta que actives otra clave o reactives esta. Compruébalo antes de desactivarla.

Actualizado el: 11/08/2026