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. The process takes about 10 minutes and requires a Stripe API key with read permissions.

Updated over 2 weeks ago

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 Dashboard with permission to create API keys

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

Steps

Step 1: Generate a Stripe API key

  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 the following read-only permissions:

  • Read access to Invoices

  • Read access to Customers

  1. Copy the API key. Restricted keys start with rk_. Store it securely as you will need it in the next step.

Step 2: Connect Stripe in Debitura

  1. Log in to your Debitura account at app.debitura.com.

  2. Select Stripe from the list of available integrations.

  3. Enter your Stripe API key in the provided field.

  4. Click Save. Debitura validates your API key by connecting to your Stripe account. If the key is invalid, you will see an error.

Step 3: 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 4: 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 5: 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

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

Did this answer your question?