Reference

The Temenos Transact integration includes six runtime connectors. Backbase configures each connector in its own values.yaml file. For the environment details you send to Backbase, see Get started.

Connector	Property file	Purpose
`gc-temenos-party-connector`	`party-v0.values.yaml`	Party management operations
`gc-temenos-deposit-connector`	`deposit-v0.values.yaml`	Deposit account operations
`gc-temenos-deposit-transaction-connector`	`deposit-transaction-v0.values.yaml`	Deposit transaction operations
`gc-temenos-loan-connector`	`loan-v0.values.yaml`	Loan account operations
`gc-temenos-loan-transaction-connector`	`loan-transaction-v0.values.yaml`	Loan transaction operations
`gc-temenos-product-matching-connector`	`product-matching-v0.values.yaml`	Deposit maturity simulation

Configuration properties

Values to obtain from Temenos

Obtain the following value from Temenos and send it to your Backbase support team. Backbase sets it in values.yaml. This value is environment-specific, so it has no default.

Property	Description
`temenos.base.url`	Base URL of the Temenos Transact environment, for example `https://TENANT_NAME.temenos.cloud/irf-provider-container/api`.

The connectors use Bearer token authentication injected at the Azure API Management (APIM) layer through a shared policy fragment, so no per-connector SOPS secret is required. Backbase configures that fragment.

Common properties

Set these properties in values.yaml. They apply across all Temenos Transact connectors.

Property	Description	Default
`corporate.sectorId`	Sector ID that identifies a corporate or organisation party in Temenos.	`2001`
`customers.api.version`	API version for the Temenos party (customers) API.	`v5.2.0`
`holdings.api.version`	API version for the Temenos holdings API.	`v1.0.0`

The HTTP client properties in the following sections tune the outbound connection pool and timeouts. All Temenos connectors accept the same set; the defaults differ per connector as noted.

gc-temenos-party-connector

Set these properties in party-v0.values.yaml.

Property	Description	Default
`http.client.connect.timeout`	Connection timeout in milliseconds.	`5000`
`http.client.request.timeout`	Request timeout in milliseconds.	`10000`
`http.client.socket.timeout`	Socket timeout in milliseconds.	`5000`
`http.client.connection.max.per.route`	Maximum connections per route.	`200`
`http.client.connection.max.total`	Maximum total connections.	`200`
`http.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`false`
`temenos.api.online-services.path`	Temenos onlineServices endpoint used by search party (deposit account branch) to resolve the bound party.	`/v2.0.0/holdings/onlineServices`
`regex.party-id.pattern`	Validation pattern for party identifiers.	`^[a-zA-Z0-9]{1,10}$`
`regex.party-id.failure-message`	Message returned when party ID validation fails.	Party ID must be alphanumeric and between 1 and 10 characters long.
`regex.deposit-id.pattern`	Validation pattern for deposit identifiers.	`^[a-zA-Z0-9]{1,20}$`
`regex.deposit-id.failure-message`	Message returned when deposit ID validation fails.	Deposit ID must be alphanumeric and between 1 and 20 characters long.

gc-temenos-deposit-connector

Set these properties in deposit-v0.values.yaml.

Property	Description	Default
`http.client.connect.timeout`	Connection timeout in milliseconds.	`5000`
`http.client.request.timeout`	Request timeout in milliseconds.	`10000`
`http.client.socket.timeout`	Socket timeout in milliseconds.	`5000`
`http.client.connection.max.per.route`	Maximum connections per route.	`200`
`http.client.connection.max.total`	Maximum total connections.	`200`
`http.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`false`
`temenos.api.accounts.path`	Temenos accounts API path.	`/v5.1.0/holdings/accounts`
`temenos.api.deposits.path`	Temenos deposits API path.	`/v3.0.0/holdings/deposits`
`temenos.api.online-services.path`	Temenos onlineServices API path.	`/v2.0.0/holdings/onlineServices`
`temenos.api.party-customers.path`	Temenos party customers API path.	`/v5.2.0/party/customers`
`temenos.api.redeem-deposits.path`	Temenos redeem deposits API path.	`/v3.0.0/holdings/deposits/redeemDeposits`
`temenos.api.account-closures.path`	Temenos account closures API path.	`/v5.1.0/holdings/accounts/currentAccounts`
`temenos.api.product-lookup.path`	Temenos product lookup API path.	`/v1.0.0/product/products`
`temenos.api.create-deposit.path`	Temenos create deposit API path.	`/v5.1.0/holdings/accounts`
`temenos.api.create-term-deposit.path`	Temenos create term deposit API path.	`/v3.0.0/holdings/deposits/termDeposits`
`product.line.term-deposit`	Product line identifier that routes create and close requests to the term deposit endpoints.	`DEPOSITS`
`regex.deposit-id.pattern`	Validation pattern for deposit identifiers.	`^[a-zA-Z0-9]{1,20}$`
`regex.deposit-id.failure-message`	Message returned when deposit ID validation fails.	Deposit ID must be alphanumeric and between 1 and 20 characters long.
`fieldsToBeReplaced`	Optional. Comma-separated fields for product ID mapping. Commented by default; uncomment per environment.	N/A
`product.secondaryProductId.<GC_CODE>`	Optional. Maps a Banking OS product code to a Temenos product code for the create flow.	N/A
`ArrangementProperties.body.arrangementActivity.productId.<TEMENOS_CODE>`	Optional. Maps a Temenos product code to a Banking OS product code for the get flow.	N/A

