Skip to main content

Attribution

How referral partner revenue is calculated based on client attribution.

Overview​

Attribution determines which cases generate revenue for your platform. The key distinction is whether a client was brought to Debitura by your platform (attributed) or already existed (non-attributed).

Attributed Clients​

A client is attributed when they did not exist in Debitura before your integration introduced them.

Identified by: isAttributedClient: true

Revenue scope: You earn on all cases from this client, regardless of how they're created:

  • Cases submitted via your API integration
  • Cases created directly in the Debitura portal
  • Cases imported via CSV
  • Cases from any other channel

When it happens:

  • POST /clients returns 201 Created (new client)
  • POST /clients returns 202 Accepted (new client, onboarding required)

Non-Attributed Clients​

A client is non-attributed when they already existed in Debitura before being linked to your platform.

Identified by: isAttributedClient: false

Revenue scope: You earn only on cases submitted through your integration (using a bearer token minted via the Referral Partner API).

When it happens:

  • POST /clients returns 409 with ClientExistsNeedsLinking
  • Client approves the link request

Fee Percentage Snapshot​

When a client link is created, Debitura snapshots your current referral fee percentage. This locked percentage:

  • Applies to all future cases from that client
  • Never changes, even if your global fee percentage is updated later
  • Visible in the Debitura portal under the client's profile

Revenue Calculation​

Partners typically earn 50% of Debitura's platform fee:

Partner Revenue = Collection Amount × Partner Success Fee × Debitura Fee × Referral Fee Snapshot

Example: A $10,000 collection with 15% success fee, 30% Debitura fee, and 50% referral split:

  • Collection partner receives: $1,500 (15% of $10,000)
  • Debitura receives: $450 (30% of $1,500)
  • You receive: $225 (50% of $450)

Business context: See Referral program overview for detailed revenue model documentation.

Checking Attribution Status​

GET https://referral-api.debitura.com/clients/{externalTenantId}
XApiKey: YOUR_API_KEY

Response includes isAttributedClient. You can also see attribution status in the client.linked webhook event.

If cases are not generating expected fees, see Missing lead attribution for common causes and self-serve checks.