Postman Collection

Postman is a popular application for API development and testing. To help you get started with our API, we provide a Postman collection that you can use to make requests to our API.

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

Prerequisites

Before you can use the Postman collection, you’ll need to download and install Postman. You can download the latest version of Postman from the Postman website.

Installation

Once you have installed Postman, you can load the collection and environment with one click using the below button.

Manual installation

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

Show Load the collection

To load the collection:

1. Go to our 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 will now be 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 you to quickly switch between different instances, API keys, and merchant accounts.

To load the environment:

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

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

Environment setup

Before you can start making API calls, you need to configure the Postman environment with your API key and some other information.

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

Using the Collection

Once you have configured the environment, you can start making API calls.

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

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

Further Information

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

If you have any questions or need help with the Postman collection, please contact our support team.