Postman Setup

You can use Postman to send requests to Galileo's Program API. This guide describes how to set up Postman, add the Galileo Pro collection, and test an API request.

Download and install Postman

First, download and install the Postman application. To do this:

1. Go to www.postman.com/downloads/
2. Click Download the App.
3. When the installation file has finished downloading, click the file to install the application.
4. Follow installation prompts on the screen.

Add the Galileo Pro collection

When installation is complete, follow these steps to add the Galileo Pro collection to Postman.

1. Click Run in Postman below to run the collection.

   

2. In the Web page that opens, select your operating system.

3. Click Open Postman if prompted.
4. In Postman, click the Galileo Pro collection displayed in the Collections tab.

Edit collection variables

Next, copy your credentials from the Sandbox Dashboard into the Galileo Pro collection variables in Postman. These are identifying variables that will apply across the collection.

📘

Note

You can also use Postman with the Client Validation and Production environments. Credentials for these environments are not in your Sandbox Dashboard, rather, you will need to get them from your Galileo representative.

To add your credentials to Postman:

1. Open another webpage and log in to the Sandbox Dashboard to access your credentials: https://sandbox.gpsrv.com/
2. Scroll down to API CONNECTION DETAILS. These are your credentials for the Sandbox environment.

📘

Note

If you are using Postman with the CV or Production environment, enter the credentials from your Galileo representative instead of your Sandbox credentials.

3. In Postman, select Galileo Pro to open the collection tab.
4. In the collection tab, click Variables. This tab will store your credentials that apply across the collection.
5. In Postman, paste your credentials into both INITIAL VALUE and CURRENT VALUE columns for:
   • apiLogin — API LOGIN in the Sandbox Dashboard
   • apiTransKey — API TRANS KEY in the Sandbox Dashboard
   • providerId — TEST PROVIDER ID in the Sandbox Dashboard
   • prodId — TEST PRODUCT ID in the Sandbox Dashboard
   • programId — TEST PROGRAM ID in the Sandbox Dashboard

📘

Note

There are two pre-populated collection variables:

• url contains the base URL for sending API requests to the Sandbox environment. If you use Postman with CV or Production environments, replace this with your URL from Galileo.
• responseContentType sets the response format for API requests. The default format is json, but you can change it to xml if you prefer.

6. Click Save.

Test a Ping request

You can run a simple test to verify that your Galileo Pro collection is ready to run in Postman. Follow these steps to send a test Ping request.

1. In Postman, type “ping” in the filter box.
2. Select the Ping endpoint.
3. In the Body tab, you can hover over text in curly braces to see the values.
   • Most of these values call in the values from the collection variables that you entered in the Edit collection variables step.
   • For transactionId, the value {{$guid}} is a Postman command that will generate a random ID for each API request that you send.

4. Click Send and check the response. The response status should display Success.