Reference

The Fiserv DNA 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.

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 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
`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. Backbase stores the certificate and credentials in a SOPS secret.

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.	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 Banking OS 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 Banking OS 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 Banking OS 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 Banking OS 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. Backbase stores them, together with the SOAP client certificate, in a SOPS secret.

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 Banking OS 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 API playground.

Events

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

Error mapping

The connectors map Fiserv DNA error codes to Banking OS status codes. The following connector-specific overrides ship in the source configuration:

Connector	Core error code	Banking OS 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 Banking OS 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.

Get started

Core banking

Payments

Card management

KYC and KYB

Open Banking

CRM

Fraud detection

Financial data aggregation

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