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
  • Can be retrieved via GET /clients/{externalTenantId}
{
  "externalTenantId": "your-client-id",
  "isAttributedClient": true,
  "referralFeePercentageSnapshot": 0.5
}

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 and referralFeePercentageSnapshot.