Skip to content
Developerhome
Product homepage
Banking Service

3. Integrate

  Less than to read

Banking Service Postman Collections

To see the Provider API in action and begin exploring our endpoints use our Banking Service Postman collection. Get the collection through the following steps, or learn more about using Postman.

1: Get the Postman app

Visit the Postman website to Download and install Postman.

2: Get the Postman collection

Run in Postman

Postman supports collections which are a pre-packaged bundles of API requests. To assist in the development and testing of your integration, we have provided the following Postman collection which covers Banking Service’s intergration flows.

This collection contains the following collections:

  • Onboarding
  • Re-authorisation
  • Multi-account linking
  • Retrieve Sage ID token
  • Posting transactions

You can see explanations of our collections, including use cases and flows, in API flows.

API Provider Flows

To enable a successful integration with Banking Service, it is important to understand the data flows.

There are 5 flows for providers connecting to Banking Service:

  • Onboarding (Authorisation)
  • Re-authorisation
  • Multi-account linking
  • Posting Transactions
  • Offboarding

Our API flow articles represent the steps outlined within our postman collection. Before walking through each flow ensure to have first completed the following:

Onboarding

Allow the user to authorise and select their accounts.

Re-authorisation

Expire a user's authorisation and allow them to re-enable.

Multi-account linking

Make it easy for users to onboard accounts under the same authorisation.

Posting transactions

Post user's transactions into the Banking Service.

Offboarding

Be notified when a user has chosen to offboard their account.

Implement the Connector API

To process the required webhooks provider flows, you need to implement a connector API.

Endpoints

This API is exposed through the endpoints provided in stage 2. Get set up with the following endpoints:

  • /auth – for generating UI to authenticate a customer account
  • /authrefresh – for generating UI to reauthenticate a customer
  • /notification – for receiving calls when events occur on Banking Service (or Provider API) that require the provider’s attention
  • /availableaccounts – multi-account linking is an optional feature that uses this endpoint. It’s adopted by some Sage products to let users onboard multiple accounts at 1 time.

Connector API specification

The full specification, including response codes and payloads, is in the Swagger file. Go to the API Reference section for connector API to find out more.

Building this API against the provided endpoints allows you to test the flows in the sandbox environment using the Postman collections. Download the Postman collections here.

Implement Sage ID

Sage ID is required for you to obtain access tokens which can be provided as an authorisation header within your Provider API requests.

Sandbox Base Urls

https://id-shadow.sage.com

Production Base Urls

https://id.sage.com

Implement the Provider API

Provider API is API used for pushing transactions to Banking Service.

Provider API specification

The full specification, including response codes and payloads, is in the Swagger file. Go to the API reference section for Provider API.

Sandbox Base Urls

EU https://papi-snd01-eu-west-1.sagebanking-sandbox.cloud

US https://papi-snd01-us-east-1.sagebanking-sandbox.cloud

Production Base Urls

 EU https://eu-banking.fabric.sage.com/provider

 US https://us-banking.fabric.sage.com/provider

Testing

Once your development is complete it is vital to test the integrity of your integration.

We have created a Banking Service test plan which covers the basic tests which should be completed for each of the 5 flows. We rely on you to complete further comprehensive testing on your solution to ensure the best solution for our mutual customers.

Please complete the test plan before requesting production credentials.

Integration support

Your team will be able to communicate with our engineers for support. The channels for contacting our engineers was agreed in Stage 2: Get set up.

Please get in touch with us if you have any issues during development such as:

  • Issues accessing sandbox
  • Documentation issues
  • Updates to endpoints or provider names
  • Delays to agreed go-live dates
  • Knowledge support for provider flows and API specifications

Developer Community >

What’s next?

Discover the Banking Service API flows, starting with onboarding.

Was this helpful?