Goal
Help your customers by looking up their case status, assisting with onboarding, verifying attribution, and escalating to Debitura when needed.
Prerequisites
An active referral partnership with Debitura.
Your Partner GUID (provided by Debitura during partnership setup). If you do not have one, see How to request credentials, environments, and support access.
At least one linked customer (client) in Debitura.
Steps
1. Log in to the Referral Partner Dashboard
Enter your Partner GUID on the login page.
The dashboard authenticates your partner account and opens the Cases view.
Your session persists for 14 days, even if you close the tab or restart the browser. After 14 days, or if you log out, you will need to re-authenticate with your Partner GUID. If you receive an authentication error, request updated credentials from Debitura.
2. Look up a customer's case status
When a customer asks about a collection case, use the Cases view to find it.
Navigate to the Cases view (the default view after login).
Use the search bar to find the case by case reference (e.g. DEB-12345), debtor name, or customer (client) company name.
Optionally, filter by status tab: All, Waiting for client, Active, Pending, Closed, or Paused.
The table shows the case reference, customer name, debtor name, invoice amount, status and Your Rate. Under View, you can add columns for the collection partner, creation date and collection start date.
What each status means:
Waiting for client - the case is on hold for validation and Debitura is waiting for the customer to answer a request.
Debitura reviewing - the case is on hold for validation and Debitura is checking it. No action is needed from the customer right now.
Active - the case is currently with a collection partner who is working on recovery.
Pending - the case is awaiting a step before collection starts, such as contract signing, validation, collection partner acceptance, an information request or a quote.
Closed - collection is complete (successfully collected or terminated).
Paused - collection activity is temporarily on hold.
You can export the filtered results as a CSV file for further analysis. The export includes the waiting party, waiting-since date and reason labels for cases on hold, but not Debitura's question to the customer.
If a case is on hold for validation: open the case to see its validation card. When the case is waiting for the customer, the card shows when the wait started (when known), short reason labels and, when available, Debitura's current question to the customer, word for word, with How you can help and What happens next sections. It does not show Debitura's internal notes. Encourage the customer to answer the request Debitura sent them. If you have supporting evidence, such as an account statement, you can upload it with Go to Files for Debitura's team to review. Your upload is not the customer's answer to the request: it does not trigger an automatic recheck and does not by itself move the case to Debitura reviewing. If the card shows a date when the case may close, treat it as an estimate, not a guarantee.
3. Help a customer complete onboarding
If a customer has not yet signed the Standard Debt Collection Agreement (SDCA), their cases will remain in "Pending" status. Use the Clients view to check and resolve this.
Switch to the Clients view.
Filter by the Unsigned SDCA tab to see customers who have not yet signed the SDCA.
Find the customer in the table. The "Onboarding Status" column shows Pending or Complete.
For customers with pending onboarding, click on the row to open the onboarding modal. This displays the full onboarding URL and a copy-to-clipboard button.
Share the onboarding URL with your customer. They need to visit this link to confirm their company details, add users, and sign the SDCA electronically.
Once the customer completes onboarding, their status updates to "Complete" and their cases can proceed to collection partner assignment.
If a customer reports problems completing onboarding, see Customer signup / activation issues.
If a customer has pending KYC verification: For customers whose cases are routed to a collection partner that requires KYC (currently UK partners under Oriel Collections), a Pending KYC Status badge appears in the Clients view. Clicking it opens a form where you can submit the director's full name, home address, and date of birth on the customer's behalf. This unblocks case submission without requiring the customer to fill in the form themselves. Once submitted, the badge updates to Completed.
One UK edge case to know about: if a customer hit a 409 "already exists" response on first submission and approved the link request before any KYC was on file, the cases that carried through may briefly appear without KYC enforced. The next case your platform submits for the same customer (through your API integration) will catch the gap and require the director details before it accepts. If a UK customer reports cases that "look like nothing's happening," check the Clients view for a Pending KYC badge and submit the director details to unblock.
4. Verify earnings and attribution
Use the Earnings view to check that referral fees are being generated for your customers' cases.
Switch to the Earnings view.
Review the Total lifetime earnings line and the five summary cards at the top: Pending, Confirmed Pipeline, Ready to Invoice Debitura (Awaiting statement if Debitura issues you a self-billing statement), Awaiting Debitura Payment, and Paid to You.
Search the transaction table by case reference or customer name to find specific earnings.
Check each transaction's status to see where the fee is in the lifecycle. For example, Pending means the collection partner's commission is not yet settled, Ready to Invoice means you can invoice Debitura, and Paid means Debitura has recorded sending your referral payment.
All amounts are displayed in USD for consistency across currencies. For details on how revenue stages work and how to invoice Debitura, see Revenue sharing and financial reconciliation.
If you expect fees for a case but none appear, check whether the customer is an attributed or non-attributed client. Non-attributed clients only generate fees on cases submitted through your platform (through your integration), not on cases the client creates directly in Debitura. For more details, see Referral program overview. If you believe attribution is incorrect, see Missing lead attribution.
5. Escalate to Debitura
Debitura handles collection partner management, case operations, and compliance. Escalate to Debitura when:
A customer reports a problem you cannot resolve through the dashboard (e.g. case stuck in an unexpected status).
A customer disputes a fee or has a billing question that requires Debitura's investigation.
You need technical support with your integration or dashboard access.
Contact channels:
Technical support: [email protected]
Partnership and billing questions: [email protected]
When escalating, include the case reference, customer name, and a description of the issue so Debitura can investigate efficiently. For response-time SLAs and the full escalation path (including critical-issue contact), see Referral Partners: Support channels, SLA, and escalation.
Common questions from your customers
Use these scripted answers to handle the three questions customers ask most often. Tailor the wording to your tone of voice; the facts below come from how Debitura's collection process actually works.
"Why was my case rejected?"
When a partner declines a case, the dashboard shows the specific close code on the case row in the Cases view (small text below the status badge in the case list). The close code tells you why the partner could not work the case.
Common reasons partners decline include: insufficient supporting documents, debtor jurisdiction or claim amount falling outside the partner's coverage, debtor already known to be insolvent or untraceable, or duplicate debtor records.
If the close code does not make the situation clear, escalate to Debitura with the case reference and ask for a fuller explanation.
"How long will collection take?"
Standard cases run on a 6-month exclusive pre-legal period. During this period the assigned collection partner is the only party working the case, and the customer cannot withdraw it without paying the full success fee.
The 6-month period extends automatically by 12 months if the debtor:
Provides a written promise to pay, or
Signs a payment agreement (for example, an installment plan), or
Makes any actual payment.
If the 6-month period passes with no outcome, the case may close as "Pre-Legal Exhausted - No Payment", and the customer can decide whether to pursue legal escalation.
"Who is the collection partner working on my case?"
Debitura assigns a local collection partner automatically, based on the debtor's country. The assigned partner's name is visible in the case sidebar inside the dashboard.
Customers can communicate directly with the assigned partner using the in-platform case chat on the case detail page. Every collection partner in the network has been verified and onboarded by Debitura, so customers do not need to vet partners themselves.
"My customer's approval link expired - what should I tell them?"
With the Full Integration, the approval link your platform delivered to your customer expires after the partner's configured window (default 7 days; configurable per partner up to 30 days). When it expires, you receive a client.link_expired webhook. To recover, your platform simply re-runs the same client creation call with the same external tenant ID and payload. Debitura creates a fresh link request and returns a new approval URL. Debitura does not email it, so your platform must deliver it to the customer (by redirect, an in-app prompt or your own email). Any cases originally submitted in the payload are still preserved and will land on approval. No data is lost. With the Starter Integration, Debitura emailed the approval invitation to the user you submitted, and it expires under the same window; the expiry shows on the collection request and its update webhook, and you send a fresh collection request to start a new approval.
"My customer clicked approve and saw a 'this link has already been used' error."
The most common cause is that the customer (or you on their behalf) clicked twice in quick succession, or that the customer had two browser tabs open. The platform processes only one approval or decline per link request, so the second click is rejected. The first action did succeed - check the Clients view; the customer should already be linked. If they are not, contact [email protected] with the customer's external tenant ID.
When to escalate vs self-serve
Use this table to decide what to advise your customer.
Situation | Recommended action |
Question about a specific active case (status, documents, debtor contact) | Use in-platform case chat first - the assigned collection partner is the right contact |
Platform or technical issue | Email [email protected] |
No response within SLA | Contact your assigned account manager |
Dispute or legal concern | Email [email protected] |
SLA reminder: collection partners are expected to reply in case chat within 48 business hours (weekends excluded). If you have not heard back within that window, send a follow-up in case chat before escalating.
Result
After completing these steps, you can answer your customers' questions about case progress, help them complete onboarding, verify that referral fees are being generated correctly, and escalate complex issues to Debitura with the right information.
Edge cases
Dashboard actions are limited. You can upload files to a case, submit KYC details for a customer and withdraw a customer whose cases are all still waiting for contract signing (Withdraw client), but the Referral Partner Dashboard does not support creating cases or clients, modifying client details, or managing onboarding directly. Cases are created through your platform's API integration. Onboarding is completed by the customer via the onboarding URL.
Non-attributed clients generate limited fees. If a customer already existed in Debitura before linking to your platform, they are normally marked as non-attributed. Fees are then generated only for cases submitted through your platform, not for cases the client creates directly in the Debitura web app. If you previously held an attributed link to that same customer, approval preserves attributed status.
Onboarding URL validity. The main onboarding link has no time-based expiry: it stays valid while your link to the customer is active, and a customer who did not finish onboarding can return to the same link and continue. Only the approval link for a customer who already has a Debitura account expires (the 409 conflict scenario in the Full Integration, or the approval step of a Starter collection request).
CSV export limit. Dashboard CSV exports are limited to 1,000 rows. For larger datasets, use the Referral Partner API directly.
KYC verification blocks new cases. If a customer's assigned collection partner requires KYC (currently UK partners under Oriel Collections) and no director details are on file, new case submissions through your API integration are rejected with a
MissingKycVerificationerror (HTTP 422). You can resolve this by submitting the director's full name, home address, and date of birth from the Clients view in the dashboard. Once submitted, subsequent case submissions for that customer proceed normally.