The product.line.term-deposit value determines how the connector routes a create deposit request. When the product’s Temenos product line matches this value, the connector calls the term deposit endpoint (/holdings/deposits/termDeposits); other product types go to /holdings/accounts. The same routing applies to the close deposit operation.

gc-temenos-deposit-transaction-connector

Set these properties in deposit-transaction-v0.values.yaml.

Property	Description	Default
`http.client.connect.timeout`	Connection timeout in milliseconds.	`5000`
`http.client.request.timeout`	Request timeout in milliseconds.	`10000`
`http.client.socket.timeout`	Socket timeout in milliseconds.	`5000`
`http.client.response.timeout`	Response timeout in milliseconds.	`10000`
`http.client.connection.max.per.route`	Maximum connections per route.	`100`
`http.client.connection.max.total`	Maximum total connections.	`200`
`http.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`false`
`holdings.api.version`	Temenos holdings API version for transactions.	`v2.1.0`
`holdings.transactions.path`	Temenos transactions path (appended to the holdings API version).	`/holdings/transactions`
`contentType`	Content type for outbound requests.	`application/json`
`accept`	Accept header for outbound requests.	`application/json`
`gc-http-caller-handleExceptionsInConnector`	Whether the connector handles HTTP caller exceptions.	`false`
`retryFlag`	Enable automatic request retries on failure.	`false`
`retryStatuses`	HTTP status codes that trigger a retry.	`429,500,502,503,504`
`thread.profile.core.pool.size`	Core thread pool size.	`20`
`thread.profile.max.pool.size`	Maximum thread pool size.	`40`
`acceptedHeaders`	Comma-separated list of headers the connector forwards.	Environment-specific. Backbase sets this value.
`regex.deposit-id.pattern`	Validation pattern for deposit identifiers.	`^[A-Za-z0-9]{1,20}$`
`regex.deposit-id.failure-message`	Message returned when deposit ID validation fails.	Deposit ID must be alphanumeric and between 1 and 20 characters long.
`regex.transaction-id.pattern`	Validation pattern for transaction identifiers.	`^[A-Za-z0-9.-]{1,50}$`
`regex.transaction-id.failure-message`	Message returned when transaction ID validation fails.	Transaction ID must be alphanumeric and between 1 and 50 characters long.
`default.page.size`	Default page size for transaction results.	`20`
`default.max.pages`	Maximum number of pages the connector retrieves.	`100`
`default.from-date.lookback-years`	Default lookback window, in years, when no start date is supplied.	`1`

gc-temenos-loan-connector

Set these properties in loan-v0.values.yaml.

Property	Description	Default
`http.client.connect.timeout`	Connection timeout in milliseconds.	`5000`
`http.client.request.timeout`	Request timeout in milliseconds.	`10000`
`http.client.socket.timeout`	Socket timeout in milliseconds.	`5000`
`http.client.connection.max.per.route`	Maximum connections per route.	`200`
`http.client.connection.max.total`	Maximum total connections.	`200`
`http.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`false`
`temenos.api.create-loan.path`	Temenos create loan API path.	`/v6.4.0/holdings/loans`
`temenos.api.amortization-schedule.path`	Temenos amortization schedule API path.	`/v4.3.0/holdings/arrangements`
`temenos.api.loan-balances.path`	Temenos loan balance lookup path (uses the `?arrangementId={loanId}` query parameter).	`/v6.4.0/holdings/loans/balances`
`temenos.api.arrangement-balances.path`	Temenos arrangement balances path (`{loanId}` is replaced at runtime).	`/v4.3.0/holdings/arrangements/{loanId}/balances`
`temenos.api.arrangement-total-due-amount.path`	Temenos total due amount path (`{loanId}` is replaced at runtime).	`/v4.3.0/holdings/arrangements/{loanId}/totalDueAmount`
`regex.loan-id.pattern`	Validation pattern for loan identifiers.	`^[a-zA-Z0-9]{1,20}$`
`regex.loan-id.failure-message`	Message returned when loan ID validation fails.	Loan ID must be alphanumeric and between 1 and 20 characters long.
`fieldsToBeReplaced`	Optional. Comma-separated fields for product ID mapping. Commented by default; uncomment per environment.	N/A
`productArrangement.secondaryProductId.<GC_ID>`	Optional. Maps a Banking OS product ID to a Temenos product ID for the create flow.	N/A
`loanProduct.<TEMENOS_ID>`	Optional. Maps a Temenos product ID to a Banking OS product ID for the get flow.	N/A

