> ## 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 FIS IBS connectors.

The FIS IBS integration is delivered as several outbound (synchronous) runtime connectors, each configured in its own `values.yaml` file. For setup steps, see [Get started](/connectors/core-banking/fis-ibs/get-started).

| Connector                              | Property file                                  | Purpose                        |
| :------------------------------------- | :--------------------------------------------- | :----------------------------- |
| `gc-fis-deposit-connector`             | `deposit-v0.values.yaml`                       | Deposit account operations     |
| `gc-fis-deposit-transaction-connector` | `deposit-transactions-v0.values.yaml`          | Deposit transaction operations |
| `gc-fis-loan-connector`                | `loan-v0.values.yaml`                          | Loan account operations        |
| `gc-fis-loan-transaction-connector`    | `loan-transactions-v0.values.yaml`             | Loan transaction operations    |
| `gc-fis-party-connector`               | `party-v0.values.yaml`, `party-v2.values.yaml` | Party management operations    |

FIS also provides a card issuing connector (`gc-fis-device-administration-connector`) that shares the `fis-connector-sdk`. It's documented separately under card management. For details, see the [FIS Cardbase Connector reference](/connectors/card-management/fis-cardbase/reference).

## Configuration properties

### Values to obtain from FIS

Obtain the following values from FIS and set them in `values.yaml`. These values are environment-specific, so they have no default.

| Property              | Description                                      |
| :-------------------- | :----------------------------------------------- |
| `fis.baseUrl`         | Target API endpoint for the FIS IBS environment. |
| `fis.organization-id` | Organization identifier in FIS.                  |
| `fis.source-id`       | Source identifier for API requests.              |

### Common properties

Set these properties in `values.yaml`. They apply across all FIS IBS connectors.

| Property                                       | Description                                                                                                        | Default                            |
| :--------------------------------------------- | :----------------------------------------------------------------------------------------------------------------- | :--------------------------------- |
| `fis.security-token-type`                      | Security token type for authentication.                                                                            | `OAuth2`                           |
| `enableValidation`                             | Enable input validation for operations.                                                                            | `false`                            |
| `client.ssl.ca.cert.path`                      | Path to the SSL CA certificate for secure connections.                                                             | N/A (environment-specific)         |
| `http.client.oauth2.token-url`                 | OAuth2 token endpoint URL for FIS authentication.                                                                  | N/A (environment-specific)         |
| `http.client.oauth2.grant-type`                | OAuth2 grant type for authentication.                                                                              | `client_credentials`               |
| `http.client.oauth2.client.assertion.required` | Whether client assertion is required for OAuth2.                                                                   | `false`                            |
| `http.client.connect.timeout`                  | HTTP connect timeout in milliseconds.                                                                              | `5000`                             |
| `http.client.request.timeout`                  | HTTP request timeout in milliseconds.                                                                              | `10000`                            |
| `http.client.socket.timeout`                   | HTTP socket timeout in milliseconds.                                                                               | `5000`                             |
| `http.client.connection.max.per.route`         | Maximum HTTP connections per route.                                                                                | `200`                              |
| `http.client.connection.max.total`             | Maximum total HTTP connections.                                                                                    | `200`                              |
| `redelivery.backOffMultiplier`                 | Backoff multiplier for redelivery attempts.                                                                        | `2`                                |
| `redelivery.delay`                             | Initial delay between redelivery attempts, in milliseconds.                                                        | `200`                              |
| `redelivery.maximumRetries`                    | Maximum number of redelivery attempts.                                                                             | `3`                                |
| `thread.profile.core.pool.size`                | Core thread pool size.                                                                                             | `10`                               |
| `thread.profile.max.pool.size`                 | Maximum thread pool size.                                                                                          | `20`                               |
| `retryFlag`                                    | Enable automatic request retries on connection failure.                                                            | `false`                            |
| `errorTemplate`                                | Transformation template used to map core error responses.                                                          | `transform-fis-error-details.json` |
| `errorCodesToIgnore`                           | Comma-separated FIS `Metadata.MsgLst` codes to treat as non-errors. Optional; omit to keep default error handling. | Not set                            |

