Updating the Current Account Maximum Number of Installments
Description
This service is used to update the maximum number of installments that can be applied during debt collection for a current account transaction.
It is typically called within the scope of debt restructuring or payment plan operations when it is necessary to change the MaxInstallment value of a specific transaction.
- Enpoint:
/cat/cat/maxInstallment - Method (Method):
PUT
Header Information
- Header:
Authorization: Bearer {token},Content-Type: application/json - Body:
JSON
Request Body
| Field | Required | Format | Description / Example | Validation |
|---|---|---|---|---|
erpCode | Yes | string | Example: D17841154 | Cannot be empty. The related ERP record must exist in the system. |
MaxInstallmentCount | Yes | int | Example: 12 | Must be greater than 0. Must not exceed the maximum installment count defined in the portal. |
Business Rule
The entered MaxInstallmentCount value cannot be greater than the maximum installment count defined on the portal side. Otherwise, the following error message is returned:
“You can define an installment count greater than 0 and less than 12 at maximum.”
Sample Request
- Header:
Authorization: Bearer {token},Content-Type: application/json
- Body
- Successful Response
- Sample cURL
{
"erpCode": "YeniErpKodu123",
"MaxInstallmentCount": 12
}
{
"status": "success",
"message": "The maximum installment count of the current account transaction has been updated."
}
curl --location --request PUT 'https://prodtest_gw.finrota.com/cat/cat/maxInstallment' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzY29wZSI6WyJlcnB2MS5hcGkiLCJjYXR2MS5hcGkiLCJ2ZW5kb3J2MS5hcGkiXSwiYWN0b3J0Ijoic2VydmljZSIsInJvbGUiOiJzZXJ2aWNlIiwiVW5pcXVlIjoiMjBhZmRmZTctYjdiZi00N2UyLWJhYzQtYjQ5YThjNGJiMDc5IiwiVGVuYW50SWQiOiI2NzA2ODNjMS0yZmUwLTQ4NDYtODdiMi02Y2JhOWI3OTNhYjIiLCJodHRwOi8vc2NoZW1hcy5taWNyb3NvZnQuY29tL3dzLzIwMDgvMDYvaWRlbnRpdHkvY2xhaW1zL2V4cGlyYXRpb24iOiI2Mzg5NTA5MTIxMjczOTI1ODciLCJuYmYiOjE3NTkzMjE2MTIsImV4cCI6MTc1OTQ5NDQxMiwiaWF0IjoxNzU5MzIxNjEyLCJpc3MiOiJzc28uYXBpIiwiYXVkIjoiZWNvenVtLnNzbyJ9.5lyBbGfKMzfQZJ5Rz73rR254oy7ne_xGpEBDr7lTtPk' \
--data '{
"erpCode": "7044dac0-bbb3-4845-a316-702e2702b1673",
"maxInstallmentCount": 5
}'