Source: https://docs.debitura.com/collection-partners/integration-guides

# Collection Partners: Integration Guides

Workflow guidance for Collection Partner integrations. For endpoint details, see the [API Reference](https://docs.debitura.com/api/collection-partner.md).

<a id="available-guides"></a>

## Available Guides

<a id="create-a-managed-case"></a>

### [Create a Managed Case](https://docs.debitura.com/collection-partners/integration-guides/create-a-managed-case.md)

Submit a case on behalf of your client and choose the right amount input for a single, multi-invoice, or part-paid claim.

<a id="start-a-case"></a>

### [Start a Case](https://docs.debitura.com/collection-partners/integration-guides/start-a-case.md)

Move a case from `PendingVerification` to `Active`, providing a required welcome message and optionally attaching fees.

<a id="update-case-progress"></a>

### [Update Case Progress](https://docs.debitura.com/collection-partners/integration-guides/update-case-progress.md)

Document collection activities and communicate with creditors.

<a id="record-payments"></a>

### [Record Payments](https://docs.debitura.com/collection-partners/integration-guides/record-payments.md)

Report payments and handle allocation between creditor and commission.

<a id="correct-or-remove-payments"></a>

### [Correct or Remove Payments](https://docs.debitura.com/collection-partners/integration-guides/correct-or-remove-payments.md)

Edit or reverse a recorded payment, with the consent-gated case reopen and the invoiced-frozen rule.

<a id="update-claim-amount"></a>

### [Update Claim Amount](https://docs.debitura.com/collection-partners/integration-guides/update-claim-amount.md)

Adjust the principal (gross amount) and fees on a case to reflect the current state of the debt.

<a id="upload-files"></a>

### [Upload Files](https://docs.debitura.com/collection-partners/integration-guides/upload-files.md)

Attach documents and evidence to cases you work or manage using the role-specific file endpoint.

<a id="webhooks"></a>

### [Webhooks](https://docs.debitura.com/collection-partners/integration-guides/webhooks.md)

Receive real-time event notifications for case assignments, lifecycle changes, payments, and chat messages.

<a id="closing-cases"></a>

## Closing Cases

To close a case, call the close endpoint with an appropriate close code. See [Case Lifecycle](https://docs.debitura.com/developer-concepts/case-lifecycle.md) for all close codes and their meanings, or the [Close Case API reference](https://docs.debitura.com/api/collection-partner-api/cases.md#close-a-case) for endpoint details.

Use the dedicated close endpoint for a chosen outcome

Use `POST /cases/{id}/close` to close a case with an explicit close code. A full-settlement `POST /cases/{id}/payments` request can also close the case as `Paid` when it includes `closeCase: true`; partial payments do not. See [Close a Case](https://docs.debitura.com/api/collection-partner-api/cases.md#close-a-case) for the dedicated endpoint reference.

<a id="prerequisites"></a>

## Prerequisites

Before following these guides:

-   Complete the [getting started](https://docs.debitura.com/collection-partners/getting-started.md) setup
-   Review [developer concepts](https://docs.debitura.com/developer-concepts.md) for pagination, error handling, and webhooks