Descubre cómo configurar tus credenciales; contraseñas únicas para autenticar tus transacciones y verificar la integración de tu comercio.
Con la creación de un comercio, por defecto se crea y asigna una credencial pública y privada. Estas credenciales las puedes encontrar dentro de tu consola en el módulo Desarrolladores > Credenciales.
¿Para qué sirven cada una de estas credenciales?
- La llave pública: identifica a tu comercio frente a Kushki y sirve para autenticar tus transacciones.
- La llave privada: autoriza las transacciones, por lo tanto ten en cuenta que no debe compartirse.
⚠️ Importante: Evita intercambiar la llave pública y privada entre diferentes comercios, ya que pueden generar errores al momento de la transacción y problemas al crear los informes desde tu Consola. |
¿Qué tipo de credenciales existen en Kushki?
Existen dos tipos de credenciales:
- La credencial maestra, la cual se asigna a tu comercio principal. Solo la puede gestionar un usuario Maestro de credenciales.
- Las credenciales secundarias, se asignan a tus comercios afiliados o secundarios. Estas credenciales pueden ser creadas por un usuario Maestro.
📝 Nota: El usuario Maestro de credenciales solo está disponible bajo demanda. Si deseas tener más información sobre cómo habilitarlo, ponte en contacto con nosotros. |
Encuentra cómo asignar una credencial maestra
Si ya cuentas con un usuario maestro de credenciales, puedes ingresar con este a la Consola de administración y asignar una credencial maestra.
Tu comercio solo puede tener una llave maestra o principal, y de esta dependen las llaves secundarias que generas.
Instrucciones:
- En el dashboard de credenciales, haz clic en el botón
.
- Aparecerá una lista desplegable, selecciona la opción
.
- En la ventana emergente de confirmación, haz clic en la opción Sí, asignar para seleccionar esta credencial como maestra.
Al completar el proceso, la llave principal o maestra de tus comercios tendrá esta etiqueta del lado derecho .
Pasos para crear una credencial secundaria en la consola
Para generar credenciales secundarias a tu comercio, puedes ingresar con tu usuario maestro al módulo Desarrolladores > Credenciales y seguir las instrucciones que se muestran a continuación:
- En el dashboard de credenciales, haz clic en el botón
.
- Ingresa un Alias para la credencial que vas a crear.
- Haz clic en el botón Agregar.
- La pantalla mostrará un mensaje de confirmación y las nuevas credenciales aparecerán en el tablero. Podrás identificarlas por el alias que definiste en el paso 2.
📝 Nota: Puedes crear o añadir credenciales mediante nuestra API. Para ello, revisa en la documentación nuestro endpoint Crear una credencial. |
Activar, editar o eliminar credenciales:
Además de asignar una credencial maestra y crear credenciales secundarias también puedes:
Activar y desactivar las credenciales
Las necesidades de tus comercios secundarios pueden variar y desde tu Consola de administración en el módulo Desarrolladores > Credenciales puedes activar o desactivar las credenciales que utilizas para realizar tus transacciones.
Instrucciones:
- En el dashboard de credenciales, haz clic en el botón
.
- Selecciona la opción
. La credencial quedará desactivada, pero todavía podrás generar informes de las transacciones realizadas con ella. Si deseas volver a activarla selecciona la opción
.
📝 Nota: Puedes activar o desactivar credenciales mediante nuestra API. Para ello, revisa nuestro endpoint de Activar o desactivar. |
Regenerar las credenciales
Cuando se concreta un cambio de personal en tu comercio, lo ideal es que las credenciales con las que se integran a los servicios de Kushki también se modifiquen. A través de la Consola de administración en el módulo Desarrolladores > Credenciales, puedes regenerar o renovar las llaves públicas y privadas para realizar las transacciones de tus comercios de forma segura.
Instrucciones:
- En el dashboard de credenciales, haz clic en el botón
.
- Selecciona la opción
.
- En la ventana emergente de confirmación, haz clic en el botón Regenerar credencial. El sistema automáticamente renovará la llave pública y privada para esta credencial.
📝 Nota: Puedes regenerar credenciales mediante nuestra API. Para ello, revisa nuestro endpoint de Regenerar una credencial. |
Eliminar las credenciales
Desde tu Consola de administración en el módulo de Desarrolladores > Credenciales, puedes cancelar las credenciales de tus comercios afiliados, si uno de estos deja de estar disponible. Estos son los pasos para eliminar las credenciales de un comercio.
- En el dashboard de credenciales, haz clic en el botón
.
- Selecciona la opción
.
- En la ventana emergente de confirmación, haz clic en el botón Eliminar credencial
📝 Nota: Puedes eliminar tus credenciales mediante nuestra API. Para ello, revisa nuestro endpoint de Eliminar credencial. |