bpay 0.1.0__tar.gz

bpay-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

bpay-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

bpay-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ayon
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bpay-0.1.0/Makefile

@@ -0,0 +1,35 @@
+.PHONY: install sync test lint format typecheck check clean build
+
+install:
+	uv sync
+
+sync:
+	uv sync
+
+test:
+	uv run pytest
+
+lint:
+	uv run ruff check .
+
+format:
+	uv run ruff format .
+
+typecheck:
+	uv run mypy src
+
+check:
+	uv run ruff check .
+	uv run mypy src
+	uv run pytest
+
+build:
+	uv build
+
+clean:
+	rm -rf .pytest_cache
+	rm -rf .mypy_cache
+	rm -rf .ruff_cache
+	rm -rf dist
+	rm -rf build
+	find . -type d -name "__pycache__" -exec rm -rf {} +

bpay-0.1.0/PKG-INFO

@@ -0,0 +1,293 @@
+Metadata-Version: 2.4
+Name: bpay
+Version: 0.1.0
+Summary: Unified Python SDK for Bangladeshi payment gateways
+Project-URL: Homepage, https://github.com/thatsayon/bpay-python
+Project-URL: Repository, https://github.com/thatsayon/bpay-python
+Project-URL: Issues, https://github.com/thatsayon/bpay-python/issues
+Author: Ayon
+License: MIT
+License-File: LICENSE
+Keywords: bangladesh,bkash,nagad,payments,sslcommerz
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.13.4
+Description-Content-Type: text/markdown
+
+# bpay
+
+Unified Python SDK for Bangladeshi payment gateways.
+
+`bpay` provides a clean, typed, async-first developer experience for integrating Bangladeshi payment providers like bKash, Nagad, and SSLCommerz.
+
+---
+
+## Features
+
+- Async-first architecture
+- Typed request & response models
+- Sandbox & production environment support
+- Hosted checkout workflows
+- Agreement/tokenized checkout support
+- Payment callback parsing
+- Payment verification support
+- Provider abstraction layer
+- Modern Python packaging with `uv`
+
+---
+
+## Supported Providers
+
+| Provider | Status |
+|---|---|
+| bKash | In Progress |
+| Nagad | Planned |
+| SSLCommerz | Planned |
+
+---
+
+## Installation
+
+```bash
+pip install bpay
+```
+
+---
+
+## Quick Start
+
+### Create a One-Time Payment
+
+```python
+import asyncio
+
+from bpay import BPay
+from bpay.config.environments import (
+    Environment,
+)
+from bpay.schemas.payment import (
+    CreatePaymentRequest,
+)
+
+
+async def main() -> None:
+    client = BPay(
+        provider="bkash",
+        environment=Environment.SANDBOX,
+        username="YOUR_USERNAME",
+        password="YOUR_PASSWORD",
+        app_key="YOUR_APP_KEY",
+        app_secret="YOUR_APP_SECRET",
+    )
+
+    payment = await client.create_payment(
+        CreatePaymentRequest(
+            amount=100,
+            merchant_invoice_number="INV-1001",
+            callback_url=(
+                "https://yourdomain.com/callback"
+            ),
+        )
+    )
+
+    print(payment.checkout_url)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## Agreement / Tokenized Checkout
+
+Agreements allow merchants to create reusable customer payment authorizations for recurring or saved payments.
+
+### Create Agreement
+
+```python
+import asyncio
+
+from bpay import BPay
+from bpay.config.environments import (
+    Environment,
+)
+from bpay.schemas.agreement import (
+    CreateAgreementRequest,
+)
+
+
+async def main() -> None:
+    client = BPay(
+        provider="bkash",
+        environment=Environment.SANDBOX,
+        username="YOUR_USERNAME",
+        password="YOUR_PASSWORD",
+        app_key="YOUR_APP_KEY",
+        app_secret="YOUR_APP_SECRET",
+    )
+
+    agreement = await (
+        client.create_agreement(
+            CreateAgreementRequest(
+                customer_phone="017XXXXXXXX",
+                callback_url=(
+                    "https://yourdomain.com/callback"
+                ),
+            )
+        )
+    )
+
+    print(agreement.checkout_url)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## Callback Parsing
+
+### Payment Callback
+
+```python
+from bpay import BPay
+
+client = BPay(...)
+
+callback = client.parse_payment_callback(
+    {
+        "paymentID": "PAY123",
+        "status": "success",
+        "signature": "abc123",
+    }
+)
+
+print(callback.status)
+```
+
+---
+
+### Agreement Callback
+
+```python
+from bpay import BPay
+
+client = BPay(...)
+
+callback = (
+    client.parse_agreement_callback(
+        {
+            "paymentID": "PAY123",
+            "agreementID": "AGR123",
+            "status": "success",
+            "signature": "abc123",
+        }
+    )
+)
+
+print(callback.status)
+```
+
+---
+
+## Payment Verification
+
+```python
+verification = await client.verify_payment(
+    payment_id="PAY123"
+)
+
+print(verification.status)
+```
+
+---
+
+## Environments
+
+`bpay` supports both sandbox and production environments.
+
+### Sandbox
+
+```python
+from bpay.config.environments import (
+    Environment,
+)
+
+Environment.SANDBOX
+```
+
+### Production
+
+```python
+from bpay.config.environments import (
+    Environment,
+)
+
+Environment.PRODUCTION
+```
+
+---
+
+## Development
+
+### Setup
+
+```bash
+uv sync
+```
+
+### Run Checks
+
+```bash
+make check
+```
+
+### Run Tests
+
+```bash
+uv run pytest
+```
+
+---
+
+## Project Structure
+
+```text
+src/bpay/
+├── client.py
+├── exceptions.py
+├── config/
+├── providers/
+├── schemas/
+├── transports/
+└── types.py
+```
+
+---
+
+## Roadmap
+
+- Full bKash recurring payment workflow
+- Nagad integration
+- SSLCommerz integration
+- Refund support
+- Webhook signature verification
+- Automatic retry handling
+- Sync client support
+- Logging middleware
+
+---
+
+## License
+
+MIT License