gc-temenos-loan-transaction-connector

Set these properties in loan-transaction-v0.values.yaml. The connector reads settled bills from the Temenos arrangement bills enquiry and maps them to the Banking OS loan transaction contract.

Property	Description	Default
`http.client.connect.timeout`	Connection timeout in milliseconds.	`5000`
`http.client.request.timeout`	Request timeout in milliseconds.	`30000`
`http.client.response.timeout`	Response timeout in milliseconds.	`30000`
`http.client.socket.timeout`	Socket timeout in milliseconds.	`5000`
`http.client.connection.max.per.route`	Maximum connections per route.	`150`
`http.client.connection.max.total`	Maximum total connections.	`300`
`http.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`false`
`arrangements.api.version`	Temenos arrangements API version.	`v4.3.0`
`arrangements.path`	Temenos arrangements path.	`/holdings/arrangements`
`arrangements.bills.suffix`	Suffix appended to the arrangements path for the bills enquiry.	`/bills`
`temenos.bills.amount-strip-chars`	Characters stripped from amount fields before numeric conversion.	`,`
`temenos.bills.amount-fields`	Comma-separated amount fields to normalize.	`billedAmount,outstandingAmount`
`contentType`	Content type for outbound requests.	`application/json`
`accept`	Accept header for outbound requests.	`application/json`
`gc-http-caller-handleExceptionsInConnector`	Whether the connector handles HTTP caller exceptions.	`false`
`retryFlag`	Enable automatic request retries on failure.	`false`
`retryStatuses`	HTTP status codes that trigger a retry.	`429,500,502,503,504`
`errorTemplate`	JOLT template used to transform Temenos error details.	`temenos-transform-error-details.json`
`coreMessageVisibility`	Whether the core system error message is surfaced to the caller.	`true`
`thread.profile.core.pool.size`	Core thread pool size.	`50`
`thread.profile.max.pool.size`	Maximum thread pool size.	`100`
`acceptedHeaders`	Comma-separated list of headers the connector forwards.	Environment-specific. Backbase sets this value.
`regex.loan-id.pattern`	Validation pattern for loan identifiers.	`^[A-Za-z0-9]{1,20}$`
`regex.loan-id.failure-message`	Message returned when loan ID validation fails.	Loan ID must be alphanumeric and between 1 and 20 characters long.
`default.page.size`	Default page size for transaction results.	`20`
`default.max.pages`	Maximum number of pages the connector retrieves.	`100`
`default.currency`	Default currency applied when the source record omits one.	`USD`

gc-temenos-product-matching-connector

Set these properties in product-matching-v0.values.yaml.

Property	Description	Default
`http.client.connect.timeout`	Connection timeout in milliseconds.	`10000`
`http.client.request.timeout`	Request timeout in milliseconds.	`90000`
`http.client.response.timeout`	Response timeout in milliseconds.	`90000`
`http.client.socket.timeout`	Socket timeout in milliseconds.	`90000`
`http.client.connection.max.per.route`	Maximum connections per route.	`100`
`http.client.connection.max.total`	Maximum total connections.	`200`
`http.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`false`
`temenos.api.deposit-simulation.path`	Temenos deposit simulation API path.	`/v9.0.0/holdings/deposits/simulations`
`temenos.api.simulation-schedule.path`	Temenos simulation schedule API path.	`/v10.0.0/holdings/arrangements/simulations`
`fieldsToBeReplaced`	Optional. Comma-separated fields for product ID mapping. Commented by default; uncomment per environment.	N/A
`product.secondaryProductId.<GC_CODE>`	Optional. Maps a Banking OS product code to a Temenos product code.	N/A

