How to set up credentials?

Learn how to set up credentials; these are unique passwords to authenticate your transactions and verify your merchant’s integration of your merchant.

 

With the creation of a merchant, a public and private credential are automatically created and assigned. You can find these credentials within your console in the Developers > Credentials module.

 

What is the purpose of each of these credentials?

• The public key: identifies your merchant to Kushki and is used to authenticate your transactions.
• The private key: authorized transactions, therefore, keep in mind that it should not be shared.

⚠️Important: Avoid swapping the public and private keys between different merchants, as this can generate errors during transactions and issues when creating reports from your console.

 

Master and additional credentials for merchants not operating under hierarchical logic (or sub-merchants)

🚨 Warning: Keep in mind that the configuration detailed below only applies to merchants that do not operate under a hierarchical logic or sub-merchants. Remember that, for merchants that use the hierarchical logic, this categorization is not used. If you need to know the process to check the credentials of your branch offices or sub-merchants, visit our guide available here.

Currently, there are two current credential concepts in Kushki based on the operational logic under which the merchants work:

1. The master credential, which is assigned to your main merchant. Only a Master of credentials can manage it.
2. The additional credentials are assigned to your affiliated or secondary merchant. These credentials can be created by a Master user.

ℹ️ Notes: The distinction between master and additional or secondary credentials applies exclusively to merchants that do not operate under hierarchical logic; while for those customer accounts or clients that do operate under hierarchical logic, this categorization is not longer in use. The Master customer user is only available on demand. If you need more information on how to enable it, please contact us.

 

Steps to create additional credentials in the console

🚨 Warning: Keep in mind that the configuration detailed below only applies to merchants that do not operate under a hierarchical logic or sub-merchants.

To generate additional credentials for your merchant, you can log in with your master user or master credentials to the Developers > Credentials module and follow the instructions shown below:

1. In the Credentials dashboard, click on the Add credential button .
2. Enter a Name for the credential you are going to create.
3. Click on the Add button .
4. If successful, the new credentials will appear on the dashboard. You will be able to identify them by the alias you defined in step 2.

ℹ️ Note You can create or add credentials through our API. For this, check in the documentation our Create a credential endpoint.

 

Activate and deactivate credentials

🚨 Warning: Keep in mind that the configuration detailed below only applies to merchants that do not operate under a hierarchical logic or sub-merchants.

 

From your Administration console in the Developers > Credentials module, you can activate or deactivate the credentials you use to conduct your transactions.

 

Instructions

1. In the Credentials dashboard, you will see the list of credentials associated with your merchant. At the far right of each row, the more actions icon will be enabled .
2. Select the Deactivate option for the credential you wish to make inactive. Confirm the action by pressing the Deactivate button in the pop-up box. 
3. To reactivate a disabled credential, press the more options button again and click Activate.

 

ℹ️ Notes When deactivating a credential, it will appear marked in yellow and its Status will change to Disabled. You can activate or deactivate credentials through our API. For this, review our Activate or deactivate endpoint.

 

Regenerate and edit credentials

🚨 Warning: Keep in mind that the configuration detailed below only applies to merchants that do not operate under a hierarchical logic or sub-merchants.

 

When there is a staff change in your merchant, it is ideal that the credentials integrating with Kushki’s services also change. Through the Administration console in the Developers > Credentials module, you can regenerate or renew the public and private keys to conduct your merchant transactions securely.

 

Instructions

1. In the Credentials dashboard, locate the row of a credential and press the more action button
2. To edit the name of a credential, press the Edit alias option. Enter a new name or correct the previous one and press Edit.
3. Choose the Renew key option to reset a credential; then click Regenerate key with the pop-up box.

ℹ️ Notes You can regenerate credentials through our API. For this, check our Regenerate a credential endpoint.