# vusalabdurahmanovx/epoint-az architecture

> Architecture diagram of the GitHub repository vusalabdurahmanovx/epoint-az, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vusalabdurahmanovx/epoint-az
- Repository: https://github.com/vusalabdurahmanovx/epoint-az

## Overview

epoint-az is a small Python client for E-Point payment flows. An application calls the client to build and sign checkout, saved-card, wallet, token-widget, reversal, or status requests; the client sends them to E-Point and returns a normalized response. In the other direction, applications can pass callback data to the client for verification and decoding, then use bank-code lookups to interpret results. The graph reflects the sampled client implementation and README; unsampled method details are not expanded.

Main entry points: [`src/epoint_az/client.py`](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py) (HTTP transport), [`src/epoint_az/codes.py`](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/codes.py) (Bank code lookup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_requests["Payment requests"]
  node_client["EPointClient<br/>[client.py]"]
  node_request_ops["Payment operations<br/>[client.py]"]
  node_payload["Payload signing<br/>[client.py]"]
  node_transport["HTTP transport<br/>[client.py]"]
  node_response["HTTP response<br/>[client.py]"]
end

subgraph group_callbacks["Callback results"]
  node_callback["Callback verification<br/>[client.py]"]
  node_callback_result["Decoded callback<br/>[client.py]"]
end

subgraph group_codes["Bank codes"]
  node_bank_codes["Bank code lookup<br/>[codes.py]"]
end

node_application(("Integrating application"))
node_epoint["E-Point API"]

node_application -->|"calls"| node_client
node_client -->|"exposes"| node_request_ops
node_request_ops -->|"builds and signs"| node_payload
node_request_ops -->|"posts through"| node_transport
node_transport -->|"encodes with"| node_payload
node_transport -->|"sends request"| node_epoint
node_transport -->|"parses response"| node_response
node_application -->|"submits data"| node_callback
node_callback -->|"decodes to"| node_callback_result
node_callback_result -->|"looks up code"| node_bank_codes
node_application -->|"queries"| node_bank_codes

click node_client "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py"
click node_request_ops "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py"
click node_payload "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py"
click node_transport "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py"
click node_response "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py"
click node_callback "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py"
click node_callback_result "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py"
click node_bank_codes "https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/codes.py"

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_client,node_request_ops,node_payload,node_transport,node_response toneBlue
class node_callback,node_callback_result toneAmber
class node_bank_codes,node_epoint toneMint
class node_application toneIndigo
```

## Components

### Payment requests

- [EPointClient](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py): `src/epoint_az/client.py`
- [Payment operations](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py): `src/epoint_az/client.py`
- [Payload signing](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py): `src/epoint_az/client.py`
- [HTTP transport](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py): `src/epoint_az/client.py`
- [HTTP response](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py): `src/epoint_az/client.py`

### Callback results

- [Callback verification](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py): `src/epoint_az/client.py`
- [Decoded callback](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/client.py): `src/epoint_az/client.py`

### Bank codes

- [Bank code lookup](https://github.com/vusalabdurahmanovx/epoint-az/blob/main/src/epoint_az/codes.py): `src/epoint_az/codes.py`

### Other components

- **Integrating application**
- **E-Point API**

## Connections

- Integrating application → EPointClient: calls (evidence: `README.md`)
- EPointClient → Payment operations: exposes (evidence: `src/epoint_az/client.py`)
- Payment operations → Payload signing: builds and signs (evidence: `src/epoint_az/client.py`)
- Payment operations → HTTP transport: posts through (evidence: `src/epoint_az/client.py`)
- HTTP transport → Payload signing: encodes with (evidence: `src/epoint_az/client.py`)
- HTTP transport → E-Point API: sends request (evidence: `src/epoint_az/client.py`)
- HTTP transport → HTTP response: parses response (evidence: `src/epoint_az/client.py`)
- Integrating application → Callback verification: submits data (evidence: `README.md`)
- Callback verification → Decoded callback: decodes to (evidence: `src/epoint_az/client.py`)
- Decoded callback → Bank code lookup: looks up code (evidence: `src/epoint_az/client.py`)
- Integrating application → Bank code lookup: queries (evidence: `README.md`)
