Debt enforcement
-
2
 min read

How to show debt collection case status in your invoicing app

Map collection progress, customer actions and payment evidence to invoice labels. Includes a worked timeline and tests for late and duplicate updates.

By Lars Holdgaard, Founder & CEO of Debitura

How to show debt collection case status in your invoicing app

On the invoice, show the last confirmed collection status, any action the customer needs to take, and payments reported against the invoice. Give each its own line. A customer may need to add evidence while collection is under way, and a partial payment may leave the case open.

Four labels and when to show them

These are suggested labels for your product. Pair each label with the case reference and the time your app last confirmed the information.

Active

Show when the linked case lifecycle is Active, confirmed by an authorized case read or a current case.created or case.updated event. While a new case is pending verification, use “Awaiting verification.” Preserve other confirmed states such as “Paused.”

Action required

Use a separate callout when you have verified an open task for this customer. A case.updated event that shows the case needs more information warrants checking the case. If you have confirmed only the need for more information, link the customer to the case with “Check what information is needed.” Show a specific upload or reply instruction once the task is confirmed.

Payment reported

Show payment separately from the case badge, using a verified entry in your own ledger or a confirmed payment record available to your integration. Referral Partner case events cover lifecycle. If your integration receives payment updates, reconcile them against the current record. Update the remaining invoice balance from your reconciled ledger.

Closed

Use a current case read or case.closed to confirm closure. Translate the verified close reason into customer language, such as “Closed · withdrawn.” If you only know the lifecycle is closed, show “Closed” and link to the case for details. Keep the invoice’s payment state visible beside it.

See the Referral Partner webhook reference and the Customer API case-status guide for the fields available on each surface.

One invoice from verification to closure

Fictional example for invoice INV-1048, issued for €2,400.

  1. Monday, 09:10 · Awaiting verification. A case reference is available and the lifecycle is pending verification. Show the reference on the invoice.
  2. Tuesday, 10:05 · Action required. The case needs more information. Support confirms that the signed order is missing. Show “Upload the signed order in Debitura” with the invoice and case references in view.
  3. Wednesday, 14:20 · Active. The latest case state confirms collection is active and support verifies that the task is complete. Remove the upload prompt.
  4. Friday, 11:30 · Active · €600 payment reported. Finance posts and reconciles a €600 direct payment to this invoice. The invoice shows €1,800 open.
  5. Monday, 15:00 · Closed · withdrawn. The creditor withdraws the case and the close reason is confirmed. The invoice still shows €1,800 open.

Test late, duplicate and missing updates

  • Same event arrives twice. Record it once and show one activity entry. Confirm that a retry leaves totals and reminders unchanged.
  • An earlier Active event arrives after closure. Keep the confirmed Closed state, then reconcile conflicting information against an authorized current case read. Do not send a new active-case notification based on the late event.
  • A payment is reversed. Verify the corrected ledger entry and recalculate the balance. Keep the case badge tied to the case lifecycle.
  • Updates stop arriving. Use your product’s freshness threshold. Show “Last confirmed [date and time]” and check the current case if your integration has access. Offer a link to the case or support if freshness cannot be restored.

If a customer contacts support, pass the invoice reference, case reference, last confirmed state and time, and the specific detail that needs checking. A case status alone cannot tell support which document is missing or whether a reported payment has cleared.

See the webhook delivery guide for retries and verification. To plan the post-submission experience for your invoicing product, talk to Debitura’s referral partner team.

Subscription

Sign up to our newsletter

Get updated on best practices, tips and tricks about international debt collection and accounts receivable management.

Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.