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

# Reference

> Configuration properties, operations, and error mapping for the Fiserv DNA connectors.

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](/connectors/core-banking/fiserv-dna/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.                                         |

<Note>
  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](/connectors/core-banking/fiserv-dna/get-started).
</Note>

### 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](/connectors/core-banking/fiserv-dna/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`. |

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

### 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](/connectors/core-banking/fiserv-dna/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](/connectors/core-banking/fiserv-dna/overview). For the full contract, see the [unified API specifications](/connectors/reference/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](/connectors/reference/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.