---
title: "POST /recollection-case/{recollection_case_id}/installment-plans"
method: POST
path: "/recollection-case/{recollection_case_id}/installment-plans"
tags: ["four-eyes-gated"]
---

# POST /recollection-case/{recollection_case_id}/installment-plans

`POST /recollection-case/{recollection_case_id}/installment-plans`

## Allow repaying in multiple times
This endpoint is dedicated to the creation of an installment plan as part of recollection strategy.
You'll need a recollection-case id to use this endpoint.

In the event of insolvency, your debtor can opt for an installment plan to repay his debt with smaller
recurring pamyents. This smoothens the repayment effort, allowing the debtor to reimburse selected
loans or bills progressively.

the value of the `installment` parameter must be obtained by calling the POST /installment-plan/compute
endpoint.

The `repayment_method` field allows you to decide between direct-debit and sepa credit transfer.
If you pick DIRECT_DEBIT, the debited account will reuse borrower's main repayment account.
cf. GET /borrower/{borrower_id}/repayment-methods endpoint

We know recollection process has costs, for this reason the `recollection_fees` field permits adding
an arbitrary amount to proposed installment plan. This amount can cover recollection expenses
for example. When recollection_fees are collected, they are paid-out to the partner later.

## Path parameters

- `recollection_case_id` string, required

## Headers

- `X-Decision-Id` string, uuid, required

## Request body

- ApiCreateRecollectionInstallmentPlanRequest
  - `installments` ApiCreateRecollectionInstallmentRequest[], required — List of installments in installment plan
    - `amount` integer, required — Total amount of this installment paid by borrower
    - `date` string, date-time, required — Date of payment of this installment
    - `loans` ApiCreateRecollectionInstallmentLoanRequest[], required — Detailed lettering of an installment
      - `amount` integer, required — Amount to repay on loan in this installment
      - `loan_id` string, uuid, required
    - `recollection_fees` integer — Share of recollection fees in installment
  - `payment_method` 'DIRECT_DEBIT' | 'P2P' | 'SCT', required — Payment method to use for requested installment plan

## Response `201`

Created

## Other responses

- `400` — Missing `X-Decision-Id` header or value is not a valid UUID.
- `403` — Decision is not approved, the calling identity does not match the proposer, no planned operation matches this endpoint + payload, the matching step has already been executed, or the caller is not a recognised proposing Operator.
- `404` — No Decision exists for the supplied `X-Decision-Id`.

---

[API](https://skmtc.net/getdefacto/apis/api-reference.md) · [All operations](https://skmtc.net/getdefacto/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getdefacto/api-reference/revisions/0a9c1f8784f2/schema)