Reference

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.

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.

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.

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. For the full contract, see the 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. 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).

Overview

Grand Central connectors

Release notes

Configuration properties

Values to obtain from FIS

Common properties

gc-fis-deposit-connector

gc-fis-deposit-transaction-connector

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

gc-fis-party-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​Values to obtain from FIS

​Common properties

​gc-fis-deposit-connector

​gc-fis-deposit-transaction-connector

​gc-fis-loan-connector and gc-fis-loan-transaction-connector

​gc-fis-party-connector

​SOPS secrets

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

Values to obtain from FIS

Common properties

gc-fis-deposit-connector

gc-fis-deposit-transaction-connector

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

gc-fis-party-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies