How to configure credentials?

Find out how to set up your credentials; unique passwords to authenticate your transactions and verify the integration of your merchant.

By default, with the creation of a merchant, a public and private credential is created and assigned. These credentials can be found within your console in the Developers > Credentials module.

What are each of these credentials for?

• Public key: It identifies your merchant in the Kushki database and serves to authenticate your transactions.
• Private key: It authorizes transactions on behalf of your merchant. Keep in mind that it should not be shared.

⚠️ Important: Avoid exchanging the public and private key between different merchants, since they can generate errors at the time of making transactions, and they can cause problems when creating the reports from your Console.

What kind of credentials exist in Kushki?

There are two types of credentials:

1. The master credential, which is assigned to your primary merchant. It can only be managed by a credential Master user.
2. Secondary credentials are assigned to your affiliated or secondary merchants. These credentials can be created by a Master user.

📝 Note: The Credential Master user is only available on demand. If you would like to receive more information on how to enable it, please contact us.

Find out how to assign a master credential

If you already have a master credential user, you can log in with it to the Admin Console and assign a master credential.

Your merchant can only have one master or primary key, and the secondary keys you generate depend on that master or primary key.

Instructions:

1. In the credentials dashboard, click the button.
2. A drop-down list will appear, select the  option.
3. In the confirmation popup, click the Yes, Assign option to select this credential as the master credential.

When you complete the process, the main or master key of your merchants will have this label on the right side .

Steps to create secondary credentials in the Console

To generate secondary credentials for your merchant, you can enter the Developers > Credentials module with your master user and follow the instructions shown below:

1. In the credentials dashboard, click the button.
2. Enter an Alias for the credential you are creating.
3. Click the Add button.
4. The screen will display a confirmation message and 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 by using our API. To do this, review our Create a credential endpoint in the documentation.

Activate, edit or delete credentials

In addition to assigning a master credential and creating secondary credentials you can also:

Turn on and turn off credentials

The needs of your secondary merchants may vary and from your Administration Console in the Developers > Credentials module you can activate or deactivate the credentials you use to carry out your transactions.

Instructions: 

1. In the credentials dashboard, click the button.
2. Select the option. The credential will be deactivated, but you will still be able to generate reports of the transactions made with it. If you want to reactivate it, select the  option.

📝 Note: You can activate or deactivate credentials through our API. To do so, please review our Activate or deactivate endpoint.

Regenerate credentials

When a change of personnel in your merchant takes place, it is important to make sure the credentials these people use to integrate to the Kushki services are also modified.Through the Administration Console in the Developers > Credentials module, you can regenerate or renew the public and private keys to carry out your merchant transactions safely.

Instructions:

1. In the credentials dashboard, click the button.
2. Select the  option. 
3. In the confirmation pop-up window, click the Regenerate credential button. The system will automatically renew the public and private key for this credential.

📝 Note: You can regenerate credentials by using our API. To do so, check out our Regenerate a credential endpoint.

Delete the credentials

From your Administration Console in the Developers > Credentials module, you can cancel the credentials of your affiliated merchants, in case one of them is no longer available. These are the steps to remove the credentials of a merchant.

1. In the credentials dashboard, click the button.
2. Select the  option.
3. In the confirmation pop-up, click the Delete credential button.

📝 Note: You can remove your credentials by using our API. To do so, check out our Remove Credential endpoint.