Download and set up Postman
Less than to read
To see the Sage Authentication Service in action you can use Postman. Postman is a multi-platform REST client with an intuitive GUI for:
- Configuring HTTP requests
- Designing JSON payloads
- Viewing HTTP responses
If you need help with Postman, they provide help and learning resources in the Postman Learning Center.
Make sure you have the ID and signing key of your Sage application before you use the Postman collection. You’ll need them to use the collection.
Step 1: Get Postman
Go to the Postman website to download and install Postman.
Step 2: Get the Postman collection and environment
Postman supports collections which are a pre-packaged bundles of API requests. To help the development and testing of your integration, we have provided the following Postman collection which covers the Sage Authentication Flow.
Select “Run in Postman” to create a fork of the collection directly into your Postman application.
Or you can download the Authentication Service API Postman Collection.
Step 3: Setting the environment JSON
The environment JSON contains the details of the sandbox test environment. The environment JSON must also be imported into Postman so the collections can function.
- Unzip the JSON format file from the downloaded ZIP archive.
- Open Postman
- Select the manage environments option at the top right of the Postman UI
- From the manage environments view, select Import
- Select the choose files option and locate the environment JSON file
- Ensure the new environment is selected once imported
Step 4: Add your application’s signing key
Edit the Postman environment to add your applications signing key. Add this to the apiKey
variable.
Step 5: Send the requests
Expand the subfolders and send the requests in the order they are listed.