The Temenos deposit simulation runs a full synchronous arrangement lifecycle and routinely takes more than 10 seconds. Set the request, response, and socket timeouts to 90 seconds (as shown) to avoid premature timeouts. Keep the connect timeout short.

Supported operations

The Temenos Transact connectors expose the Banking OS Unified API. For the operation-to-endpoint tables per domain (deposit, deposit transactions, loan, loan transactions, party, product matching), see Overview. For the full contract, see the API playground.

Events

These connectors are synchronous and do not publish or consume events.

Error mapping

The connectors map Temenos error codes to Banking OS status codes. For the full list, see Error codes. The following table lists connector-specific error behavior.

Banking OS code	HTTP status	When it occurs
`GC301`	`404`	The Temenos arrangement bills enquiry returns `TGVCP-007` for the loan. The connector cannot distinguish between a missing loan and a loan with no settled bills, so both surface as `GC301`.
`GC023`	`501`	`GET /loans/transactions/{transactionId}` is called. Temenos does not expose single-bill lookup, so the connector returns `501`. Use `GET /loans/{loanId}/transactions` or `POST /loans/transactions` instead.

Dependencies

Temenos Transact REST API (outbound), reachable at temenos.base.url.
APIM for Bearer token injection and rate limiting.
temenos-connector-sdk (shared HTTP configuration and Temenos error code mapping).

Get started

Core banking

Payments

Card management

KYC and KYB

Open Banking

CRM

Fraud detection

Financial data aggregation

Configuration properties

Values to obtain from Temenos

Common properties

gc-temenos-party-connector

gc-temenos-deposit-connector

gc-temenos-deposit-transaction-connector

gc-temenos-loan-connector

gc-temenos-loan-transaction-connector

gc-temenos-product-matching-connector

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​Values to obtain from Temenos

​Common properties

​gc-temenos-party-connector

​gc-temenos-deposit-connector

​gc-temenos-deposit-transaction-connector

​gc-temenos-loan-connector

​gc-temenos-loan-transaction-connector

​gc-temenos-product-matching-connector

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

Values to obtain from Temenos

Common properties

gc-temenos-party-connector

gc-temenos-deposit-connector

gc-temenos-deposit-transaction-connector

gc-temenos-loan-connector

gc-temenos-loan-transaction-connector

gc-temenos-product-matching-connector

Supported operations

Events

Error mapping

Dependencies