Configuración de credenciales

Descubre qué son, para qué sirven y cómo configurar tus credenciales en comercios sin la lógica de jerarquías.

 

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

 

Credenciales para comercios que no operan bajo lógica de jerarquías

🚨 Advertencia: Ten en cuenta que, la configuración que se detalla a continuación, únicamente aplica para comercios que no operan bajo la lógica de jerarquías o subcomercios. Recuerda que, para comercios que utilizan la lógica de jerarquías, esta categorización no se utiliza. Si requieres conocer el proceso para consultar las credenciales de tus sucursales o subcomercios, visita nuestra guía disponible Consulta de credenciales bajo lógica de jerarquías.

 

Existen dos conceptos de credenciales para comercios que no operan bajo la lógica de jerarquías, los cuales son:

1. La credencial maestra, la cual se asigna a tu comercio. 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. 

 

ℹ️ Notas: La distinción entre credencial maestra o secundarias solo aplica exclusivamente a los comercios que no operan bajo lógica de jerarquías; mientras que para aquellas cuentas de customers o clientes que sí operan bajo lógica de jerarquías, esta categorización no se utiliza. El usuario Maestro customer solo está disponible bajo demanda. Si deseas tener más información sobre cómo habilitarlo, ponte en contacto con nosotros.

 

Pasos para crear credenciales secundarias en la consola

⚠️ Advertencia:  Ten en cuenta que, la configuración que se detalla a continuación, únicamente aplica para comercios que no operan bajo la lógica de jerarquías o subcomercios.

Para generar credenciales adicionales a tu comercio, puedes ingresar con tu usuario maestro o maestro credenciales 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 + Agregar credencial .
2. Ingresa un Nombre 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 nombre 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, regenerar o eliminar credenciales

Además de asignar una credencial maestra y crear credenciales secundarias también puedes: 

 

Activar y desactivar credenciales

⚠️ Advertencia:  Ten en cuenta que, la configuración que se detalla a continuación, únicamente aplica para comercios que no operan bajo la lógica de jerarquías o subcomercios.

 

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 verás el listado de las credenciales asociadas a tu comercio. En el extremo derecho de cada fila estará habilitado el ícono de más acciones.
2. Selecciona la opción de Desactivar para aquella credencial que deseas dejar inactiva. Confirma la acción oprimiendo el botón de Desactivar en el recuadro emergente. 
3. Para reactivar una credencial deshabilitada, vuelve a oprimir el botón de más acciones y haz clic en Activar .

ℹ️ Notas: Al desactivar una credencial, esta aparecerá marcada en color amarillo y su Estado cambiará a Deshabilitado. Puedes activar o desactivar credenciales mediante nuestra API. Para ello, revisa nuestro endpoint de Activar o desactivar.

 

 

Regenerar y editar credenciales

⚠️ Advertencia:  Ten en cuenta que, la configuración que se detalla a continuación, únicamente aplica para comercios que no operan bajo la lógica de jerarquías o subcomercios.

 

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, ubícate sobre la fila de una credencial y oprime el botón de más acciones.
2. Para editar el nombre de una credencial, oprime la opción de Editar alias . Ingresa un nuevo nombre o corrige el anterior y oprime Editar.
3. Elige la opción de Renovar llave para restablecer una credencial; luego haz clic en Regenerar llave dentro del recuadro emergente.

ℹ️ Nota: Puedes regenerar credenciales mediante nuestra API. Para ello, revisa nuestro endpoint de Regenerar una credencial.

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, ubícate sobre la fila de una credencial y oprime el botón de más acciones.
2.  Selecciona la opción Eliminar . 
3. En la ventana emergente de confirmación, haz clic en el botón Eliminar .

ℹ️ Nota: Puedes eliminar tus credenciales mediante nuestra API. Para ello, revisa nuestro endpoint de Eliminar credencial.