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 (or to create a restricted API key only if using the deprecated advanced connection method)

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

You can see our video tutorial below:

Steps

Step 1: Connect with Stripe (OAuth, recommended)

  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.

Advanced: connect with a restricted API key (deprecated)

The restricted-key form remains available for creditors who connected before OAuth existed, or who prefer not to use the consent flow. It is not the default path and is labelled deprecated in Debitura.

  1. Log in to your Stripe Dashboard.

  2. Navigate to Developers then API keys.

  3. Click Create restricted key to create a new API key with limited permissions.

  4. Grant read-only permissions to Invoices and Customers.

  5. Copy the API key. Restricted keys start with rk_.

  6. In Debitura, open the Stripe setup modal, expand Advanced - use a restricted key (deprecated), and paste the key. Click Save - Debitura validates the key's permissions and, if any are missing, displays specific errors listing what's needed.

Step 2: Import unpaid invoices

  1. Select Stripe as the integration source.

  2. Set a date range to filter which invoices to import. Debitura filters invoices by creation date only (due date filtering is not available for Stripe).

  3. Click Fetch invoices to retrieve your unpaid invoices from Stripe.

  4. Review the list of imported invoices. Debitura only imports invoices with an open (unpaid) status in Stripe.

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 customer address information is missing in Stripe, you will need to add it before creating a case.

Step 4: Create collection cases from imported invoices

  1. Select the invoices you want to convert into collection cases.

  2. Click Create cases to submit them for debt collection.

  3. Each imported invoice becomes a separate case in Debitura, linked to the original Stripe invoice for reference.

Result

Your Stripe invoices are now imported into Debitura and submitted as 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

Pagination and total counts

Stripe does not provide a total count of unpaid invoices. When browsing imported invoices, you will see Next and Previous navigation instead of page numbers. Progress indicators like "Showing 20 of 150 results" are not available due to this Stripe API limitation.

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

  • Missing permissions on restricted key: If you are using a restricted API key (rk_) under the Advanced connection method, ensure it has read access to both Invoices and Customers. The setup modal displays specific permission errors - review the listed missing permissions and update the key in your Stripe Dashboard under Developers then API keys.

  • Missing customer data: If customer address information is incomplete in Stripe, you will need to add it before creating a case. Debitura requires at minimum a name and postal address.

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

Did this answer your question?