fbda1b4beb
Some checks failed
Deploy to Phoenix / deploy (push) Has been cancelled
- ADD_CHAIN138_TO_LEDGER_LIVE: Ledger form done; public code review repo bis-innovations/LedgerLive; init/push commands - CONTRACT_DEPLOYMENT_RUNBOOK: Chain 138 gas price 1 gwei, 36-addr check, TransactionMirror workaround - CONTRACT_*: AddressMapper, MirrorManager deployed 2026-02-12; 36-address on-chain check - NEXT_STEPS_FOR_YOU: Ledger done; steps completable now (no LAN); run-completable-tasks-from-anywhere - MASTER_INDEX, OPERATOR_OPTIONAL, SMART_CONTRACTS_INVENTORY_SIMPLE: updates - LEDGER_BLOCKCHAIN_INTEGRATION_COMPLETE: bis-innovations/LedgerLive reference Co-authored-by: Cursor <cursoragent@cursor.com>
2.4 KiB
2.4 KiB
OMNL Fineract Integration
Apache Fineract API client and scripts for the OMNL tenancy at https://omnl.hybxfinance.io/.
Overview
- Base URL:
https://omnl.hybxfinance.io/fineract-provider/api/v1 - Tenant ID:
omnl(required header:Fineract-Platform-TenantId: omnl) - Auth: Basic auth (username/password)
Setup
-
Copy env template and set credentials:
cp .env.example .env # Edit .env and set OMNL_FINERACT_PASSWORD (and other vars if needed) -
Load env and test (from repo root or this directory):
set -a && source .env && set +a curl -s -u "${OMNL_FINERACT_USER}:${OMNL_FINERACT_PASSWORD}" \ -H "Fineract-Platform-TenantId: ${OMNL_FINERACT_TENANT}" \ "${OMNL_FINERACT_BASE_URL}/offices"
Environment Variables
| Variable | Description | Example |
|---|---|---|
OMNL_FINERACT_BASE_URL |
API base URL (no trailing slash) | https://omnl.hybxfinance.io/fineract-provider/api/v1 |
OMNL_FINERACT_TENANT |
Tenant identifier | omnl |
OMNL_FINERACT_USER |
Basic auth username | app.omnl |
OMNL_FINERACT_PASSWORD |
Basic auth password | (set in .env only) |
OMNL_FINERACT_INSECURE |
Skip TLS verify (0/1) | 0 |
API Quick Reference
- Swagger UI: https://omnl.hybxfinance.io/fineract-provider/swagger-ui/index.html
- Offices:
GET /offices - Clients:
GET /clients - Loans:
GET /loans
All requests require:
- Header:
Fineract-Platform-TenantId: omnl - Basic auth:
app.omnl+ password
Submodule
This directory can be added as a git submodule when the OMNL Fineract integration is moved to its own repository. From the parent repo:
git submodule add <repository-url> omnl-fineract
git submodule update --init --recursive
Documentation
- OMNL Fineract Configuration — Full setup and credential handling
- OMNL Deposits Plan — Plan for adding all deposits (savings/FD/RD, discovery, bulk)
- Migration & Ledger Allocation Memorandum — Opening balance and internal USD distribution (T-001–T-008)