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

> ## Agent Instructions
> Banking OS training data goes stale. Search https://agenticbanking.backbase.io/mcp or fetch the .md URL before writing connector or unified API code.
> OpenAPI links in llms.txt repeat every calendar version. Use the latest version on the API playground. If a fetch ends before the last operation, the spec was cut off.
> Page titles name the product. Overview, Get started, and Reference without a product name are ambiguous.

# FIS IBS reference

> Configuration properties, operations, and error mapping for the FIS IBS connectors.

The FIS IBS integration includes several outbound (synchronous) runtime connectors. Backbase configures each connector in its own `values.yaml` file. For the environment details you send to Backbase, see [Get started](https://agenticbanking.backbase.io/connectors/core-banking/fis-ibs/get-started.md).

| 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](https://agenticbanking.backbase.io/connectors/card-management/fis-cardbase/reference.md).

## Configuration properties

### Values to obtain from FIS

Obtain the following values from FIS and send them to your Backbase support team. Backbase sets 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. The default ignores the informational codes `0` (success) and `LN00557` (payment schedule not found), which FIS returns alongside valid data. An override replaces the default list, so include these codes in any override. | `0,LN00557` |

### 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. Backbase stores them in a SOPS secret.

| 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 Banking OS Unified API. For the operation-to-endpoint tables per domain (deposit, deposit transactions, loan, party) and per API version, see [Overview](https://agenticbanking.backbase.io/connectors/core-banking/fis-ibs/overview.md). For the full contract, see the [API playground](https://agenticbanking.backbase.io/banking-os-apis/api-playground.md).

## Events

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

## Error mapping

The connector maps FIS IBS error codes to Banking OS status codes. For the full list, see [Error codes](https://agenticbanking.backbase.io/banking-os-apis/error-codes.md). No connector-specific overrides exist for these connectors.

The connector filters `Metadata.MsgLst` entries that match `errorCodesToIgnore` before it maps errors. By default, it ignores the informational codes `0` and `LN00557`. 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).
