> For the complete documentation index, see [llms.txt](https://help.digits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.digits.com/business-connections/stripe.md).

# Digits Connections: Stripe

Connect Stripe to Digits to sync online payments automatically and cut down on manual work in your books.

***

### Sync Overview

The following diagram shows what data syncs between Stripe and Digits and the direction of each sync.

<div align="left"><figure><img src="https://757481048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP19jknnpoCfbiUsJMprZ%2Fuploads%2FeXKcOhamhEjhvuZ6DMgI%2Fstripe-sync-overview.png?alt=media" alt="Diagram of the Stripe data that syncs one way into Digits, partially syncs, or doesn&#x27;t sync" width="563"><figcaption></figcaption></figure></div>

Digits books your Stripe invoices on an accrual basis: a finalized invoice creates a receivable, and payments, including partial payments, clear it. Digits uses each invoice's line items and product details to categorize revenue, and records taxes, discounts, refunds, fees, and customer credits separately.

If a fee or transaction type isn’t synced, you can manually add it in **Ledger** → **New Transaction.**

***

### Before You Start

Before connecting Stripe to Digits:

* Make sure you have **Admin** access to your Stripe account, or have someone with the appropriate permissions complete the connection.

***

### How to Connect Stripe

To connect your Stripe account to Digits:

1. From the left navigation menu, click **Connections**
2. Click the **Revenue** tab.
3. Find **Stripe** and click **Connect**.
4. Log in to your **Stripe account** (or have someone with access log in) and approve the permissions. Digits requests read-only access.

{% hint style="info" %}
**Note:** If you use Stripe for more than one business or account, double-check you’re connecting the **right Stripe account** before you approve access.
{% endhint %}

***

### Upgrade an Existing Stripe Connection

If you connected Stripe before the new connection was released (Oct 2026), your account keeps syncing as before until you upgrade. Upgrading adds billing data, such as invoices, customers, products, and credit notes, to the sync.

Digits prompts you to upgrade in your Checklist. Go to **Setup**, open the **Stripe** item, and click **Upgrade connection** on the **Connection Upgrade Available** card.

<div align="left"><figure><img src="https://757481048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP19jknnpoCfbiUsJMprZ%2Fuploads%2FmSw58JXQE3Ksx7w3cGB0%2Fsetup-upgrade-fake-customer.png?alt=media&amp;token=44485e5e-c79f-41af-800e-115e2c2a6ea4" alt="" width="563"><figcaption></figcaption></figure></div>

You can also upgrade from Connections:

1. From the left navigation menu, click **Connections**.
2. Find the Stripe connection and click **Upgrade**.
3. Log in to your Stripe account and approve the permissions.

The original connection stops syncing when you upgrade, and the new connection picks up from that point. The original connection then shows as **Upgraded**.

{% hint style="info" %}
**Note:** Activity before the upgrade stays as the original connection booked it. Invoices from before the upgrade aren't added as receivables.
{% endhint %}

***

### What Happens After Connection

Once connected, :sparkles: Digits will automatically:

* Import your full Stripe transaction history.
* Start analyzing and posting those transactions into your books.
* Automatically categorize transactions and assign customers or other parties.
* Begin a frequent sync to keep Stripe data in Digits up to date. Stripe data syncs about every three hours.

{% hint style="info" %}
**Note:** The first import may take a while if you have a long Stripe history or a high volume of payments.
{% endhint %}

***

### Frequently Asked Questions

<details>

<summary>Why don’t I see all invoices from Stripe in Digits?</summary>

Digits syncs finalized invoices only. Draft invoices and $0 invoices aren't synced.

If you connected Stripe before the new Stripe connection was released, upgrade it to start syncing invoices. See [Upgrade an Existing Stripe Connection](#upgrade-an-existing-stripe-connection).

</details>

<details>

<summary>How do I know if my Stripe connection needs an upgrade?</summary>

Digits adds a **Stripe** item to your Checklist under **Setup**, with a **Connection Upgrade Available** card. Click **Upgrade connection** to switch to the new connection. If you dismiss the prompt, you can still upgrade anytime from **Connections**.

</details>

<details>

<summary>What happens when an invoice is paid outside of Stripe?</summary>

If the payment is recorded on the invoice in Stripe, Digits clears the receivable to Invoice Clearing. That amount is cleared when the matching bank deposit syncs. Refunds of credit notes issued outside of Stripe work the same way.

If the payment isn't recorded in Stripe, the invoice stays open in Digits.

</details>

<details>

<summary>How does Digits categorize Stripe revenue?</summary>

Digits uses the line items and product details on each Stripe invoice to categorize revenue, learning your patterns for each product. Taxes, discounts, and shipping are recorded on their own lines. Stripe fees are recorded separately, so revenue is recorded at the full amount.

If a transaction is categorized differently from what you expected, update it in the Digits Ledger.

</details>

<details>

<summary>What happens when a Stripe payment fails or an invoice is voided?</summary>

* **Failed charge** (for example, a returned ACH payment): Digits reverses the payment, so the invoice is owed again, and records the failure fee.
* **Voided invoice or credit note**: Digits reverses the original entry as of the void date.
* **Uncollectible invoice**: Digits writes off the unpaid balance to Bad Debt.
* **Payment reversal**: Digits records it as a refund, but the invoice isn't reopened. Review the invoice and adjust it in the Ledger if needed.

</details>

<details>

<summary>Does Digits sync Stripe Capital loan withholdings?</summary>

Yes. Digits records the Stripe Capital advance as a liability and reduces that liability as Stripe withholds paydowns from your sales.

If your Stripe connection hasn't been upgraded, Capital paydowns aren't synced. Export the Capital transactions from Stripe as a CSV, import them into Digits, and categorize them to the appropriate liability account.

See: [Importing Transactions](https://help.digits.com/business-agentic-general-ledger/importing-transactions.md)

</details>

<details>

<summary>What data syncs between Digits and Stripe?</summary>

<table data-search="false"><thead><tr><th width="157">Data Element</th><th width="106" align="center">Synced?</th><th>Direction</th><th>Notes</th></tr></thead><tbody><tr><td>Customers</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Customer records, synced as parties</td></tr><tr><td>Products &#x26; Prices</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Synced to the Digits product catalog</td></tr><tr><td>Invoices</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Open, paid, voided, and uncollectible invoices, including line items, discounts, sales tax, and shipping. Recorded as receivables (A/R).</td></tr><tr><td>Invoice Payments</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Payments made in Stripe, including partial payments, clear the invoice's receivable</td></tr><tr><td>Credit Notes &#x26; Credit Note Refunds</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Credit notes and refunds issued against invoices</td></tr><tr><td>Customer Credit Balances</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Overpayments and credits applied to invoices</td></tr><tr><td>Charges</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Recorded as gross revenue and categorized using invoice line items and product details</td></tr><tr><td>Failed Charges</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Failed payments, such as returned ACH payments, are reversed and the invoice is owed again. The failure fee is recorded too.</td></tr><tr><td>Voided Invoices &#x26; Credit Notes</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>The original entry is reversed as of the void date</td></tr><tr><td>Stripe Fees</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Processing fees, currency conversion fees, and tax on Stripe fees, recorded separately from revenue</td></tr><tr><td>Refunds &#x26; Disputes</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Includes failed refunds, dispute fees, and dispute reversals</td></tr><tr><td>Payouts</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Payouts to your bank, including reversed and canceled payouts</td></tr><tr><td>Top-ups &#x26; Transfers</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Includes reversals and Stripe Connect transfers</td></tr><tr><td>Application Fees</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Platform earnings and their refunds</td></tr><tr><td>Stripe Capital</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>The advance is recorded as a liability, and paydowns reduce it</td></tr><tr><td>Stripe Issuing</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Card transactions</td></tr><tr><td>Reserves</td><td align="center">Yes</td><td>One-Way Stripe → Digits</td><td>Funds Stripe holds in reserve and later releases</td></tr><tr><td>Invoices Paid Outside Stripe</td><td align="center">Partial</td><td>One-Way Stripe → Digits</td><td>If the payment is recorded in Stripe, it clears to Invoice Clearing until the matching bank deposit syncs</td></tr><tr><td>Payment Reversals</td><td align="center">Partial</td><td>One-Way Stripe → Digits</td><td>Recorded as a refund. The invoice isn't reopened.</td></tr><tr><td>Draft Invoices</td><td align="center">No</td><td>—</td><td>Only finalized invoices sync</td></tr><tr><td>$0 Invoices</td><td align="center">No</td><td>—</td><td>Invoices with no amount due aren't synced</td></tr><tr><td>Issuing Authorization Holds</td><td align="center">No</td><td>—</td><td>Only completed card transactions sync</td></tr><tr><td>Connect Reserved Funds</td><td align="center">No</td><td>—</td><td>Funds Stripe reserves for connected accounts aren't synced</td></tr></tbody></table>

</details>

***

{% columns %}
{% column width="66.66666666666666%" valign="middle" %}
Got a question or feedback? Our team is all ears—come say hello!
{% endcolumn %}

{% column width="33.33333333333334%" valign="middle" %}

<p align="center"><a href="https://portal.usepylon.com/digits/forms/get-in-touch-with-digits-support" class="button primary" data-icon="envelope-open-text">Contact Digits Support</a></p>
{% endcolumn %}
{% endcolumns %}

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.digits.com/business-connections/stripe.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
