docs: add changelog for 4.6.0 release

Author: HosseinNejatiJavaremi

docs/community/changelog/4/4.5.0.md

@@ -5,7 +5,7 @@ description: "Release notes for ArchiPy 4.5.0"
 
 # 4.5.0 — 2026-04-27
 
-[← 4.4.2](4.4.2.md) | [↑ 4.x series](index.md)
+[← 4.6.0](4.6.0.md) | [4.4.2 →](4.4.2.md) | [↑ 4.x series](index.md)
 
 ## Added
 

docs/community/changelog/4/4.6.0.md

@@ -0,0 +1,49 @@
+---
+title: "Changelog 4.6.0"
+description: "Release notes for ArchiPy 4.6.0"
+---
+
+# 4.6.0 — 2026-04-27
+
+[← 4.5.0](4.5.0.md) | [↑ 4.x series](index.md)
+
+## Added
+
+### Adapters - Payment Gateways
+
+- **Parsian IPG Async Adapter** - Added new async payment gateway adapter for Parsian integration.
+    - New `parsian-ipg-async` optional extra
+    - SOCKS5 proxy support
+
+- **Saman IPG Async Adapter** - Refactored Saman IPG adapter to use async `httpx`.
+    - Switched from synchronous `requests` to async `httpx`
+
+### Adapters - Ports
+
+- **Port Interface Extraction** - Extracted payment gateway port interfaces and moved DTOs to ports.
+    - Moved DTOs to `ports.py` for cleaner abstraction
+
+### Documentation - Payment Gateways
+
+- **IPG Adapters Documentation** - Added async documentation for Saman and Parsian adapters.
+
+## Changed
+
+### Dependencies - Project
+
+- **Saman IPG Extra** - Switched Saman IPG extra from `requests` to `httpx`.
+    - `saman-ipg = ["httpx[socks]>=0.28.1"]`
+
+- **Parsian IPG Extra** - Added new async extra for Parsian IPG.
+    - `parsian-ipg-async = ["zeep[async]>=4.3.2", "httpx[socks]>=0.28.1"]`
+
+### Tests - Containers
+
+- **Dynamic Kafka Test Container** - Upgraded Kafka test container with dynamic port allocation.
+    - Upgraded to `apache/kafka:4.2.0`
+
+## Fixed
+
+### Tests - Datetime Utils
+
+- **Datetime Utils Test Alignment** - Fixed tests to match rolled-back implementation.

docs/community/changelog/4/index.md

@@ -9,6 +9,7 @@ description: "Release history for ArchiPy 4.x series"
 
 | Version           | Date       | Summary                                                                                         |
 |-------------------|------------|-------------------------------------------------------------------------------------------------|
+| [4.6.0](4.6.0.md) | 2026-04-27 | Parsian and Saman IPG async adapters, port interface extraction, and dependency updates     |
 | [4.5.0](4.5.0.md) | 2026-04-27 | Saman Shaparak adapter, DatetimeUtils caching refactor, and dependency updates                 |
 | [4.4.2](4.4.2.md) | 2026-04-15 | asyncmy to asyncmy2 migration, dev dependency refresh, and test container image updates         |
 | [4.4.1](4.4.1.md) | 2026-04-06 | Dependency refresh, regenerated lockfile, and typing cleanups for Keycloak and atomic decorator |

docs/community/changelog/index.md

@@ -9,7 +9,7 @@ All notable changes to ArchiPy are documented here, organized by major version s
 
 ## [4.x Series](4/index.md)
 
-17 releases — from 4.0.0 to 4.5.0
+18 releases — from 4.0.0 to 4.6.0
 
 ## [3.x Series](3/index.md)