Live Sandbox

OpenAPI / Swagger UI for NeoCore microservices. Connect to running services and try API calls directly.

Prerequisites

Services must be running locally or connected to the remote server at 103.216.94.145. See Local Setup to start the stack.

Default Auth

Basic auth is pre-filled on Swagger UI: user / admin123

---

Active Services

Select a service to open its Swagger UI:

Service	Port	Base URL	OpenAPI Spec
General Ledger Service	8088	http://localhost:8088/api/v1/general-ledger	/api/v1/general-ledger/api-docs
Product Service	8083	http://localhost:8083/api/v1/products	/api/v1/products/api-docs
Customer Service	8082	http://localhost:8082/api/v1/customers	/api/v1/customers/api-docs
Deposit Service	8081	http://localhost:8081/api/v1/deposits	/api/v1/deposits/api-docs
Transaction Service	8085	http://localhost:8085/api/v1/transactions	—
Share Service	8086	http://localhost:8086/api/v1/shares	/api/v1/shares/api-docs
System Setup Service	8089	http://localhost:8089/api/v1/system-setup	/api/v1/system-setup/api-docs
Periodic Activity	8087	http://localhost:8087/api/v1/periodic-activity	/api/v1/periodic-activity/api-docs
Bank & Branch Service	8090	http://localhost:8090/api/v1/bank-branch	/api/v1/bank-branch/api-docs
Common Service	8091	http://localhost:8091/api/v1/common	/api/v1/common/api-docs

---

Vite Dev Proxy

When running the showcase app locally via npm run dev, requests are proxied automatically:

# vite.config.ts proxy config
/svc/deposit   → http://localhost:8081
/svc/customer  → http://localhost:8082
/svc/product   → http://localhost:8083
/svc/tx        → http://localhost:8085
/svc/share     → http://localhost:8086
/svc/pa        → http://localhost:8087
/svc/gl        → http://localhost:8088
/svc/syssetup  → http://localhost:8089
/svc/bb        → http://localhost:8090
/svc/common    → http://localhost:8091

---

Key Endpoints Quick Reference

Customer ServiceDeposit ServiceTransaction ServiceGeneral LedgerPeriodic Activity

Method	Path	Description
POST	/api/v1/customers	Create customer
GET	/api/v1/customers/{custId}	Get customer by ID
PUT	/api/v1/customers/{custId}	Update customer
GET	/api/v1/customers	Search customers

Method	Path	Description
POST	/api/v1/deposits/term-deposits	Create term deposit
GET	/api/v1/deposits/term-deposits/{depositNumber}	Get deposit
PUT	/api/v1/deposits/term-deposits/{depositNumber}	Update deposit
GET	/api/v1/deposits/term-deposits	Search deposits
POST	/api/v1/deposits/term-deposits/calculate-tds	Calculate TDS
POST	/api/v1/deposits/term-deposits/{depositNumber}/authorize	Authorize
POST	/api/v1/deposits/term-deposits/{depositNumber}/close	Close deposit
POST	/api/v1/deposits/term-deposits/{depositNumber}/renew	Renew deposit
POST	/api/v1/deposits/term-deposits/{depositNumber}/joint-holders	Add joint holder
POST	/api/v1/deposits/term-deposits/{depositNumber}/nominees	Add nominee

Method	Path	Description
POST	/api/v1/transactions	Create transaction
GET	/api/v1/transactions/{transactionRef}	Get transaction
POST	/api/v1/transactions/cash	Cash transaction
POST	/api/v1/transactions/transfers	Transfer transaction
POST	/api/v1/transactions/transall	Create TransAll
POST	/api/v1/transactions/exceptions	Create exception

Method	Path	Description
POST	/api/v1/general-ledger	Create GL entry
GET	/api/v1/general-ledger/{id}	Get GL entry
PUT	/api/v1/general-ledger/{id}	Update GL entry
GET	/api/v1/general-ledger	Search GL entries

Method	Path	Description
GET	/api/v1/periodic-activity/interest-rate-groups	Search groups
GET	/api/v1/periodic-activity/interest-rate-groups/{id}	Get group
POST	/api/v1/periodic-activity/interest-rate-groups	Create group
PUT	/api/v1/periodic-activity/interest-rate-groups/{id}	Update group
GET	/api/v1/periodic-activity/interest-rate-groups/lookup	Lookup

---

Troubleshooting

Service not reachable

If Swagger shows "Service not reachable":

1. Confirm the service JAR is running: ps aux | grep java
2. Check the port is not blocked: curl http://localhost:{port}/actuator/health
3. Start the service: cd cbms-ai-microservies/{service} && mvn spring-boot:run

CORS errors in browser

The services allow CORS from localhost in dev mode. If you hit CORS issues, use the Vite proxy path (/svc/...) instead of calling ports directly.