How to run the Hello World API with Mutual SSL on Postman

shameem
Visa Employee

How to run the Hello World API with Mutual SSL on Postman

In this "How-to" guide we will show you how to run the Visa Hello World API with Two-Way SSL (Mutual Authentication) on Postman. The Hello World API is a simple API for testing the connectivity with the Visa Network.

 

Important Links:

 

 

How to Create a Visa Developer Project

 

Before you are able to run the “Hello World” Project, you must create a Visa Developer Portal (VDP) project and get credentials. If you haven't registered yet just click on register here, fill out the account information, agree to the terms and conditions and click on receive emails. Once you have successfully activated your account, you will see your dashboard and you are ready to go.

 

java1.png

 

Once you are there, click on create your first project if this is your first project.  On the next page, you will be asked for details, such as project name, description and a list of APIs to choose from.

 

Java2.png

 

For this tutorial, we're going to select “Visa Direct” and click create project.

 

 

Java3.png

 

How to get Credentials

 

After creating your project, you will be redirected to the project summary page. You can obtain your project credentials by browsing the left side navigation menu of your project and click on “Credentials”.

 

Java4.png

 

What is required for the Two-Way SSL (Mutual Authentication)?

 

To be able to make an API call with 2-way SSL authentication, you need to have the following:

 

  1. User ID
  2. Password
  3. Your client cert
  4. Your private key previously downloaded
  5. Visa Development Platform Certificate

Java5.png

 

 

You will need to download the project certificate as well as the common certificates - Visa Developer Platform certificate and DigiCert Certificate and save them in the correct directory. 

 

 

How to run the Hello World API with Mutual SSL on Postman

 

Next, we'll show you how to run the “Hello World API” with Mutual SSL on Postman.  Postman is a free and open source API development and testing solution, and can be can be downloaded using below link:

 

https://www.getpostman.com/

 

Step 1 - Launch Postman

 

  • Create a collection and named it "VISA" (or any other name)

2020-11-16_20-21-46.png

 

 

  • Create a new request by click on the "New" buttion and click "Request"

 

2020-11-16_20-23-15.png

 

  • Name the request "helloworld" and choose the collection name "VISA" or what the name you have provided.

 

2020-11-16_20-55-04.png

 

 

2020-11-16_20-57-14.png

 

 

Step 2 - Configure 2-Way (Mutual) SSL

 

 

  • Open the postman Settings 

2020-11-16_21-23-29.png

 

 

  • Click on the Certificates tab to import your certificate and key file.

2020-11-16_21-27-17.png

Enter the host: sandbox.api.visa.com

And browser your client certificate and key file and click “Add”.

 

 

Step 3 - Configure API credentials

 

  • Click on the Authorization Tab and select "Basic Auth"

 

2020-11-16_21-32-00.png

 

  • Enter your Username and Password for basic authentication.

 

2020-11-16_21-34-28.png

 

 

Step 4 - Make API Call

 

  • Click Send button to make the API Call. You should see the response in JSON

 

2020-11-16_21-43-07.png

 

 

 

Want more? Join the Visa Developer Community to get alerts on the latest tutorials, guides and new developer resources. Stay tuned for more in the series. 

 

Written by: @shameem@jmedlen, & @mprsic 

8 REPLIES 8
Amith71965
Regular Visitor

Re: How to run the Hello World API with Mutual SSL on Postman

Well I'm doing the same way but still I can see error message something like this Error: error:0b000074:X.509 certificate routines:OPENSSL_internal:KEY_VALUES_MISMATCH

What could be the reason and how to tackle this problem?
Amith Kumar Yadav
Amith71965
Regular Visitor

Re: How to run the Hello World API with Mutual SSL on Postman

Well I'm doing the same way but still I can see error message something like this Error: error:0b000074:X.509 certificate routines:OPENSSL_internal:KEY_VALUES_MISMATCH

What could be the reason and how to tackle this problem?

Amith Kumar Yadav
shameem
Visa Employee

Re: How to run the Hello World API with Mutual SSL on Postman

Hi @Amith71965 ,

 

Did you follow the Step 2 - Configure 2-Way (Mutual) SSL. Looks like you provided a wrong client certificate.

 

Kindly double check and ensure to provide the correct certificate on Postman for Mutual SSL. The client certificate can be downloaded from your VDP project under the credentials tab.

 

I hope that helps.

 

Thank you

JimmyCh
Occasional Visitor

Re: How to run the Hello World API with Mutual SSL on Postman

Hi, there is a mistake in the post,
in
Step 2 - Configure 2-Way (Mutual) SSL
Enter the host: sandbox.visa.api.com
The host should be sandbox.api.visa.com

zama024
Newbie

Re: How to run the Hello World API with Mutual SSL on Postman

Hello,

I followed all the steps but getting following error:

 

{
"responseStatus": {
"status": 404,
"code": "9005",
"severity": "ERROR",
"message": "Requested route not found",
"info": ""
}
}

I_Doroteo3
Visa Developer Support Specialist

Re: How to run the Hello World API with Mutual SSL on Postman

Hi @zama024

 

You can also refer to this YouTube video from the Visa channel that provides step by step instructions for how to connect using Two-Way SSL in Postman.

 

Tutorial: How to Connect to Visa APIs using Two-way SSL and Postman - YouTube

 

Thanks, 

Illana

nab4nabeel
Helper

Re: How to run the Hello World API with Mutual SSL on Postman

Followed all the steps but I get the below error, kindly provide assistance on the below error-

{
    "responseStatus": {
        "status"400,
        "code""9123",
        "severity""ERROR",
        "message""Expected input credential was not present",
        "info"""
    }
}
Diana_Tran
Visa Developer Support Specialist

Re: How to run the Hello World API with Mutual SSL on Postman

Hi @nab4nabeel,

 

Please provide the information below for investigation of the error. 

1. End Point
2. Request Header
3. Request Body
4. Response Header (include the x-correlation-id)
5. Response Body

You can find the x-correlation-id in the response header.




Thanks,

Tee



Was your question answered? Don't forget to click on "Accept as Solution" to help other devs find the answer to the same question.