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)
Go to Integrations in your Debitura account, or install directly from the Stripe App Marketplace listing.
Select Stripe and click Connect with Stripe.
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.
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.
Log in to your Stripe Dashboard.
Navigate to Developers then API keys.
Click Create restricted key to create a new API key with limited permissions.
Grant read-only permissions to Invoices and Customers.
Copy the API key. Restricted keys start with rk_.
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
Go to Create Case via Integration.
Select Stripe as the integration source.
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).
Click Fetch invoices to retrieve your unpaid invoices from Stripe.
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
Select the invoices you want to convert into collection cases.
Click Create cases to submit them for debt collection.
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.
