Reference

The Fiserv DNA 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-fiservdna-deposit-connector`	`deposit-v0.values.yaml`	Deposit account operations
`gc-fiservdna-deposit-transaction-connector`	`deposit-transaction-v0.values.yaml`	Deposit transaction operations
`gc-fiservdna-loan-connector`	`loan-v0.values.yaml`	Loan account operations
`gc-fiservdna-loan-transaction-connector`	`loan-transaction-v0.values.yaml`	Loan transaction operations
`gc-fiservdna-party-connector`	`party-v0.values.yaml`	Party management operations
`gc-fiservdna-party-access-entitlement-connector`	`party-access-entitlement-v0.values.yaml`	Party access entitlement operations
`gc-fiservdna-payment-connector`	`payment-v0.values.yaml`	Payment operations

Configuration properties

Values to obtain from Fiserv DNA

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

Property	Description
`fiservdna.baseUrl`	Target API endpoint for the Fiserv DNA environment (the CoreApiService SOAP endpoint).
`fiservdna.host`	Hostname for Fiserv DNA services.
`fiservdna.appId`	Application identifier for core API requests.
`fiservdna.networkNodeName`	Network node identifier for core API requests.

The connectors use SingleSignOn authentication. Each connector obtains an SSOTicket through DirectSignOn, validates it through WhoIs, and reuses the resulting token until it expires. Store the certificate and credentials in a SOPS secret. For details, see Get started.

Common properties

Set these properties in values.yaml. They apply across all Fiserv DNA connectors.

Property	Description	Default
`cxf.client.ssl.ca.cert.path`	Path to the SSL CA certificate for the SOAP client.	`/etc/camel/conf.d/_secrets/fiservdna-ca-cert-secret/tls.crt`
`cxf.client.connect.timeout`	SOAP client connect timeout, in milliseconds.	`5000`
`cxf.client.receive.timeout`	SOAP client receive timeout, in milliseconds.	`10000`
`cxf.client.proxy.activate`	Route outbound calls through the corporate HTTP proxy.	`false`
`cxf.loggingFeatureEnabled`	Enable CXF request and response logging.	`true` in the deposit connector; `false` elsewhere
`coreMessageVisibility`	Whether the core system error message is surfaced to the caller.	`true`
`retryFlag`	Enable automatic request retries on connection 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`
`typeConversion.skipAttributes`	Comma-separated list of attributes to skip during type conversion. See the sample in Get started.	N/A
`partyNameDelimiter`	Optional. Delimiter between first and last name for party name search.	Space (`" "`)
`fieldsToBeReplaced`	Optional. Comma-separated fields for account type mapping, for example `MajorAccountType,MinorAccountType`.	N/A
`deposit.productTypes`	Optional. Comma-separated deposit product type categories.	N/A
`loan.productTypes`	Optional. Comma-separated loan product type categories.	N/A
`fiserv.accountRoleCodes`	Optional. Comma-separated account role codes. Ships active in the deposit connector as `TAX,OTAX,OWN,SIGN`.	N/A

The following account type mapping patterns map Fiserv DNA account types to Grand Central product IDs. Configure them under values.yaml per your Fiserv DNA product configuration.

Pattern	Description
`MajorAccountTypeCode.<Major>`	Single-field mapping for the major account type.
`MinorAccountTypeCode.<Minor>`	Single-field mapping for the minor account type.
`MajorAccountTypeCode.<Major>@MinorAccountTypeCode.<Minor>`	Combined mapping for both major and minor types.
`namespaceURI.MajorAccountType`, `namespaceURI.MinorAccountType`	Namespace URIs for the major and minor account types in SOAP messages.
`mappingField.MajorAccountType`, `mappingField.MinorAccountType`	Mapping field names for the account types. Default to `MajorAccountTypeCode` and `MinorAccountTypeCode`.
`fieldsToBeReplaced`	Fields to remap, for example `MajorAccountType,MinorAccountType` or `MajorAccountType@MinorAccountType`.

The account type mapping values are environment-specific. Contact your Fiserv DNA administrator to obtain the full list of MajorAccountTypeCode and MinorAccountTypeCode values.

gc-fiservdna-deposit-connector and gc-fiservdna-loan-connector

Set this property in deposit-v0.values.yaml and loan-v0.values.yaml.

Property	Description	Default
`fiserv.bankOrgNumber`	Optional. Bank organization number.	N/A

