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 OBPM as described in Network connectivity.
- Send environment details to Backbase. Send the OBPM, Azure Blob Storage, and SFTP details for your environment to your Backbase support team.
Testing your integration
To use the Payments Unified API, you must include your Banking OS subscription key in the request header. If you do not have a key, contact your Backbase support team to have one provisioned.Inbound Status Testing: For testing the inbound connector, after configuring the SFTP component as mentioned in the prerequisites, you can automatically get the status message in the Sync Hub service bus.
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 (GC) gateway cannot establish a handshake with the OBPM endpoint. This typically indicates an upstream service outage at Oracle or a network routing failure.Solution: Verify the operational status of the OBPM environment with Oracle.
5XX: Timeout from core / Read timeout / SocketTimeoutException
5XX: Timeout from core / Read timeout / SocketTimeoutException
Cause: The Banking OS (GC) gateway cannot establish a handshake with the OBPM endpoint. This typically indicates an upstream service outage at Oracle or a network routing failure.Solution: Verify the operational status of the OBPM environment with Oracle.
Invalid OAuth token
Invalid OAuth token
Cause: The
client_id or client_secret provided during setup is incorrect.Solution: Re-verify your credentials with the Oracle portal and contact the GC team to update the connection.429: Rate limit exceeded
429: Rate limit exceeded
Cause: The number of incoming requests has exceeded the defined threshold for your subscription tier. This “429 Too Many Requests” response is a protective measure to ensure the stability of the Banking OS and Core Banking infrastructure.Solution: Review your application’s request patterns to identify unexpected spikes. If your business requirements have evolved and you require a higher throughput, contact your Backbase support team to request an adjustment to your Azure API Management (APIM) rate limit policy.