Prepare the connector
Backbase deploys this connector. To share connectivity details and provide the environment details, follow these steps:- Share connectivity details. Share connectivity details between Banking OS and FIS IBS as described in Network connectivity.
-
Send environment details to Backbase.
Send
fis.baseUrl,fis-client-id,fis-client-secret,fis.organization-id,fis.source-id, andibs-authorizationto your Backbase support team.
Testing the connector
To use the Unified API, include your Banking OS subscription key in the request header. If you don’t have a key, contact your Backbase support team to request one.
Test the API using the Postman collection.
Troubleshooting
If your connector isn’t responding as expected, check these common scenarios.5XX: Internal server error / Core system is down
5XX: Internal server error / Core system is down
Cause: The Banking OS gateway cannot establish a handshake with the FIS IBS endpoint. This typically indicates an upstream service outage at FIS or a network routing failure.Solution: Verify the operational status of the FIS IBS environment with FIS.
5XX: Timeout from core / Read timeout / SocketTimeoutException
5XX: Timeout from core / Read timeout / SocketTimeoutException
Cause: The request to FIS IBS times out before receiving a response. This may indicate high latency or an unresponsive endpoint.Solution: Verify the operational status of the FIS IBS environment.
Invalid OAuth token
Invalid OAuth token
Cause: The
client-id or client-secret provided during setup is incorrect.Solution: Verify your credentials with FIS and contact your Backbase support team to update the connection.429: Rate limit exceeded
429: Rate limit exceeded
Cause: The number of incoming requests exceeds the defined threshold for your subscription tier. This “429 Too Many Requests” response protects the stability of the Banking OS and FIS IBS infrastructure.Solution: Review your app’s request patterns to identify unexpected spikes. If you need higher throughput, contact your Backbase support team to request a higher rate limit.