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
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:
- Have gone through our getting setup process.
- Obtained a Sandbox postman environment, provided by Sage.
- Get the Banking Service postman collection .
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
What’s next?
Discover the Banking Service API flows, starting with onboarding.