¿Cómo configurar credenciales?

  • Actualización

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:

  1. La credencial maestra, la cual se asigna a tu comercio principal. Solo la puede gestionar un usuario Maestro de credenciales.
  2. 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:

  1. En el dashboard de credenciales, haz clic en el botón  image_3__2_.png.
  2. Aparecerá una lista desplegable, selecciona la opción image_4__1_.png.
  3. 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 image_5__1_.png .

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:

  1. En el dashboard de credenciales, haz clic en el botón image_9.png.
  2. Ingresa un Alias para la credencial que vas a crear.
  3. Haz clic en el botón Agregar.
  4. 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: 

  1. En el dashboard de credenciales, haz clic en el botón  image_3__2_.png.
  2. Selecciona la opción image_6__1_.png. 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 image_7__1_.png.

📝 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:

  1. En el dashboard de credenciales, haz clic en el botón image_3__2_.png.
  2. Selecciona la opción image_8.png.
  3. 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.

  1. En el dashboard de credenciales, haz clic en el botón image_3__2_.png.
  2. Selecciona la opción image_10.png.
  3. 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.

Artículos relacionados