# safoosafa/eco-docs architecture

> Architecture diagram of the GitHub repository safoosafa/eco-docs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/safoosafa/eco-docs
- Repository: https://github.com/safoosafa/eco-docs

## Overview

This repository documents the MITF Online Payment Ecosystem rather than implementing its runtime. The principal flow is a merchant or channel obtaining API credentials through the Merchant Portal, then using Online Payment API V2 to reach either the legacy V1 proxy or the Legacy Core bank gateway. The README also identifies the WooCommerce hosted-payment channel and credential vault. Source excerpts are unavailable, so links reflect only relationships explicitly stated in the README; the documentation tree supports the subsystem paths shown.

Main entry points: [`docs/merchant-portal.md`](https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md) (Merchant Portal), [`docs/online-payment-v2.md`](https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md) (Online Payment API V2), [`docs/integrations-and-woocommerce.md`](https://github.com/safoosafa/eco-docs/blob/main/docs/integrations-and-woocommerce.md) (Payment Service), [`docs/overview.md`](https://github.com/safoosafa/eco-docs/blob/main/docs/overview.md) (Legacy Core)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_channels["Payment channels"]
  node_channels["Channels<br/>[overview.md]"]
  node_woocommerce["WooCommerce"]
  node_payment_service["Payment Service"]
end

subgraph group_control["Merchant control plane"]
  node_portal["Merchant Portal<br/>[merchant-portal.md]"]
  node_identity["Identity &amp; operations<br/>[merchant-portal.md]"]
  node_developer_tools["Developer tools<br/>[merchant-portal.md]"]
  node_key_vault[("Credential vault<br/>[overview.md]")]
  node_api_keys["API keys<br/>[merchant-portal.md]"]
end

subgraph group_payment["Payment APIs"]
  node_v2["Online Payment API V2"]
  node_jwt_proxy["JWT proxy"]
  node_rest_api["REST /v2 API"]
  node_v1["Online Payment API V1"]
end

subgraph group_banking["Bank gateway"]
  node_legacy_core["Legacy Core<br/>[overview.md]"]
  node_bank["Bank"]
end

node_merchant(("Merchant / integrator"))

node_merchant -->|"manages account"| node_portal
node_portal -->|"provides"| node_identity
node_portal -->|"provides"| node_developer_tools
node_portal -->|"issues and resolves"| node_api_keys
node_portal -->|"uses"| node_key_vault
node_channels -->|"submit payments"| node_v2
node_woocommerce -->|"uses"| node_payment_service
node_payment_service -->|"API-key access"| node_v2
node_v2 -->|"routes JWT"| node_jwt_proxy
node_v2 -->|"serves /v2"| node_rest_api
node_jwt_proxy -->|"proxies"| node_v1
node_rest_api -->|"calls"| node_legacy_core
node_legacy_core -->|"gateway calls"| node_bank

click node_channels "https://github.com/safoosafa/eco-docs/blob/main/docs/overview.md"
click node_woocommerce "https://github.com/safoosafa/eco-docs/blob/main/docs/integrations-and-woocommerce.md"
click node_payment_service "https://github.com/safoosafa/eco-docs/blob/main/docs/integrations-and-woocommerce.md"
click node_portal "https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md"
click node_identity "https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md"
click node_developer_tools "https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md"
click node_key_vault "https://github.com/safoosafa/eco-docs/blob/main/docs/overview.md"
click node_api_keys "https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md"
click node_v2 "https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md"
click node_jwt_proxy "https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md"
click node_rest_api "https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md"
click node_v1 "https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md"
click node_legacy_core "https://github.com/safoosafa/eco-docs/blob/main/docs/overview.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_channels,node_woocommerce,node_payment_service toneBlue
class node_portal,node_identity,node_developer_tools,node_key_vault,node_api_keys toneAmber
class node_v2,node_jwt_proxy,node_rest_api,node_v1 toneMint
class node_legacy_core,node_bank toneRose
class node_merchant toneIndigo
```

## Components

### Payment channels

- [Channels](https://github.com/safoosafa/eco-docs/blob/main/docs/overview.md): `docs/overview.md`
- [WooCommerce](https://github.com/safoosafa/eco-docs/blob/main/docs/integrations-and-woocommerce.md): `docs/integrations-and-woocommerce.md`
- [Payment Service](https://github.com/safoosafa/eco-docs/blob/main/docs/integrations-and-woocommerce.md): `docs/integrations-and-woocommerce.md`

### Merchant control plane

- [Merchant Portal](https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md): `docs/merchant-portal.md`
- [Identity & operations](https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md): `docs/merchant-portal.md`
- [Developer tools](https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md): `docs/merchant-portal.md`
- [Credential vault](https://github.com/safoosafa/eco-docs/blob/main/docs/overview.md): `docs/overview.md`
- [API keys](https://github.com/safoosafa/eco-docs/blob/main/docs/merchant-portal.md): `docs/merchant-portal.md`

### Payment APIs

- [Online Payment API V2](https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md): `docs/online-payment-v2.md`
- [JWT proxy](https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md): `docs/online-payment-v2.md`
- [REST /v2 API](https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md): `docs/online-payment-v2.md`
- [Online Payment API V1](https://github.com/safoosafa/eco-docs/blob/main/docs/online-payment-v2.md): `docs/online-payment-v2.md`

### Bank gateway

- [Legacy Core](https://github.com/safoosafa/eco-docs/blob/main/docs/overview.md): `docs/overview.md`
- **Bank**

### Other components

- **Merchant / integrator**

## Connections

- Merchant / integrator → Merchant Portal: manages account
- Merchant Portal → Identity & operations: provides
- Merchant Portal → Developer tools: provides
- Merchant Portal → API keys: issues and resolves
- Merchant Portal → Credential vault: uses
- Channels → Online Payment API V2: submit payments
- WooCommerce → Payment Service: uses
- Payment Service → Online Payment API V2: API-key access
- Online Payment API V2 → JWT proxy: routes JWT
- Online Payment API V2 → REST /v2 API: serves /v2
- JWT proxy → Online Payment API V1: proxies
- REST /v2 API → Legacy Core: calls
- Legacy Core → Bank: gateway calls