Log into Sandbox

This guide will show you how to connect to the Galileo API and send a POST request to the <a href="ref:post_ping" target="_blank">Ping</a> endpoint using cURL, Python, and the Postman API development platform. Make sure you have your Sandbox credentials before you begin (see <a href="doc:environments#sandbox-environment" target="_blank">Sandbox environment</a> in the _Environments_ guide).

Note

New API credentials are required after 30 days and must be generated by a team admin. If the incorrect details are used, your API request will fail and your company account will be locked.

After you finish the quickstart, make sure to see <a href="doc:build-a-sample-app" target="_blank">Build a Sample App</a>, where you will learn how to create a sample account, deposit funds, and send requests to a few common endpoints.

## cURL

cURL is a terminal tool that enables HTTP requests. It is installed on most computers, so setup should be minimal.

Note

To check if you have cURL, open the terminal and run the command, `curl -V`. If you have cURL, you should see a version number. If you don’t have it, you can download it here: <a href="https://curl.haxx.se/download.html" target="_blank">https://curl.haxx.se/download.html</a>.

Follow these steps to send a POST request to the <a href="ref:post_ping" target="_blank">Ping</a> endpoint using cURL:

  1. Open the terminal.

  2. Run the script below, replacing values with your credentials for:

    • `apiLogin`

    • `apiTransKey`

    • `transactionId` — This can be any random string but must be unique for each request.


Note
If you are accessing the CV or Production environment, replace the Sandbox URL and credentials with the URL and credentials that you received from your Galileo representative.
  1. Check the output. A successful ping will return `"status_code":0,"status":"Success"`.
## Python
You can also use Python to make API requests in the Sandbox environment.
### Python setup
To get started with Python:
  1. If you don't have it, you can download Python here: <a href="https://www.python.org/" target="_blank">https://www.python.org/</a>.
  2. When Python is installed, open the terminal.
  3. In the terminal, run one of the following commands to install the `requests` module:
    • **Mac OS/Linux** — `python -m pip install requests`
    • **Windows** — `py -m pip install requests`
  4. Check the output. You should see a message indicating that the module was successfully installed.
### Using Python from the terminal
Follow these steps to send a POST request to the <a href="ref:post_ping" target="_blank">Ping</a> endpoint using Python from the terminal:
  1. Open the terminal.
  2. At the prompt, run the command, `python`.
  3. At the Python prompt, run the script below, replacing values with your Sandbox credentials for:
    • `apiLogin`
    • `apiTransKey`

Note
If you are accessing the CV or Production environment, replace the Sandbox URL and credentials with the URL and credentials that you received from your Galileo representative.
  1. Check the output. A successful ping returns `ping response code=0`.
### Using a Python file
To work from a file instead of directly in the terminal:
  1. Paste the code above into a plain text file.
  2. Save the file with the extension `.py` (for example, `test-ping.py`). 
  3. Open the terminal and navigate to the directory containing your client certificate and `.py` file.
  4. Run `python test-ping.py`
  5. Check the output. A successful ping returns `ping response code=0`.
## Postman
Galileo has created a collection for the Postman API client. See <a href="doc:postman-setup" target="_blank">Postman Setup</a> for setup instructions and a tutorial for sending a POST request to the <a href="ref:post_ping" target="_blank">Ping</a> endpoint.