Postman Collection

Postman is a popular app for API development and testing. To help developers get started with the API, Gr4vy provides a Postman collection that can be used to make requests to the API.

This guide walks through how to install Postman, load the custom collection and environment, and start making API calls.

Prerequisites

Before using the Postman collection, download, and install Postman. The latest version of Postman is available from the Postman website.

Installation

Once Postman is installed, the collection and environment can be loaded with one click using the button below.

Manual installation

Although the most convenient way, this collection is only updated occasionally. An auto-updated collection can be manually installed but requires manually updating to the latest version.

Show Load the collection

To load the collection:

1. Go to the Postman GitHub repository.
2. Download the Gr4vy.postman_collection.json file.
3. Open Postman.
4. In the Import dialog, select File and upload the downloaded file.
5. Drag the file into the import modal.

The Postman collection is now available in the Collections tab on the left side of the Postman window.

Show Load the environment

The Postman environment is a set of variables that are used in the Postman collection. These variables allow for quickly switching between different instances, API keys, and merchant accounts.

To load the environment:

1. Go to the Postman GitHub repository.
2. Download the Gr4vy.postman_environment.json file.
3. In Postman, click the Import button.
4. In the Import dialog, select File and upload the downloaded file.
5. Click Import.

The Postman environment is now available in the Environments tab in the top right corner of the Postman window.

Environment setup

Before making API calls, configure the Postman environment with an API key and additional information.

1. In the top right corner of the Postman window, select the Gr4vy environment from the dropdown menu.
2. Click the Environment quick look icon (the eye icon) to the right of the environment dropdown.
3. In the Environment tab, a list of variables is displayed. Set the following variables:
   • baseUrl - Set this to the production or sandbox URL.
   • privateKey - Set this to the RSA private key to use
   • thumbprint - The thumbprint, or key ID, for the private key. This is visible in the dashboard.
   • scopes - A list of API scopes to use for each request.
   • embed - Any additional embed parameters to add.
   • merchantAccountId - The merchant account ID on the instance.

Using the collection

Once the environment is configured, API calls can be made.

1. In the top right corner of the Postman window, select the Gr4vy environment from the dropdown menu.
2. In the Collections tab on the left side of the Postman window, expand the Gr4vy API collection.
3. A list of API endpoints, organized into folders, is displayed.
4. Select an API endpoint to call.
5. The request details are displayed in the main Postman window.
6. Click the Send button to make the API call.

The API response is displayed in the Response section at the bottom of the Postman window.

Further Information

For more information on the Gr4vy API, refer to the API Reference.

For questions or help with the Postman collection, contact the support team.