openfintechlab/paytrace-adapter-iso2022 repository overview

⁠PayTrace Adapter ISO2022

PayTrace Adapter ISO2022 is a Python/FastAPI-based PayTrace microservice container intended to support ISO message adapter capabilities within the PayTrace payment-processing platform.

The current codebase provides a service foundation with API bootstrap, environment-based configuration, PostgreSQL startup validation, health/probe endpoints, request-header validation, and Docker packaging.

⁠Key Features

• FastAPI microservice runtime
• Uvicorn application server
• PostgreSQL connectivity using SQLAlchemy
• Environment-driven configuration using .env
• Standard health and probe endpoints
• Versioned API routing
• Mandatory PayTrace request-header validation
• Dockerized runtime using Python 3 and uv

⁠Default Endpoints

GET /_healthz
GET /_probe
GET /sca/v1/

⁠Runtime Configuration

The service uses environment variables for:

• API context root
• API version
• Host and port
• Logging level and format
• PostgreSQL connection details
• Default Port

⁠Example Docker Run

docker run -d \
  --name paytrace-adapter-iso2022 \
  -p 8081:8081 \
  --env-file .env \
  openfintechlab/paytrace-adapter-iso2022:latest

⁠Health Check:

curl http://localhost:8081/_healthz
curl http://localhost:8081/_probe

⁠Source Code

https://github.com/openfintechlab/paytrace-adapter-iso2022`

⁠Technology Stack

Python 3.11+ FastAPI Uvicorn SQLAlchemy PostgreSQL pytest Docker