API Reference

Base URL

https://turnomifos.incentius.net/api

All endpoints are relative to this base URL.

Authentication

All API endpoints (except webhooks) require the X-Internal-Token header:

Header	Value
X-Internal-Token	Your internal orchestration token from config.py

Endpoint Groups

Fineract Operations

Method	Endpoint	Description
POST	/fineract/operate	Unified endpoint for all client & loan operations
GET	/fineract/track/{tracking_id}	Poll operation status

Webhooks

Method	Endpoint	Description
POST	/webhooks/razorpay	Razorpay payment webhook
POST	/webhooks/cashfree	Cashfree payment webhook

Portfolio Migration

Method	Endpoint	Description
POST	/migration/upload	Upload migration CSV
POST	/migration/run	Start migration processing

Account Management

Method	Endpoint	Description
POST	/account/login	JWT login
POST	/account/register	Create user (admin only)

Async Processing Model

All Fineract operations are processed asynchronously:

1. Submit - POST /fineract/operate returns immediately with a tracking_id
2. Queue - The operation is enqueued to RQ (Redis Queue)
3. Process - RQ worker picks up the job and calls Fineract
4. Poll - Use GET /fineract/track/{tracking_id} to check completion

CSV Templates

Download templates for bulk operations:

• Operate Template (Loans CSV) - one row per loan
• Migration Repayments Template - one row per EMI payment

See Templates for field-by-field documentation.