Reference

The Jack Henry Symitar integration is delivered as several outbound (synchronous) runtime connectors that call the SymXChange API. Each connector is configured in its own values.yaml file. For setup steps, see Get started.

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

Configuration properties

Values to obtain from Jack Henry Symitar

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

Property	Description
`symxchange.baseUrl`	Target API endpoint for the SymXChange environment.

The connectors authenticate to the SymXChange API with credentials stored in a SOPS secret referenced by existingSecretName. For details, see Get started.

Common properties

Set these properties in values.yaml. They apply across all Jack Henry Symitar connectors.

Property	Description	Default
`existingSecretName`	Reference to the SOPS secret that holds the Jack Henry Symitar credentials.	`symitar`
`symxchange.basePortUrl`	Base port URL for SymXChange API requests.	`http://www.symxchange.generated.symitar.com`
`symxchange.deviceNumber`	Device number for SymXChange API requests.	`20657`
`symxchange.deviceType`	Device type identifier for SymXChange.	`BACKBASE`
`symxchange.version`	SymXChange API version.	`2022.01`
`quarkus.cxf.path`	Base path for the CXF endpoints.	`/ws`
`cxf.client.connect.timeout`	Connection timeout, in milliseconds.	`5000`
`cxf.client.receive.timeout`	Receive timeout, in milliseconds.	`10000`
`cxf.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`true` in the party connector; `false` elsewhere
`retryFlag`	Enable automatic request retries on failure.	`false`
`retryStatuses`	HTTP status codes that trigger a retry.	`429,502,503`
`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`
`coreMessageVisibility`	Whether the core system error message is surfaced to the caller.	`true`

The deposit, deposit transaction, loan, loan transaction, and party connectors also set the following thread pool properties. The payment connector doesn’t use them.

Property	Description	Default
`thread.profile.core.pool.size`	Core thread pool size.	`20`
`thread.profile.max.pool.size`	Maximum thread pool size.	`20`

gc-symitar-party-connector

The party-v0.values.yaml file holds the basic party configuration. The party-v2.values.yaml file adds account type mappings and error-code mappings, in addition to the common properties.

Property	Description	Default
`fieldsToBeReplaced`	Fields to replace for account type mapping, for example `ShareCode@Type,LoanCode@Type`.	N/A
`deposit.productTypes`	Comma-separated deposit product type categories.	N/A
`loan.productTypes`	Comma-separated loan product type categories.	N/A
`ShareCode.<Code>@Type.<Type>`	Maps a Symitar ShareCode and Type to a Grand Central product ID and secondary product ID.	N/A
`LoanCode.<Code>@Type.<Type>`	Maps a Symitar LoanCode and Type to a Grand Central product ID and secondary product ID.	N/A
`typeConversion.skipAttributes`	Comma-separated attributes to skip during type conversion.	N/A
`<CoreErrorCode>`	Maps a Symitar error code to a Grand Central error code.	N/A

gc-symitar-deposit-connector

Set these properties in deposit-v0.values.yaml, in addition to the common properties. The bundled configuration uses the single-field mapping style (shareCode, shareType, productId, secondaryProductId); the combined fieldsToBeReplaced style is also supported.

Property	Description	Default
`shareCode.<N>`	Maps a Symitar share code number to a share code name, for example `shareCode.2=CURRENT_ACCOUNT`.	N/A
`shareType.<N>`	Maps a Symitar share type number to a Grand Central account subtype, for example `shareType.1=SAVINGS_ACCOUNT`.	N/A
`productId.<Key>`	Maps a share code or type name to a Grand Central product ID.	N/A
`secondaryProductId.<Key>`	Maps an account subtype name to a Grand Central secondary product ID.	N/A
`fieldsToBeReplaced`	Optional. Fields to replace for combined account type mapping, for example `ShareCode@Type,product.productId@product.secondaryProductId`.	N/A
`ShareCode.<Code>@Type.<Type>`	Optional. Maps a Symitar ShareCode and Type to a Grand Central product ID and secondary product ID.	N/A
`product.productId.<Kind>@product.secondaryProductId.<Type>`	Optional. Maps a product ID combination.	N/A
`typeConversion.skipAttributes`	Optional. Comma-separated attributes to skip during type conversion.	N/A
`<CoreErrorCode>`	Optional. Maps a Symitar error code to a Grand Central error code.	N/A

gc-symitar-loan-connector

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

Property	Description	Default
`fieldsToBeReplaced`	Fields to replace for account type mapping, for example `LoanCode@Type,productArrangement.productId@productArrangement.secondaryProductId`.	N/A
`loan.productTypes`	Comma-separated loan product type categories.	N/A
`LoanCode.<Code>@Type.<Type>`	Maps a Symitar LoanCode and Type to a Grand Central product ID and secondary product ID.	N/A
`productArrangement.productId.<Kind>@productArrangement.secondaryProductId.<Type>`	Maps a product arrangement combination.	N/A

gc-symitar-deposit-transaction-connector and gc-symitar-loan-transaction-connector

The deposit transaction and loan transaction connectors use the common properties. They have no additional connector-specific mapping properties.

gc-symitar-payment-connector

Set these properties in payment-v0.values.yaml. The payment connector uses the common properties except the thread pool properties, and defines the following connector-specific error-code overrides.

Property	Description	Default
`<coreErrorCode>`	Maps a Jack Henry Symitar error code to a Grand Central status code, for example `13033=GC409` or `13035=GC406`.	N/A

The ShareCode, LoanCode, and product ID mapping values are environment-specific. Contact your Jack Henry Symitar administrator for the full list of account types.

Supported operations

The Jack Henry Symitar connectors expose the Grand Central Unified API. For the operation-to-endpoint tables per domain (deposit, loan, payment, party), 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 Jack Henry Symitar error codes to Grand Central status codes. For the full list, see Error codes. You can configure connector-specific overrides as core-to-Grand Central code pairs in the connector’s values.yaml; the payment connector ships with overrides for several SymXChange error codes (see gc-symitar-payment-connector).

Dependencies

Jack Henry Symitar SymXChange API (outbound), reachable at symxchange.baseUrl.
The shared symitar-connector-sdk library.

Overview

Grand Central connectors

Release notes

Configuration properties

Values to obtain from Jack Henry Symitar

Common properties

gc-symitar-party-connector

gc-symitar-deposit-connector

gc-symitar-loan-connector

gc-symitar-deposit-transaction-connector and gc-symitar-loan-transaction-connector

gc-symitar-payment-connector

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​Values to obtain from Jack Henry Symitar

​Common properties

​gc-symitar-party-connector

​gc-symitar-deposit-connector

​gc-symitar-loan-connector

​gc-symitar-deposit-transaction-connector and gc-symitar-loan-transaction-connector

​gc-symitar-payment-connector

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

Values to obtain from Jack Henry Symitar

Common properties

gc-symitar-party-connector

gc-symitar-deposit-connector

gc-symitar-loan-connector

gc-symitar-deposit-transaction-connector and gc-symitar-loan-transaction-connector

gc-symitar-payment-connector

Supported operations

Events

Error mapping

Dependencies