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

# Citi

> Connect Citi bank accounts and transactions to Stuut through the CitiConnect API.

Stuut's Citi integration connects to Citi Treasury and Trade Solutions (TTS) through the CitiConnect API. Once connected, Stuut imports your bank accounts and incoming payments into Cash App so they can be matched to open invoices.

| | |
| - | - |
| **Integration method** | CitiConnect API (prebuilt) |
| **Data cadence** | Stuut checks for new transactions every hour |
| **Authentication** | OAuth 2.0 with mutual TLS (mTLS). No online banking login is shared with Stuut. |
| **Access** | Read-only. Stuut can view accounts and transactions. It can't move money. |

## What gets synced

| Data | Details |
| - | - |
| **Bank accounts** | Name, number, type, currency, IBAN, and status (open or closed). |
| **Bank transactions** | Incoming credits: amount, date, payment method, sender, reference numbers, and SWIFT tracking ID (UETR). |

### Supported payment types

| Payment type | Description |
| - | - |
| Wire | Funds transfers and wire payments. |
| ACH | Automated Clearing House payments. |
| Check | Check deposits. |
| SEPA | Single Euro Payments Area transfers. |
| Lockbox | Lockbox deposits. |

Multi-currency accounts are supported. Stuut reads the currency directly from Citi.

## How syncing works

1. Stuut syncs your bank accounts first, so the account list is current.
2. Stuut then pulls incoming credits for every active account. Each sync looks back 7 days, so late-posting transactions aren't missed.
3. Bank-generated credits, such as interest, are filtered out because they aren't customer payments.
4. If a run is interrupted, Stuut picks it up again automatically on the next sync.

## Setup

Connecting Citi to Stuut is a project between you, your Citi relationship manager, and your Stuut onboarding team.

> [!WARNING]
>
> Your Citi relationship manager must grant you Citi Developer Portal access before technical setup can begin.

**1. Request portal access**

Ask your Citi relationship manager for Developer Portal access and for sandbox and production enablement of the Accounts V4 API. Use the sample email below.

**2. Upload certificates**

Upload the signing and encryption certificates in the Developer Portal using Citi's maker-checker process. Stuut provides the certificate to upload.

**3. Citi approval**

Citi reviews and approves the certificate setup. Your Citi representative then configures the sandbox and production API environments for your accounts.

**4. Share credentials**

Retrieve your OAuth client ID and client secret from the Developer Portal, and share them with your Stuut team through the secure method they provide. Tell your Stuut team if you want only some of your accounts to sync.

**5. Validation**

Stuut checks connectivity, account access, and transaction flow in the sandbox.

**6. Go-live**

Citi enables production access, and Stuut begins syncing automatically.

### Sample email to Citi

```text theme={null}
Subject: CitiConnect API Access Request — Integration with Stuut

Hi [Citi relationship manager],

We are working with Stuut to automate our cash application and need to set up
a CitiConnect API integration with Stuut's Citi connector.

1. Please grant Developer Portal access for [primary and secondary users].
2. Configure the API environment for both sandbox and production.
3. Enable the Accounts V4 API for these accounts: [List account numbers]
```

## FAQ

> [accordion] Can I connect multiple Citi accounts?
>
> Yes. Stuut syncs all accounts linked to your TTS profile by default. Your Stuut team can limit the sync to the accounts you choose.

> [accordion] How often does Stuut sync?
>
> Every hour.

> [accordion] Will I see outgoing payments?
>
> No. Stuut imports incoming credits only, because that's what Cash App matches to invoices.

> [accordion] Is my data secure?
>
> Yes. The connection uses mutual TLS and OAuth 2.0, and your banking login is never shared with Stuut.

## Questions?

If you have questions about your Citi integration or need help with setup, contact your Stuut team or [support@stuut.co](mailto:support@stuut.co).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.