Skip to main content

Clients: How to connect Stripe and import unpaid invoices

This guide shows you how to connect your Stripe account to Debitura and import unpaid invoices to create debt collection cases. Connect with one click via Stripe's OAuth consent screen - no API key required.

Goal

Connect your Stripe account to Debitura and import unpaid invoices so you can convert them into debt collection cases.

Prerequisites

  • A Debitura client account (see Getting started with Debitura if you need to create one)

  • Access to your Stripe account, to authorize Debitura via Stripe's consent screen

  • Unpaid invoices in your Stripe account that you want to collect

  • The Admin role in your Debitura company. Other users can see connections and view invoices, but only admins can connect, reconnect or remove an integration.

You can see our video tutorial below:
​

New Stripe connections use Connect with Stripe only. If the video shows a form for pasting a restricted API key, skip that part - that form is no longer offered.

Steps

Step 1: Connect with Stripe

  1. Go to Integrations in your Debitura account, or install directly from the Stripe App Marketplace listing.

  2. Select Stripe and click Connect with Stripe.

  3. You're redirected to Stripe's consent screen, where you authorize Debitura's read-only access to your invoices, customers, and subscriptions. Debitura never sees your Stripe login.

  4. You're returned to Debitura with the integration active immediately - no waiting period, and the unpaid invoice list is available right away.

Step 2: Open your unpaid invoices

  1. Go to Settings > Integrations and click View invoices on your Stripe connection. You can also choose Add case > System integration, which opens the Unpaid invoices page.

  2. The Unpaid invoices page lists your open (unpaid) Stripe invoices grouped by debtor, and you can also view them invoice by invoice. Search and filters update the counts shown for Ready to review, Missing details, Not due yet and Sent to Debitura.

  3. Wait until the list has finished loading. Rows shown while invoices are still loading are provisional, and you cannot review or start them yet. To work with what has loaded so far, click Stop and use loaded invoices. A stopped or limited list can leave out other invoices from your Stripe account - the page tells you when invoices may be missing.

Step 3: Verify the imported data

Before creating cases, verify that the imported data is correct:

  • Customer information: Check that debtor names, email addresses, and postal addresses are complete. Stripe customer data maps automatically to debtor fields in Debitura.

  • Invoice amounts: Confirm that amounts match your Stripe invoices. Debitura converts amounts from Stripe's cent-based format automatically.

  • Currency: Verify that the currency is correct for each invoice.

  • Due dates: Check that invoice due dates are accurate, as debt age affects pricing.

If debtor details are missing or wrong, you can correct supported debtor details - such as name, address, debtor type, email and phone - on the Unpaid invoices page before you start. Corrections apply to that Stripe customer's invoices and are not written back to Stripe. Corrections you have not yet submitted last only for this visit: refreshing the page discards them. Once you start a case, the corrections you made are kept for that case. Amounts and currency cannot be edited here.

Step 4: Create collection cases from imported invoices

  1. Select the invoices you want to send to collection. Selecting a debtor can select several invoices at once.

  2. Start collection on the selected invoices. Each invoice becomes a separate case in Debitura, linked to the original Stripe invoice for reference - invoices for the same debtor are never combined into one claim.

Ready to review does not mean collection is already allowed. When you start, Debitura checks current collection coverage, your applicable minimum claim amount, required agreements and division access, and reads the invoice from Stripe again. An invoice can still be refused at this point, for example if its balance, currency or customer changed in Stripe. Each invoice gets its own result, and a refused invoice does not stop other eligible invoices from starting.

If an invoice shows Not confirmed, do not start it again. Check the result of that same request first, and contact support if it stays unclear.

Result

The Stripe invoices you started are now collection cases. You can view your cases in the Cases list. Each case follows the standard case lifecycle, starting with verification before being assigned to a collection partner.

Notes

Duplicate prevention

Debitura uses Stripe invoice IDs to prevent duplicate case creation. If you import the same invoice twice, Debitura will not create a duplicate case.

Supported invoice types

The integration imports both one-time invoices and subscription-generated invoices from Stripe.

Troubleshooting

  • Existing restricted-key connections: Existing restricted-key connections continue to work. To connect a new Stripe account, use Connect with Stripe. If an existing connection needs authorization again, reconnect the same Stripe account through OAuth; the integration history is preserved.

  • Missing customer data: An invoice whose Stripe customer has an incomplete address is still listed, but it cannot start until the debtor details are complete. Debitura requires at minimum a name and postal address. Correct the details on the Unpaid invoices page before you start, or update the customer in Stripe and refresh the list.

If your integration stops syncing or you encounter other errors, see Accounting integration not syncing for common fixes.

Did this answer your question?