---
title: "Record a payment on a test case (managing partner)"
method: POST
path: "/managed-cases/{id}/payments"
tags: ["ManagedCases"]
---

# Record a payment on a test case (managing partner)

`POST /managed-cases/{id}/payments`

Records a payment on a test case you submitted as managing partner.

**Test-Only Restriction:**
This endpoint only works on cases created with `isTestCase: true`. Attempting to record a payment on a production case returns a 400 error. For production cases, the assigned collection partner must use `POST /cases/{id}/payments`.

**Purpose:**
Allows managing partners (e.g. Get-Systems) to test their full payment integration end-to-end — including webhook delivery, lifecycle transitions, and remainder updates — without involving the collection partner.

**Payout Handling:**
A payout record is created automatically with the full payment amount going to the creditor and zero to the collection partner. CommissionPaymentStatus is set to Unpaid.

**Webhooks:**
Payment webhooks fire normally, making this useful for end-to-end integration testing.

**CloseCase:**
If `closeCase=true` and the payment amount is less than the outstanding balance, a 400 is returned.

## Path parameters

- `id` string, uuid, required

## Request body

- DebituraWebExternalApiContractsV1PaymentsCreateManagedCasePaymentRequest — Request to record a payment on a test case as managing partner. Only available for cases created with isTestCase: true.
  - `date` string, date-time, required — Payment date (when payment was received).
  - `paymentAmount` number, double, required — Total payment amount received.
  - `closeCase` boolean — Whether to close the case after recording this payment (default: false). If true and payment < invoice remainder, returns validation error.

## Response `200`

Payment recorded successfully

- DebituraWebExternalApiContractsV1PaymentsCreateManagedCasePaymentResponse — Response after recording a payment as managing partner on a test case.
  - `paymentId` string, uuid
  - `caseReference` string, nullable, required
  - `date` string, date-time
  - `paymentAmount` number, double
  - `caseClosed` boolean
  - `remainingAmount` number, double

## Other responses

- `400` — Invalid request or production case
- `404` — Case not found or not submitted by you as managing partner
- `500` — Server error

---

[API](https://skmtc.net/debitura/apis/debitura-collection-partner-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-collection-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-collection-partner-api/revisions/40bd25a4edaf/schema)