> ## 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.

# Trovata

> Connect Trovata to Stuut to sync bank accounts and incoming payments from all your banks.

If your company uses Trovata to collect data from your banks, Stuut can read that data directly from Trovata. Stuut imports your bank accounts and incoming payments into Cash App so they can be matched to open invoices.

| | |
| - | - |
| **Integration method** | Trovata REST API (prebuilt) |
| **Data cadence** | Recurring automatic syncs |
| **Authentication** | Trovata API credentials (App ID, App Secret, and Company ID) |
| **Access** | Read-only. Stuut never changes or creates data in Trovata. |

## What you'll need

| Credential | Description |
| - | - |
| **App ID** | Your Trovata application ID. |
| **App Secret** | Your Trovata application secret. Treat it like a password. |
| **Company ID** | Your Trovata company ID. |

You generate these in Trovata. If you don't have access, ask your Trovata administrator or Trovata account representative for API credentials for a third-party integration.

### API permissions

Give the credentials read-only access only.

**Turn on:**

* **Accounts:** List of accounts and balances.
* **Transactions:** Transaction lookup, Search for transactions by specifying criteria, and Retrieve transaction data.
* **Payments:** read-only access.

**Leave off:**

* **Invoices:** Invoice analysis, Delete invoices, and Invoice summary.
* Anything that posts or writes back, such as Post AR/AP invoices.
* Any create or delete permissions.
* **Initiate a payment.**
* **Tags.**

## Connect Trovata in Stuut

1. In Stuut, go to **Settings > Integrations**.
2. Select **Trovata**.
3. Enter your **App ID**, **App Secret**, and **Company ID**.
4. Click **Connect**.

Stuut checks the connection with Trovata right away. If the credentials are correct, the integration shows as **Healthy**.

## What gets synced

### Bank accounts

All bank accounts in Trovata, with name, masked account number, currency, type, status, IBAN, and institution name. Closed accounts are marked inactive in Stuut.

### Bank transactions

Incoming credits only: the payments and deposits Cash App matches to invoices.

| Field | Description |
| - | - |
| Amount and currency | The payment amount and its currency. |
| Transaction date | When the transaction occurred. |
| Posted status | Whether the bank has posted the transaction yet. |
| Bank reference | The bank's reference for the transaction. |
| Customer reference | The payer's reference, often an invoice or PO number. |
| Payment method | ACH, wire, or check (lockbox). |
| Payer name | Who sent the payment. |
| Check number | For check payments. |
| Remittance details | Extra information sent with the payment. |
| SWIFT tracking ID | The end-to-end tracking reference (UETR) for wires. |

**Not synced:** outgoing payments, and bank-generated credits such as interest income, which aren't customer payments.

## How syncing works

* **Automatic.** Once connected, Stuut syncs on a recurring schedule. You don't need to do anything.
* **Incremental.** After the first sync, Stuut only pulls new or updated transactions.
* **Accounts first.** Bank accounts sync before transactions, so every transaction links to its account.

## FAQ

> [accordion] How far back does the first sync go?
>
> The first sync loads the recent transactions Trovata has. If you need older history, ask your Stuut team about a backfill.

> [accordion] Can I update my credentials later?
>
> Yes. You can update any of the three credentials from the integration settings page in Stuut.

> [accordion] What happens if my credentials are rotated?
>
> Stuut's health check flags the connection as unhealthy. Enter the new credentials in Stuut to fix it.

> [accordion] Does Stuut write anything back to Trovata?
>
> No. The integration is read-only.

## Troubleshooting

| Issue | What to do |
| - | - |
| Connection shows as unhealthy | Check that your App ID, App Secret, and Company ID are correct and haven't been rotated. |
| No transactions appear | Confirm that Trovata has bank feeds connected and that incoming transactions exist for the period. |
| Bank accounts are missing | Make sure the accounts are open in Trovata and the API credentials have access to them. |

## Questions?

If you have questions about your Trovata 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.