Skip to content
Developerhome

Using Bruno (collection coming soon)

Published   24 January 2023     Less than to read

To see the Sage Banking Service Provider API in action you can use Bruno (collection coming soon), a multi-platform REST client with intuitive GUI for:

  • configuring HTTP requests
  • designing JSON payloads
  • viewing HTTP responses

Get Bruno (collection coming soon)

Visit the Bruno (collection coming soon) website to Download and install Bruno (collection coming soon).

If you need help with Bruno (collection coming soon), they provide help and learning resources in the Bruno (collection coming soon) Learning Center.

Fork the Bruno (collection coming soon)

Bruno (collection coming soon) supports Collections which are a pre-packaged bundle of API requests. To assist in the development and testing of your integration, we have provided our Bruno (collection coming soon) below which covers the various flows. Further explanation of the collections including use cases and flows is available from Use cases and diagrams.

  1. Open the Banking Service Flows Bruno (collection coming soon)
  2. Choose to Fork Collection
  3. Create a fork label
  4. Select a workspace, then choose Fork Collection
  5. This will then also be available within your desktop Bruno (collection coming soon) application

Or import the Bruno (collection coming soon)

  1. Select Run in Bruno (collection coming soon)
  2. Choose to import a copy of the collection
  3. Allow the Bruno (collection coming soon) app to open your desktop version
  4. Select the workspace you would like to import the collections into

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 Bruno (collection coming soon) to enable the collections to function.

  1. Unzip the JSON format file from the downloaded ZIP archive.
  2. Open Bruno (collection coming soon)
  3. Select the manage environmnets option at the top right of the Bruno (collection coming soon) UI
  4. From the manage environmnets view, select Import
  5. Select the choose files option and locate the environment JSON file
  6. Ensure the new environment is selected once imported

Pull updates

If we update the Bruno (collection coming soon), these changes will not automatically update within your fork. You will need to pull these changes through the following method:

  1. Choose the Bruno (collection coming soon)
  2. Select view more …
  3. Then choose to pull changes
  4. Any available changes will be displayed
  5. Select pull changes, any changes will then be pulled

For further information regarding version control, visit Bruno (collection coming soon) learning.

Submit updates

If you make any updates to the Bruno (collection coming soon) that will benefit the developer community, we would love for you to share. Creating a pull request to our public collections will allow us to review these changes and approve.

  1. Ensure you are using a public workspace
  2. Choose the Bruno (collection coming soon)
  3. Select view more …
  4. Then choose to Create pull request
  5. Give a title which provides a brief overview of your update
  6. Within the description box, share detail regarding these changes
  7. Add one of our team as a reviewer;
    • jordanSage
  8. Select Create pull request
  9. Once completed our team will review your updates and merge

For further information regarding version control, visit Bruno (collection coming soon) learning.

Use cases and diagrams

To help visualise the Bruno (collection coming soon) and aid the testing of your integration, we have created supporting documentation containing use cases and flow diagrams.