JavaScript is disabled. Some features may not work. You can also read the static version: View text version

Generate Keys and Run Sample Project

Merchant must securely generate 2048 bit RSA Public Private Key pair on their servers inside a crypto vault. Merchant must share the Public Key (Key Format-PEM) with the bank during onboarding.

This public-private key pair is crucial for running the project securely.

Private key must be securely kept in a crypto vault on the merchant servers. Private key should never flow to the client.

1. Generate the Keys

Two sets of Public-Private key pairs are required for encryption. You will generate one such pair and the bank will generate the other pair.

For generating your public-private key, there are two approaches as mentioned below:

Option 1

Generate the Keys on SmartGateway Dashboard

Login to SmartGateway Dashboard and navigate to JWT Keys

Login → Payments → Settings → Security → JWT Keys
Click on ‘Upload New JWT’ button
Click on ‘I don’t have the JWT Keys, I want to auto generate the keys’ as shown below:
Click on ‘Auto Generate Keys’ button as shown below:
This will auto-download your Private Key and Bank’s Public Key in your ‘Downloads’ folder as shown below:

Image Label Appears here

Please note the description of the downloaded parameters below
1. ‘privateKey.pem’ - Your Private Key
2. ‘key_91e09ab9d5154f569bb2b4ac54d6ee7f.pem’ - Bank’s Public Key
3. ‘config.json’ - contains file paths of your keys as well as values for Merchant_ID and Payment_Page_Client_ID
Bank’s Key Uuid will appear on the SmartGateway Dashboard as shown below:

Option 2

Generate the Keys on your Local System

Private Key: Run the following Command line in your ‘Terminal’ to generate a private key file(private-key.pem):

openssl genrsa -out private-key.pem 2048
Public Key: Run the following Command line in your ‘Terminal’ to generate a public key file(public-key.pem) for the private key file generated in the previous step:

openssl rsa -in private-key.pem -pubout -out public-key.pem
Upload your Public key(public-key.pem), generated in the previous step, on the SmartGateway Dashboard
Once uploaded, the bank will auto-generate the other Public-Private key pair. Bank's Private key will be stored securely at Bank’s end.

Bank’s Public key will get auto-downloaded in your ‘Downloads’ folder (Example: key_aa**bb.pem file will get auto-downloaded). Bank’s Key Uuid will appear on SmartGateway Dashboard.

2. Run the Sample Project

Step 2.1

Download the Sample Project file for PHP

Step 2.2

Input File Paths for Keys in 'config.json' file

Option 1 -

Step 1 : Open the PHP project in your PHP environment and replace the config.json file already present in the project folder with the config.json file downloaded from the dashboard.

Step 2 : Add your private key (‘privateKey.pem’) and Bank’s public key (‘key_91e09ab9d5154f569bb2b4ac54d6ee7f.pem’ ) to the PHP project folder

Option 2 - Open the PHP project in your PHP environment and input the file paths in following keys:

Scroll inside to view more

Parameter	Description
PRIVATE_KEY_PATH	Add the file path for your private key
PUBLIC_KEY_PATH	Add the file path for bank's public key obtained from the dashboard
KEY_UUID	Add the Key_Uuid present in the dashboard
MERCHANT_ID	Add the Merchant_ID provided by the bank
PAYMENT_PAGE_CLIENT_ID	For Sandbox, add 'hdfcmaster' as your client_id

Step 2.3

Install System Dependencies

Step 2.4

Run the Server