bpay-0.1.0/README.md

@@ -0,0 +1,269 @@
+# bpay
+
+Unified Python SDK for Bangladeshi payment gateways.
+
+`bpay` provides a clean, typed, async-first developer experience for integrating Bangladeshi payment providers like bKash, Nagad, and SSLCommerz.
+
+---
+
+## Features
+
+- Async-first architecture
+- Typed request & response models
+- Sandbox & production environment support
+- Hosted checkout workflows
+- Agreement/tokenized checkout support
+- Payment callback parsing
+- Payment verification support
+- Provider abstraction layer
+- Modern Python packaging with `uv`
+
+---
+
+## Supported Providers
+
+| Provider | Status |
+|---|---|
+| bKash | In Progress |
+| Nagad | Planned |
+| SSLCommerz | Planned |
+
+---
+
+## Installation
+
+```bash
+pip install bpay
+```
+
+---
+
+## Quick Start
+
+### Create a One-Time Payment
+
+```python
+import asyncio
+
+from bpay import BPay
+from bpay.config.environments import (
+    Environment,
+)
+from bpay.schemas.payment import (
+    CreatePaymentRequest,
+)
+
+
+async def main() -> None:
+    client = BPay(
+        provider="bkash",
+        environment=Environment.SANDBOX,
+        username="YOUR_USERNAME",
+        password="YOUR_PASSWORD",
+        app_key="YOUR_APP_KEY",
+        app_secret="YOUR_APP_SECRET",
+    )
+
+    payment = await client.create_payment(
+        CreatePaymentRequest(
+            amount=100,
+            merchant_invoice_number="INV-1001",
+            callback_url=(
+                "https://yourdomain.com/callback"
+            ),
+        )
+    )
+
+    print(payment.checkout_url)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## Agreement / Tokenized Checkout
+
+Agreements allow merchants to create reusable customer payment authorizations for recurring or saved payments.
+
+### Create Agreement
+
+```python
+import asyncio
+
+from bpay import BPay
+from bpay.config.environments import (
+    Environment,
+)
+from bpay.schemas.agreement import (
+    CreateAgreementRequest,
+)
+
+
+async def main() -> None:
+    client = BPay(
+        provider="bkash",
+        environment=Environment.SANDBOX,
+        username="YOUR_USERNAME",
+        password="YOUR_PASSWORD",
+        app_key="YOUR_APP_KEY",
+        app_secret="YOUR_APP_SECRET",
+    )
+
+    agreement = await (
+        client.create_agreement(
+            CreateAgreementRequest(
+                customer_phone="017XXXXXXXX",
+                callback_url=(
+                    "https://yourdomain.com/callback"
+                ),
+            )
+        )
+    )
+
+    print(agreement.checkout_url)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+---
+
+## Callback Parsing
+
+### Payment Callback
+
+```python
+from bpay import BPay
+
+client = BPay(...)
+
+callback = client.parse_payment_callback(
+    {
+        "paymentID": "PAY123",
+        "status": "success",
+        "signature": "abc123",
+    }
+)
+
+print(callback.status)
+```
+
+---
+
+### Agreement Callback
+
+```python
+from bpay import BPay
+
+client = BPay(...)
+
+callback = (
+    client.parse_agreement_callback(
+        {
+            "paymentID": "PAY123",
+            "agreementID": "AGR123",
+            "status": "success",
+            "signature": "abc123",
+        }
+    )
+)
+
+print(callback.status)
+```
+
+---
+
+## Payment Verification
+
+```python
+verification = await client.verify_payment(
+    payment_id="PAY123"
+)
+
+print(verification.status)
+```
+
+---
+
+## Environments
+
+`bpay` supports both sandbox and production environments.
+
+### Sandbox
+
+```python
+from bpay.config.environments import (
+    Environment,
+)
+
+Environment.SANDBOX
+```
+
+### Production
+
+```python
+from bpay.config.environments import (
+    Environment,
+)
+
+Environment.PRODUCTION
+```
+
+---
+
+## Development
+
+### Setup
+
+```bash
+uv sync
+```
+
+### Run Checks
+
+```bash
+make check
+```
+
+### Run Tests
+
+```bash
+uv run pytest
+```
+
+---
+
+## Project Structure
+
+```text
+src/bpay/
+├── client.py
+├── exceptions.py
+├── config/
+├── providers/
+├── schemas/
+├── transports/
+└── types.py
+```
+
+---
+
+## Roadmap
+
+- Full bKash recurring payment workflow
+- Nagad integration
+- SSLCommerz integration
+- Refund support
+- Webhook signature verification
+- Automatic retry handling
+- Sync client support
+- Logging middleware
+
+---
+
+## License
+
+MIT License

