Skip to content
Logo MoneyGo

Postman collection

Overview

Section titled “Overview”

This guide explains how to integrate the MoneyGo API using a Postman Collection. It is designed for developers who need to connect their applications to MoneyGo’s services—not merely for testing. By importing the collection into Postman, you can quickly explore and implement endpoints for tasks such as token retrieval, wallet management, and transaction processing.

Required Variables

Section titled “Required Variables”

When you import the Postman Collection and its associated environment file (.json), you’ll see several variables in the Manage Environments section. The following variables are mandatory and must be configured before executing any requests:

Downloads

Section titled “Downloads”

Download the required files to work with MoneyGo API in Postman:

Alternatively, you can copy these URLs and paste them directly into Postman’s import window:

  • Collection URL: /Public-Api-Prod.postman_collection.json
    URL copied to clipboard!
  • Environment URL: /Public-Api-Prod.postman_environment.json
    URL copied to clipboard!

Mandatory Environment Variables

Section titled “Mandatory Environment Variables”

  • URL Example: https://api.money-go.com The base URL for all MoneyGo API requests.

  • client_id Example: 123456 Replace with your actual (or placeholder) client ID. This value is required to obtain your access token.

  • client_secret Example: abcdef Replace with your actual (or placeholder) client secret. This is used alongside the client_id to generate or refresh tokens.

  • your_wallet Example: UABR193 Replace with your actual (or placeholder) wallet ID. This identifies your wallet in the MoneyGo system.

  • user_wallet Example: UABR173 Replace with the target user’s wallet ID. This is used when sending or receiving funds between wallets.

  • processing_tokenForm Example: 66f66b99b85f0e3... Replace with your actual (or placeholder) processing token. This special token or form parameter is needed for certain transaction requests.

  • webhook_site Example: https://webhook.site/abc123 Replace with your webhook endpoint URL. MoneyGo sends event notifications (e.g., transaction status updates) to this address.

  • amount Example: 1 Specifies the transaction amount for requests that require an amount.

All other variables in the environment file can remain unchanged, as they will be set automatically at runtime or are optional.

1. First Request: Get Token

Section titled “1. First Request: Get Token”

Before you can access most API endpoints, you must obtain an access token:

  1. Locate the “Get Token” Request: In the Postman Collection, find the request labeled Get Token or POST /token.

  2. Review the Request Parameters: Ensure the request body includes:

  • client_id as {{client_id}}
  • client_secret as {{client_secret}}

  1. Send the Request: If the request is successful, the response will include an access_token.

  2. Update Your Environment: Copy the access_token from the response and paste it into the access_token variable (in the Current Value field) in your Postman environment.

2. Running Other Requests

Section titled “2. Running Other Requests”

Once you have obtained your access_token, you can proceed with additional API requests, such as:

  • Wallet Operations: (e.g., transferring funds from your_wallet to user_wallet)

  • Transaction Processing: (e.g., using processing_tokenForm to handle payment transactions)

  • Webhook Testing: (e.g., verifying callbacks to {{webhook_site}})

Ensure that the following variables are properly set to avoid errors:

  • URL
  • client_id
  • client_secret
  • your_wallet
  • user_wallet
  • processing_tokenForm
  • webhook_site
  • amount

3. Summary

Section titled “3. Summary”
  1. Mandatory Variables: Confirm that your Postman environment is configured with the following:
  • URL
  • client_id
  • client_secret
  • your_wallet
  • user_wallet
  • processing_tokenForm
  • webhook_site
  • amount

  1. Obtain the Access Token First: Use the Get Token request with your client_id and client_secret. Then, copy the returned token into the access_token variable.

  2. Proceed with API Calls: All subsequent requests (e.g., wallet transfers, transaction processing) require a valid access_token and the corresponding environment variables.

Following these steps ensures that your Postman environment is correctly configured for using the MoneyGo API. Once you have confirmed that everything works in Postman, replicate the same logic in your application code to fully integrate MoneyGo’s services.

Happy coding!