> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://academy.zrupay.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Clave Pública y Clave Secreta

# ¿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](https://academy.zrupay.com/es/article/integracion-via-api-mzzw6v/) o si prefieres utilizar un plugin visita esta [guía](https://academy.zrupay.com/es/article/integracion-con-plugins-1l9mpvr/).

> ✋ 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.