Skip to main content
Follow the steps in Get started with connectors before proceeding. Alacriti access: An active account in the Alacriti environment. Network connectivity: Confirmed routing between the Alacriti environment and Banking OS Connectivity. For supported options, see Network connectivity. Environment details: You need the following environment details from Alacriti:

​
Prepare the connector

Backbase deploys this connector. To share connectivity details and provide the environment details, follow these steps:
  1. Share connectivity details. Share connectivity details between Banking OS and Alacriti as described in Network connectivity.
  2. Send environment details to Backbase. Send alacriti-url and alacriti-client-key to your Backbase support team.
For property names and defaults, see Reference.

​
Test your integration

To access the Payments Unified API, you must 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.
Webhook integration: Share the API key with Alacriti through a secure channel so Alacriti can call the inbound APIs.
Test the API using the Postman collection.

​
Troubleshooting

If your connector isn’t responding as expected, check these common scenarios.
Cause: The Banking OS (GC) gateway cannot establish a handshake with the Alacriti endpoint. This typically indicates an upstream service outage at Alacriti or a network routing failure.Solution: Verify the operational status of the Alacriti environment with Alacriti.
Cause: The Banking OS (GC) gateway cannot establish a handshake with the Alacriti endpoint. This typically indicates an upstream service outage at Alacriti or a network routing failure.Solution: Verify the operational status of the Alacriti environment with Alacriti.
Cause: The client_id or client_secret provided during setup is incorrect.Solution: Re-verify your credentials with the Alacriti portal and contact the GC team to update the connection.
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.