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

# Overview

> Connect to Finastra Fusion Essence core banking through Grand Central

export const VendorApiVersionTag = ({versions, label = "Supports"}) => {
  useEffect(() => {
    if (!versions || versions.length === 0) {
      return undefined;
    }
    const findAndSegmentStart = (reference, target) => {
      let i = 0;
      while (i < reference.length && i < target.length && reference[i] === target[i]) {
        i += 1;
      }
      let start = i;
      while (start > 0 && (/[0-9.vR]/).test(target[start - 1])) {
        start -= 1;
      }
      return start;
    };
    const formatText = () => {
      const suffix = " operations";
      if (versions.length === 1) {
        return `${label} ${versions[0]}${suffix}`;
      }
      const [first, ...rest] = versions;
      const last = rest[rest.length - 1];
      const andStart = findAndSegmentStart(first, last);
      const lead = first.slice(0, andStart);
      if (versions.length === 2) {
        return `${label} ${first} and ${last.slice(andStart)}${suffix}`;
      }
      const stems = versions.map(version => version.slice(andStart));
      return `${label} ${lead}${stems.slice(0, -1).join(", ")}, and ${stems[stems.length - 1]}${suffix}`;
    };
    const text = formatText();
    const mountCallout = () => {
      const title = document.querySelector("#page-title");
      const header = title?.closest("header") ?? document.querySelector("#header");
      if (!title || !header || !header.contains(title)) {
        return null;
      }
      let titleBlock = title;
      while (titleBlock.parentElement && titleBlock.parentElement !== header) {
        titleBlock = titleBlock.parentElement;
      }
      let callout = header.querySelector("[data-vendor-api-version-callout='true']");
      if (!callout) {
        callout = document.createElement("div");
        callout.dataset.vendorApiVersionCallout = "true";
        callout.className = "vendor-api-version-callout";
        titleBlock.insertAdjacentElement("afterend", callout);
      }
      callout.replaceChildren();
      const textEl = document.createElement("span");
      textEl.className = "vendor-api-version-text";
      textEl.textContent = text;
      callout.appendChild(textEl);
      return callout;
    };
    let callout = mountCallout();
    if (callout) {
      return () => {
        callout?.remove();
      };
    }
    const observer = new MutationObserver(() => {
      callout = mountCallout();
      if (callout) {
        observer.disconnect();
      }
    });
    observer.observe(document.body, {
      childList: true,
      subtree: true
    });
    return () => {
      observer.disconnect();
      callout?.remove();
    };
  }, [versions, label]);
  return null;
};

export const vendorApiVersions = ["Customer Onboarding v1.1.5", "Account Information v1.1.0", "Current & Savings Account Onboarding v1.1.4", "Term Deposit Onboarding v1.2.9"];

<VendorApiVersionTag versions={vendorApiVersions} />

The Finastra Essence connector family provides pre-built connectivity with [Finastra Fusion Essence](https://www.finastra.com/products/fusion-essence) through [FusionFabric.cloud](https://developer.fusionfabric.cloud/) (FFDC) retail banking APIs. It integrates with party management, deposit accounts, and deposit account balances.

## Supported use cases

<CardGroup cols={2}>
  <Card title="Party management" icon="users">
    Search and retrieve parties, create personal customers, and list accounts by party
  </Card>

  <Card title="Deposit accounts" icon="piggy-bank">
    Create current accounts and savings accounts, retrieve deposit details by ID, and fetch balances for one or more deposit IDs
  </Card>

  <Card title="Account origination" icon="file-circle-plus">
    Create parties and deposit accounts when write journeys are enabled
  </Card>
</CardGroup>

## Connector artifacts

The following table lists the connector artifacts in this family.

| Connector artifact                          | Values file (typical)                | Scope                                                   |
| :------------------------------------------ | :----------------------------------- | :------------------------------------------------------ |
| `gc-finastra-party-connector`               | `party-v2.values.yaml`               | Party unified API operations                            |
| `gc-finastra-deposit-connector`             | `deposit-v0.values.yaml`             | `createDeposit`, `getDepositById`, `getDepositBalances` |
| `gc-finastra-deposit-transaction-connector` | `deposit-transaction-v0.values.yaml` | Deposit transaction operations                          |

## Supported operations

The Finastra Essence connector family supports the following operations from the Grand Central Unified API specification. Vendor calls use `finastra.base.url` plus the path properties in [Reference](/connectors/core-banking/finastra-essence/reference).

### Party

The following table lists the party operations.

| **Operation**            | **Endpoint**                            |
| :----------------------- | :-------------------------------------- |
| Get party details        | `GET /parties/{partyId}`                |
| Search party             | `GET /parties/search?{search criteria}` |
| Create party             | `POST /parties`                         |
| Get accounts by party ID | `GET /parties/{partyId}/accounts`       |

<Note>
  For account-list calls, the connector sends the Grand Central `partyId` to Finastra as the `customerId`, so treat the two identifiers as the same value when you troubleshoot `404` responses. The connector also maps the Grand Central `partyType` (`PERSON` or `ORGANISATION`) to the matching Essence party type code.
</Note>

### Deposit account

The following table lists the deposit account operations.

| **Operation**                | **Endpoint**                                     |
| :--------------------------- | :----------------------------------------------- |
| Create a deposit account     | `POST /deposits`                                 |
| Get deposit account details  | `GET /deposits/{depositId}`                      |
| Get deposit account balances | `GET /deposits/balances?depositIds={depositIds}` |

The connector handles each deposit operation as follows:

* **Create a deposit account** creates current accounts and savings accounts. The `finastra.casa.deposit-types` property in `deposit-v0.values.yaml` lists the Grand Central deposit types that the connector routes to Finastra. The default values are `CURRENT_ACCOUNT` and `SAVINGS_ACCOUNT`. The connector returns HTTP `400` for any other deposit type, and rejects a `holderType` of `ORGANISATION` in the create deposit request. This operation doesn't create term deposits.
* **Get deposit account details** looks up the deposit as a current or savings account first, then enriches the result with account details. When that probe returns vendor code `40311807`, the connector retrieves the deposit as a fixed deposit. Other vendor errors on that probe follow the connector error path and do not fall through to a fixed deposit. The connector includes a balance for current and savings deposits when the balance lookup succeeds. Fixed-deposit lookups omit that enrichment.
* **Get deposit account balances** retrieves a balance for each ID in the `depositIds` request header.

<Note>
  Deposit transactions come from the `gc-finastra-deposit-transaction-connector` artifact, not `gc-finastra-deposit-connector`. That artifact serves `GET /deposits/{depositId}/transactions`. Loan operations are outside the scope of this documentation set, although `GET /parties/{partyId}/accounts` can return loan accounts alongside deposit accounts.
</Note>

## API features

<CardGroup cols={2}>
  <Card title="FFDC integration">
    OAuth2 client credentials and subscription key access to FusionFabric.cloud retail banking APIs
  </Card>

  <Card title="Data mapping">
    JOLT transformations between the Grand Central Unified API and Finastra payloads
  </Card>

  <Card title="Parallel processing">
    Concurrent vendor calls for party account aggregation
  </Card>

  <Card title="Correlation">
    `X-Request-ID` on outbound calls for traceability
  </Card>
</CardGroup>

## Related topics

* [Reference](/connectors/core-banking/finastra-essence/reference) for configuration properties and vendor error mapping.
* [Get started](/connectors/core-banking/finastra-essence/get-started) for OAuth setup and values files.
* [Error codes](/connectors/reference/error-codes) for the full list of Grand Central error codes and their descriptions.