bpay-0.1.0/examples/bkash_auth.py

@@ -0,0 +1,24 @@
+import asyncio
+
+from bpay.providers.bkash.auth import BkashAuth
+from bpay.providers.bkash.schemas import BkashCredentials
+
+
+async def main() -> None:
+    credentials = BkashCredentials(
+        username="sandboxTokenizedUser02",
+        password="sandboxTokenizedUser02@12345",
+        app_key="4f6o0cjiki2rfm34kfdadl1eqq",
+        app_secret="2is7hdktrekvrbljjh44ll3d9l1dtjo4pasmjvs5vl5qr3fug4b",
+    )
+
+    auth = BkashAuth(credentials=credentials)
+
+    token = await auth.authenticate()
+
+    print("Token Type:", token.token_type)
+    print("Expires In:", token.expires_in)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

bpay-0.1.0/examples/bkash_example.py

@@ -0,0 +1,14 @@
+import asyncio
+
+from bpay.client import BPay
+
+
+async def main() -> None:
+    client = BPay(provider="bkash")
+
+    result = await client.provider.create_payment()
+
+    print(result)
+
+
+asyncio.run(main())

bpay-0.1.0/examples/callback_example.py

@@ -0,0 +1,14 @@
+from bpay.providers.bkash.callbacks import (
+    parse_agreement_callback,
+)
+
+params = {
+    "paymentID": "TR001",
+    "status": "success",
+    "signature": "abc123",
+    "agreementID": "AGR001",
+}
+
+callback = parse_agreement_callback(params)
+
+print(callback)