Source: https://docs.debitura.com/referral-partners

Referral partners

# Offer debt collection right next to the unpaid invoice in your product

When the last reminder doesn't work, your users get a next step without leaving your app. Debitura is the collection infrastructure behind it: a licensed local agency or law firm in the debtor's country, in 180 countries. You choose how much of the experience you build.

[See it in a live product (demo) →](https://referral.debitura.com/demo-journey#starter)[Get started](https://docs.debitura.com/referral-partners/getting-started.md)

<a id="two-ways-to-integrate"></a>

## Two ways to integrate

Both integrations use the same API key, the same clients and the same cases. The difference is how much of the journey you build and how much Debitura handles for you.

[Start here

## Starter Integration

One API call and a button. Debitura handles everything that comes after.

You build

`POST /collection-requests`, a button that opens the returned link, and one webhook

Debitura handles

Sign-up, approving the connection, agreements, KYC and fixing invoice data

Your user

Clicks "Send to collection" and finishes on Debitura's pages, with your logo

Starter quickstart →](https://docs.debitura.com/referral-partners/getting-started/starter-quickstart.md)[

## Full Integration

Collection built into your own screens, with full control over every step.

You build

Client onboarding, pricing previews, case submission and status, across two APIs, plus webhooks

You handle

Every onboarding response (201, 202, 409), validation errors and the agreement and KYC links

Your user

Stays in your app and leaves only to sign

How the Full Integration works →](https://docs.debitura.com/referral-partners/getting-started/how-it-works.md)

**It's not either/or.** Start with Starter. When you need more control, add Full endpoints for the same client, such as pricing previews, status in your own screens or document upload. Nobody is onboarded twice, and an existing case is recognised whichever route created it.

<a id="compare"></a>

## Compare

|  | Starter Integration | Full Integration |
| --- | --- | --- |
| **Endpoints you call** | 2: `POST` and `GET /collection-requests` | 8, across the Referral Partner API and the Customer API |
| **A new client signs up** | On Debitura's hosted pages, opened from the `solutionUrl` you receive | You call `POST /clients` and send the user to the returned onboarding URL |
| **The client already has a Debitura account** | Debitura emails the approval invitation and returns the approval link to you | You handle the `409` responses and deliver the approval URL |
| **Invoice data needs correcting** | It becomes a draft the client fixes on Debitura | You receive the error response and fix it in your app |
| **KYC is required** | The case waits; submitting the KYC form releases it | You present the KYC link and resubmit |
| **Status in your app** | The request status, plus case webhooks | Everything: cases, documents, payments and messages |
| **Effort** | One endpoint, one button, one webhook | Onboarding, token handling, case submission, error handling and webhooks |

See [Who does what](https://docs.debitura.com/referral-partners/concepts/responsibility-matrix.md) for every responsibility, side by side.

<a id="not-sure-answer-three-questions"></a>

## Not sure? Answer three questions

Do you want to design the sign-up and agreement screens yourself?

Should users see the collection fee in your app before they send an invoice?

Should case progress, documents and partner messages appear inside your app?

Starter Integration

One call and a button; Debitura handles the rest. [Starter quickstart →](https://docs.debitura.com/referral-partners/getting-started/starter-quickstart.md)

The same rules, written out:

| If you… | Use |
| --- | --- |
| want users to send an invoice with one click and let Debitura handle setup | Starter |
| also want to show the fee before an invoice is sent | Starter, plus [`POST /cases/preview`](https://docs.debitura.com/referral-partners/integration-guides/preview-case-pricing.md) |
| want case status, documents and partner messages inside your app | Starter, plus [Customer API reads with a bearer token](https://docs.debitura.com/referral-partners/integration-guides/case-submission.md) |
| want to design your own sign-up and agreement screens | Full |

<a id="see-it-first"></a>

## See it first

The [Ledgerline demo](https://referral.debitura.com/demo-journey#starter) shows the whole journey inside a fictional accounting product. Turn on **Developer view** to see the requests and responses behind each step. To explore case tracking and earnings, sign in to the [Partner Dashboard](https://referral-dashboard.debitura.com/) with the code `demo`.

**Business context:** see the [Referral program overview](https://support.debitura.com/en/articles/13908998-referral-partners-referral-program-overview-what-you-earn-when-and-what-counts) for what you earn, and [What your client sees during onboarding](https://support.debitura.com/en/articles/14837151-referral-partners-what-your-client-sees-during-onboarding).
