Wallet, Account & Virtual Account

Overview

The Wallet Service is a Java-based microservice designed to manage wallets, transactions, payouts, and virtual accounts. It is built using Spring Boot and follows a modular architecture to ensure scalability and maintainability.

Features

Feature	Description
👜 Wallet Management	Create, update, and retrieve wallet details.
💳 Transaction Management	Handle user transactions with support for pagination and filtering.
💸 Payouts	Initiate and manage payouts.
🏦 Virtual Accounts	Manage virtual accounts for users.
📖 OpenAPI Documentation	Integrated API documentation using SpringDoc OpenAPI.
🔍 Observability	Includes logging and tracing with Loki and OpenTelemetry.

Technologies Used

Technology	Purpose
☕ Java 17	Programming language
🌱 Spring Boot 3.2.4	Framework for building microservices
🐘 PostgreSQL	Database
🛠️ Flyway	Database migrations
✂️ Lombok	Reducing boilerplate code
🔄 MapStruct	Object mapping
🛡️ Resilience4j	Fault tolerance
📜 OpenAPI	API documentation
📊 Micrometer	Observability

Getting Started

Prerequisites

☕ Java 17 or higher
🐘 PostgreSQL database
🛠️ Gradle build tool

Setup Instructions

Clone the repository:

git clone https://github.com/Olanna-tech/wallet-service-java.git
cd wallet-service-java

Configure the database in src/main/resources/application.yml:

spring:
  datasource:
    url: jdbc:postgresql://<DB_HOST>:<DB_PORT>/<DB_NAME>
    username: <DB_USERNAME>
    password: <DB_PASSWORD>

Build the project:
```
./gradlew build
```
Run the application:
```
./gradlew bootRun
```

Running Tests

To execute the test suite, run:

./gradlew test

API Endpoints

Wallets

Endpoint	Method	Description
`/api/v1/wallets`	POST	➕ Create a new wallet
`/api/v1/wallets/{walletId}`	GET	🔍 Retrieve wallet details
`/api/v1/wallets/{userId}/user`	GET	🔍 Retrieve wallets for a user
`/api/v1/wallets/{walletId}/status`	PATCH	✏️ Update wallet status
`/api/v1/wallets/{walletId}/balance`	GET	💰 Retrieve wallet balance

Payouts

Endpoint	Method	Description
`/api/v1/payouts`	POST	➕ Initiate a payout
`/api/v1/payouts/{payoutId}`	GET	🔍 Retrieve payout details
`/api/v1/payouts`	GET	🔍 Retrieve all payouts
`/api/v1/payouts/{payoutId}/status`	PATCH	✏️ Update payout status

Transactions

Endpoint	Method	Description
`/api/v1/transactions`	POST	➕ Create a transaction
`/api/v1/transactions/{transactionId}`	GET	🔍 Retrieve transaction details
`/api/v1/transactions`	GET	🔍 Retrieve all transactions

Virtual Accounts

Endpoint	Method	Description
`/api/v1/virtual-accounts`	POST	➕ Create a virtual account
`/api/v1/virtual-accounts/{accountId}`	GET	🔍 Retrieve virtual account details

Observability

Feature	Description
📜 Logging	Configured with Loki for centralized logging.
📡 Tracing	Integrated with OpenTelemetry for distributed tracing.

License

This project is licensed under the 📝 Apache 2.0 License. See the LICENSE file for details.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

Contact

For inquiries, please contact 📧 support@Olanna-tech.com.