### gc-fis-deposit-connector

Set these properties in `deposit-v0.values.yaml`, in addition to the common properties.

| Property                     | Description                                                                                                              | Default        |
| :--------------------------- | :----------------------------------------------------------------------------------------------------------------------- | :------------- |
| `trimPartyId`                | Trim leading and trailing whitespace from party ID values.                                                               | `false`        |
| `isEncryptionRequired`       | Enable encryption of sensitive request data (path and query parameters, and the `ibs-authorization` header) sent to FIS. | `true`         |
| `coreMessageVisibility`      | Log the full request and response payload for troubleshooting.                                                           | `true`         |
| `normalizeNumericContainers` | Comma-separated list of JSON containers whose numeric fields are normalized, for example `customFields`.                 | `customFields` |

### gc-fis-deposit-transaction-connector

Set these properties in `deposit-transactions-v0.values.yaml`, in addition to the common properties.

| Property               | Description                                                    | Default |
| :--------------------- | :------------------------------------------------------------- | :------ |
| `isIntradayEnabled`    | Enable intraday transaction processing. Set to `N` to disable. | `N`     |
| `isEncryptionRequired` | Enable encryption of sensitive request data sent to FIS.       | `true`  |

### gc-fis-loan-connector and gc-fis-loan-transaction-connector

Both connectors use the common properties, and `coreMessageVisibility` and `normalizeNumericContainers` as described for the deposit connector. Neither connector sets `isEncryptionRequired`; encryption follows the `fis-connector-sdk` default of `true`.

### gc-fis-party-connector

Set these properties in `party-v0.values.yaml` and `party-v2.values.yaml`, in addition to the common properties. The properties apply to both party versions.

| Property                     | Description                                                                                              | Default        |
| :--------------------------- | :------------------------------------------------------------------------------------------------------- | :------------- |
| `trimPartyId`                | Trim leading and trailing whitespace from party ID values.                                               | `true`         |
| `isEncryptionRequired`       | Enable encryption of sensitive request data sent to FIS.                                                 | `true`         |
| `coreMessageVisibility`      | Log the full request and response payload for troubleshooting.                                           | `true`         |
| `normalizeNumericContainers` | Comma-separated list of JSON containers whose numeric fields are normalized, for example `customFields`. | `customFields` |

## SOPS secrets

The connectors authenticate to FIS with OAuth2 and a custom `ibs-authorization` header. Obtain the following credentials from FIS and store them in a SOPS secret. For details, see [Get started](/connectors/core-banking/fis-ibs/get-started).

| Credential          | Description                                       |
| :------------------ | :------------------------------------------------ |
| `fis-client-id`     | Client ID for OAuth2 token generation.            |
| `fis-client-secret` | Client secret for OAuth2 token generation.        |
| `ibs-authorization` | IBS authorization details (RACF ID and password). |

## Supported operations

The FIS IBS connectors expose the Grand Central Unified API. For the operation-to-endpoint tables per domain (deposit, deposit transactions, loan, party) and per API version, see [Overview](/connectors/core-banking/fis-ibs/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 connector maps FIS IBS error codes to Grand Central status codes. For the full list, see [Error codes](/connectors/reference/error-codes). No connector-specific overrides exist for these connectors.

When you set `errorCodesToIgnore`, the connector filters matching `Metadata.MsgLst` entries before it maps errors. Filtering is per entry: if a response includes both an ignorable code and a real error, only the real error is reported. If every non-blank `MsgLst` entry is ignorable, the connector leaves the response body unchanged and the call succeeds. Fault envelope errors always fail, regardless of `errorCodesToIgnore`.

## Dependencies

* FIS IBS REST API (outbound), reachable at `fis.baseUrl`.
* FIS OAuth2 token endpoint (outbound), reachable at `http.client.oauth2.token-url`.
* `fis-connector-sdk` (shared HTTP configuration, request encryption, and FIS error code mapping).
