> ## Documentation Index
> Fetch the complete documentation index at: https://grandcentral.backbase.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Reference

> Configuration properties, operations, and error mapping for the Temenos Transact connectors.

The Temenos Transact integration is delivered as six runtime connectors, each configured in its own `values.yaml` file. For setup steps, see [Get started](/connectors/core-banking/temenos-transact/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 set 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`. |

<Note>
  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. For details, see [Get started](/connectors/core-banking/temenos-transact/get-started).
</Note>

### 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 Grand Central 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 Grand Central product code for the get flow.                   | N/A                                                                   |

<Info>
  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.
</Info>

### 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.            | See sample in get-started                                                 |
| `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 Grand Central product ID to a Temenos product ID for the create flow.                    | N/A                                                                |
| `loanProduct.<TEMENOS_ID>`                      | Optional. Maps a Temenos product ID to a Grand Central 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 Grand Central 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.           | See sample in get-started                                          |
| `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 Grand Central product code to a Temenos product code.                                    | N/A                                          |

<Info>
  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.
</Info>

## Supported operations

The Temenos Transact connectors expose the Grand Central Unified API. For the operation-to-endpoint tables per domain (deposit, deposit transactions, loan, loan transactions, party, product matching), see [Overview](/connectors/core-banking/temenos-transact/overview). For the full contract, see the [unified API specifications](/connectors/reference/unified-api-specifications).

## Events

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

## Error mapping

The connectors map Temenos error codes to Grand Central status codes. For the full list, see [Error codes](/connectors/reference/error-codes).

The following table lists connector-specific error behavior.

| Grand Central 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`.
* Azure API Management (APIM) for Bearer token injection and rate limiting.
* `temenos-connector-sdk` (shared HTTP configuration and Temenos error code mapping).