| Parameter | Description |
|---|---|
temenos-base-url | The API endpoint URL for the Temenos Transact environment (for example, https://TENANT_NAME.temenos.cloud/irf-provider-container/api/v5.2.0). |
temenos-user-id | Username for Basic Authentication. |
temenos-password | Password for Basic Authentication. |
Configuration guide
Follow these steps to initialize and authorize your Temenos Transact Connector.1. Establish connectivity
Share connectivity details between Grand Central and Temenos Transact as described in Network connectivity.Network connectivity to the Temenos Transact environment must be established before proceeding with configuration.
2. Temenos Transact authentication
The Temenos Transact Connector uses Basic Authentication for API access. To configure authentication, create a Secrets Operations (SOPS) secret. For more information, see How to create SOPS.To share credentials between Temenos Transact and Grand Central, consider using 1Password.
3. Environment configuration
To initialize the Temenos Transact Connector, define the required environment variables in yourgc-applications-live repository.
These variables are stored in values.yaml for configuration common to all connectors, and in the following files for connector-specific configuration:
| Connector | Property | Description |
|---|---|---|
gc-temenos-party-connector | party-v0.values.yaml | Outbound party connector for party management operations |
Define common parameters
These variables are stored invalues.yaml and are used across all Temenos Transact outbound connectors:
| Parameter | Description | Example value |
|---|---|---|
temenos.base.url | Target API endpoint for the Temenos Transact environment. | https://TENANT_NAME.temenos.cloud/irf-provider-container/api/v5.2.0 |
http.client.connect.timeout | Timeout in milliseconds for establishing a connection. | 5000 |
http.client.request.timeout | Timeout in milliseconds for the complete request. | 10000 |
http.client.socket.timeout | Timeout in milliseconds for socket operations. | 5000 |
http.client.connection.max.per.route | Maximum number of connections per route. | 200 |
http.client.connection.max.total | Maximum total number of connections. | 200 |
http.client.proxy.activate | Enable or disable HTTP proxy. | false |
values.yaml configuration:
Define party connector parameters
For the party connector, configure the specific parameters inparty-v0.values.yaml:
HTTP client configuration is inherited from the common parameters defined in
values.yaml.Testing the connector
After configuration, test the connector using the API key authentication:| Header | Value |
|---|---|
api-key | <your_subscription_key> |
For more information about the Grand Central Unified API endpoints that support these features, see Temenos Transact 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 Grand Central gateway cannot establish a handshake with the Temenos Transact endpoint. This typically indicates an upstream service outage at Temenos or a network routing failure.Solution: Verify the operational status of the Temenos Transact environment with Temenos. If the service is operational, contact Grand Central Support.
5XX: Timeout from core / Read timeout / SocketTimeoutException
5XX: Timeout from core / Read timeout / SocketTimeoutException
Cause: The request to Temenos Transact exceeded the configured timeout period. This may indicate performance issues at Temenos or network latency problems.Solution: Verify the operational status of the Temenos Transact environment and check for any performance degradation. If the service is operational and performing normally, consider increasing the timeout values (
connectTimeout, soTimeout, responseTimeout) in your configuration. Contact Grand Central Support if issues persist.Network connectivity issues
Network connectivity issues
Cause: Network connectivity to the Temenos Transact environment has not been established or has been interrupted.Solution: Verify network connectivity and ensure routing is properly configured between Grand Central and Temenos Transact. Review the Network connectivity documentation for configuration details.
401: Invalid authentication credentials
401: Invalid authentication credentials
Cause: The
temenos-user-id or temenos-password provided during setup is incorrect, expired, or the user lacks the required permissions in Temenos Transact.Solution: Re-verify your credentials with your Temenos administrator and ensure the user has the required permissions. Contact the Grand Central team to update the connection credentials if needed.429: Rate limit exceeded
429: Rate limit exceeded
Cause: The number of incoming requests exceeded the defined threshold for your subscription tier. This “429 Too Many Requests” response protects the stability of the Grand Central and Temenos Transact infrastructure.Solution: Review your app’s request patterns to identify unexpected spikes. If you need higher throughput, contact the Grand Central team to request an adjustment to your API management rate limit policy.
Connection pool exhausted
Connection pool exhausted
Cause: The maximum number of connections (
maxTotalConnections or connectionsPerRoute) has been reached, and no connections are available for new requests.Solution: Review your connection pool configuration and consider increasing maxTotalConnections or connectionsPerRoute values. Ensure your application is properly closing connections after use.Need more help?
Contact support
Reach out to the Grand Central team for assistance with environment setup, rate limit increases, or configuration guidance.