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

# Stripe Billing & Upflow

> Connect Stripe Billing to Upflow and see how invoices, customers, and payments sync to power your AR workflows and accelerate cash collection.

## Connect Stripe Billing with Upflow

To connect Upflow with Stripe Billing, click on the Connect button after you have created a new organization.

<img src="https://mintcdn.com/upflow-04dc27cd/8J-Jf3EzWBUuWUtX/images/45487825949329.png?fit=max&auto=format&n=8J-Jf3EzWBUuWUtX&q=85&s=b08898fd18ac409c189f7a612fed4ecd" width="320" style={{ width:"30%" }} data-path="images/45487825949329.png" />

For Upflow to work properly with Stripe Billing, we need the following permissions from your Stripe account:

<img src="https://mintcdn.com/upflow-04dc27cd/8J-Jf3EzWBUuWUtX/images/45487826138769.png?fit=max&auto=format&n=8J-Jf3EzWBUuWUtX&q=85&s=65ee8ae3969e2efb498ac2b818ec75d6" width="539" style={{ width:"50%" }} data-path="images/45487826138769.png" />

<img src="https://mintcdn.com/upflow-04dc27cd/8J-Jf3EzWBUuWUtX/images/45487815432465.png?fit=max&auto=format&n=8J-Jf3EzWBUuWUtX&q=85&s=cb4688de488e43e2ae3346823308fad8" width="533" style={{ width:"51%" }} data-path="images/45487815432465.png" />

## How does the synchronization work?

Once you have given Upflow access to your Stripe data, we will run a full synchronization of it. This can take several hours, and then the data will be synced in real time.

### Contact sync

We import the customer's email address as the customer's main contact.

For additional contacts, you can rely on our feature [Import contacts from custom fields](/en-us/core-entities/contacts/import-contacts-from-custom-fields). From your Upflow Settings > Contact management, click "Add field":

<img src="https://mintcdn.com/upflow-04dc27cd/8J-Jf3EzWBUuWUtX/images/45487801329553.png?fit=max&auto=format&n=8J-Jf3EzWBUuWUtX&q=85&s=4332ee33fc650a8523e3325a5de13adb" width="640" style={{ width:"61%" }} data-path="images/45487801329553.png" />

Add the following fields:

* Additional emails cc
* Additional emails to

<img src="https://mintcdn.com/upflow-04dc27cd/8J-Jf3EzWBUuWUtX/images/45487796141073.png?fit=max&auto=format&n=8J-Jf3EzWBUuWUtX&q=85&s=dbcf28a62fe684217bf106f9bdddff67" width="320" style={{ width:"62%" }} data-path="images/45487796141073.png" />

And click **Save** at the bottom of the page. Give the system a bit of time to sync the data from Stripe and create contacts into Upflow.

Then, from your Contacts list view, follow the sync using the filter "Source contains Custom field".

You can now use these additional contacts in your collection process. Refer to our [article](/en-us/core-entities/contacts/import-contacts-from-custom-fields) for more insights.

### Invoice sync

Draft invoices are not imported into Upflow.

Voided invoices are imported with the status VOIDED.

Uncollectible invoices are imported and considered as PAID.

### Payment sync

Unapplied payments are not imported into Upflow as they don't impact the Stripe credit balance.

Payment methods are imported along with the payment.

If invoices are paid via the Upflow portal, we will write back the payment to Stripe. As the Stripe Billing API doesn't allow us to specify the payment invoice, we mark the invoice as paid out of band.

#### Payment export error

If a payment made by your customer in their Upflow portal, shows a Stripe Billing error status, you can identify them through the dedicated filter:

<img src="https://mintcdn.com/upflow-04dc27cd/VnsxTiu-TokPjvrr/images/Capture-d%E2%80%99e%CC%81cran-2026-05-15-a%CC%80-10.39.09.png?fit=max&auto=format&n=VnsxTiu-TokPjvrr&q=85&s=e670c74e5e002663eafaff959a837500" alt="Capture D’écran 2026 05 15 À 10 39 09" title="Capture D’écran 2026 05 15 À 10 39 09" style={{ width:"43%" }} width="590" height="244" data-path="images/Capture-d’écran-2026-05-15-à-10.39.09.png" />

Then, you can first check the error message by hovering over the Error status, or add the Stripe Billing Status column to the view. See here:

<img src="https://mintcdn.com/upflow-04dc27cd/VnsxTiu-TokPjvrr/images/Capture-d%E2%80%99e%CC%81cran-2026-05-15-a%CC%80-10.40.16.png?fit=max&auto=format&n=VnsxTiu-TokPjvrr&q=85&s=5132d2e05aacf1609d61ad00b52d8c11" alt="Capture D’écran 2026 05 15 À 10 40 16" title="Capture D’écran 2026 05 15 À 10 40 16" style={{ width:"28%" }} width="548" height="328" data-path="images/Capture-d’écran-2026-05-15-à-10.40.16.png" />

If the message is explicit enough, check the root cause or solution, and proceed with the necessary updates in Upflow or Stripe.

Then, try exporting the payment back to Stripe:

<img src="https://mintcdn.com/upflow-04dc27cd/VnsxTiu-TokPjvrr/images/Export-back-to-Stripe-Billing.png?fit=max&auto=format&n=VnsxTiu-TokPjvrr&q=85&s=6f2dff32eb7c85ff5f562a8f987d5ffb" alt="Export Back To Stripe Billing" title="Export Back To Stripe Billing" style={{ width:"22%" }} width="410" height="236" data-path="images/Export-back-to-Stripe-Billing.png" />

If the message is "Synchronisation failed. Please contact support.", and exporting back to Stripe fails, please contact our Support team (at the top right of this page), with as much context as possible.

### Custom field sync

You can import Stripe metadata as custom fields in Upflow.

These fields are available for customers, invoices, and payments.

Additionally, some native Stripe fields can be added from the Upflow custom field section. They are:

* Account email
* Delinquent
* Description
* Discount
* Default payment method
* Sources
* Subscriptions
* Tax location country
* Tax exempt

## Troubleshooting

### Time zone - time difference between Stripe & Upflow

If you notice a time difference between your Stripe data and Upflow, such as an invoice issue/due date, a payment synced time, etc., this might be due to a time zone difference between your Stripe instance, and Upflow organization.

Check your Stripe settings account details, or click a Transaction, and its activity times to see the Time conversation → xx - Your Account (eg, EST - Your Account).

In Upflow, head to your Settings > Company, scroll down to the time zone field and ensure it matches. If it doesn't, please contact your Support team with the time zone you'd need in Upflow.
