instamoney docs

Postman Instruction

Postman is a HTTP client for testing web services which makes it easy to test APIs by providing a simple interface for making API requests & viewing responses. To make integrating with our API's easier, we've created a Postman collection of our APIs for easy testing.

To use our APIs, you'll need a free Instamoney Dashboard account. To follow this guide, be sure to have Postman installed.

Import Collection

  1. Download API-Instamoney.postman_collection.json and save it to your computer.
  2. In postman, click the Import button in the upper left.
  3. Select the API-Instamoney.postman_collection.json collection that was just saved.
  4. The Collections tab should now show the Instamoney collection!

Create Authorization Header

The Instamoney Collection is built to take advantage of Postman Environments, which allows for easy switching between Development and Live keys. To use Environments, you'll first need to convert your Instamoney Secret Key to a Base64-encoded Authorization header. Postman provides an easy way to do this:

  1. In Instamoney Dashboard, navigate to Settings > API Keys
  2. Under Development Keys > Secret Key, click 'Copy Key'
  3. In Postman, make a new tab and choose any collection you would like to try (choose Create Disbursement for example)
  4. Click the Authorization tab
  5. Choose Basic Auth from the Type dropdown
  6. Paste your Secret Key into the Username
  7. Click Preview Request
  8. This authorization key will be automatically be on your header tab

Creating Environment

  1. In Postman on the upper right, click the gear icon > Manage Environments.
  2. Click the Add button to create a new environment.
  3. Give it a name like Instamoney Testing
  4. Add Authorization and api-instamoney headers (see table below)
  5. Click the Add button to save
  6. In the upper right, select your new Instamoney Testing environment.
key value

Your Authorization header



If you can query your balance successfully, you've got it all set up! See our implementation docs for more testing on:


Still have more questions? We're always happy to help however we can. Shoot us an email or chat to us in live chat.