gc-fiservdna-deposit-transaction-connector and gc-fiservdna-loan-transaction-connector

Set these properties in deposit-transaction-v0.values.yaml and loan-transaction-v0.values.yaml to map core transaction types to Grand Central transaction types.

Property	Description	Default
`fieldsToBeReplaced`	Optional. Set to `type` to enable transaction type mapping.	N/A
`type.<CoreTransactionType>`	Optional. Maps a Fiserv DNA transaction type to a Grand Central transaction type.	N/A
`thread.profile.core.pool.size`	Core thread pool size.	`20`
`thread.profile.max.pool.size`	Maximum thread pool size.	`20`

gc-fiservdna-party-connector

Set these properties in party-v0.values.yaml. They configure the getAccountsByPartyId operation.

Property	Description	Default
`deposit.productTypes`	Optional. Comma-separated deposit product type categories.	N/A
`loan.productTypes`	Optional. Comma-separated loan product type categories.	N/A
`fiserv.accountRoleCodes`	Optional. Comma-separated account role codes.	N/A
`fiservdna.cashBoxNumber`	Optional. Cash box number used when resolving party accounts.	N/A (environment-specific)

gc-fiservdna-party-access-entitlement-connector

The party access entitlement connector uses the common properties. It has no additional connector-specific properties.

gc-fiservdna-payment-connector

Set these properties in payment-v0.values.yaml.

Property	Description	Default
`fiservdna.cashBoxNumber`	Cash box number for payment operations.	N/A (environment-specific)
`<GC_PAYMENT_TYPE>`	Maps a Grand Central payment type (the `paymentInstructionReference.usedMechanism` value) to a Fiserv DNA payment type code, for example `LOAN_PAYMENT=11` or `INTERNAL_TRANSFER=4`.	N/A

SOPS secrets

The connectors use SingleSignOn authentication (DirectSignOn and WhoIs). Obtain the following credentials from Fiserv DNA and store them, together with the SOAP client certificate, in a SOPS secret. For details, see Get started.

Credential	Description
`device-id`	Device identifier for DirectSignOn authentication.
`user-id`	Username for DirectSignOn authentication.
`password`	Password for DirectSignOn authentication.

Supported operations

The Fiserv DNA connectors expose the Grand Central Unified API. For the operation-to-endpoint tables per domain (deposit, loan, payment, party, party access entitlement), 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 connectors map Fiserv DNA error codes to Grand Central status codes. The following connector-specific overrides ship in the source configuration:

Connector	Core error code	Grand Central status code
`gc-fiservdna-party-connector`	`2291`	`GC025`
`gc-fiservdna-payment-connector`	`2291`, `6502`	`GC025`
`gc-fiservdna-payment-connector`	`100`, `100001`	`GC401`
`gc-fiservdna-payment-connector`	`99999`	`GC409`

For the full list of Grand Central status codes, see Error codes.

Dependencies

Fiserv DNA CoreApiService SOAP API (outbound), reachable at fiservdna.baseUrl.
Fiserv DNA SingleSignOn services (DirectSignOn and WhoIs) for token acquisition.
The shared fiservdna-connector-sdk library.

Overview

Grand Central connectors

Release notes

Configuration properties

Values to obtain from Fiserv DNA

Common properties

gc-fiservdna-deposit-connector and gc-fiservdna-loan-connector

gc-fiservdna-deposit-transaction-connector and gc-fiservdna-loan-transaction-connector

gc-fiservdna-party-connector

gc-fiservdna-party-access-entitlement-connector

gc-fiservdna-payment-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies

​Configuration properties

​Values to obtain from Fiserv DNA

​Common properties

​gc-fiservdna-deposit-connector and gc-fiservdna-loan-connector

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

​gc-fiservdna-party-connector

​gc-fiservdna-party-access-entitlement-connector

​gc-fiservdna-payment-connector

​SOPS secrets

​Supported operations

​Events

​Error mapping

​Dependencies

Configuration properties

Values to obtain from Fiserv DNA

Common properties

gc-fiservdna-deposit-connector and gc-fiservdna-loan-connector

gc-fiservdna-deposit-transaction-connector and gc-fiservdna-loan-transaction-connector

gc-fiservdna-party-connector

gc-fiservdna-party-access-entitlement-connector

gc-fiservdna-payment-connector

SOPS secrets

Supported operations

Events

Error mapping

Dependencies