To see the Sage Banking Service Provider API in action you can use Postman, a multi-platform REST client with intuitive GUI for configuring HTTP requests, designing JSON payloads, and viewing HTTP responses.
A Postman Collection is available to illustrate the Sage Banking Service Provider API methods and workflow.
Step 1: Get Postman
Visit the Postman website to Download and install Postman.
Step 2: Get the Postman Collections
Postman supports Collections which are a pre-packaged bundle of API requests. To assist in the development and testing of your integration, we have provided three separate Postman collections. Further explanation of the collections including use cases and flows is available from Use cases and diagrams.
- Banking Service Consumer API Postman Collection
- Banking Service Provider API Postman Collection
- Banking Service Provider API Sage ID Postman Collection
Step 3: Import the Postman Collection
- Unzip the JSON format files from the downloaded ZIP archive.
- Open Postman
- From the main menu, select File > Import
- Drag and drop the JSON files into Postman
Step 4: Import the environment JSON received during registration
The environment JSON provided by Sage during registration, contains the details of the sandbox test environment including your client ID and secret. The environment JSON must also be imported into Postman to enable the collections to function.
- Unzip the JSON format file from the downloaded ZIP archive.
- Open Postman
- Select the manage environmnets option at the top right of the Postman UI
- From the manage environmnets view, select Import
- Select the choose files option and locate the environment JSON file
- Ensure the new environment is selected once imported
Use cases and diagrams
To help visualise the Postman collection and aid the testing of your integration, we have created supporting documentation containing use cases and flow diagrams. Use cases and diagrams.