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 Jack Henry Symitar as described in Network connectivity.
-
Send environment details to Backbase.
Send
symxchange.baseUrl,symxchange.deviceNumber,symxchange.deviceType, andsymxchange.versionto your Backbase support team.
Testing your integration
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.
For more information about the Banking OS Unified API endpoints that support these features, see Jack Henry Symitar Connector Overview.
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 Jack Henry Symitar endpoint. This typically indicates an upstream service outage at Jack Henry Symitar or a network routing failure.Solution: Verify the operational status of the Jack Henry Symitar environment. Check the Jack Henry status page or contact Jack Henry support.
5XX: Timeout from core / Read timeout / SocketTimeoutException
5XX: Timeout from core / Read timeout / SocketTimeoutException
Cause: The request to Jack Henry Symitar exceeded the configured timeout period. This may indicate performance issues at Jack Henry Symitar or network latency problems.Solution: Verify the operational status of the Jack Henry Symitar environment and check for any performance degradation.
401: Invalid authentication
401: Invalid authentication
Cause: The authentication credentials provided during setup are incorrect, expired, or the user lacks the required permissions in Jack Henry Symitar.Solution: Re-verify your credentials with your Jack Henry Symitar administrator and ensure the user has the required permissions. Contact your Backbase support team to update the connection credentials if needed.
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 Jack Henry Symitar 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.