Flask Wallet Charge Demo

این پروژه یک دمو ساده Flask برای شارژ کیف پول با استفاده از پکیج payexa از PyPI است.

پیش نیاز

• Python 3.10+
• دسترسی شبکه به PAYEXA

نصب

python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt

تنظیم env

cp .env.example .env

مقادیر مهم در .env:

• PAYEXA_BASE_URL=https://pay.pexn.ir
• PAYEXA_API_KEY=YOUR_API_KEY
• PAYEXA_MERCHANT_ID=
• APP_BASE_URL=http://127.0.0.1:5000

اگر DATABASE_PATH خالی باشد، پروژه از instance/wallet.sqlite3 استفاده می کند.

اجرا

source .venv/bin/activate
python app.py

بعد از اجرا اپ روی آدرس زیر در دسترس است:

http://127.0.0.1:5000

روند کار

1. مبلغ شارژ را در صفحه اصلی وارد می کنید.
2. اپ با PayexaClient درخواست پرداخت می سازد.
3. کاربر به درگاه منتقل می شود.
4. بعد از callback، اپ parse_callback و سپس verify_payment را اجرا می کند.
5. اگر verify موفق باشد، مبلغ به کیف پول SQLite اضافه می شود.

تست سریع

.venv/bin/python -c "from payexa import PayexaClient; print(PayexaClient)"
.venv/bin/python -c "from app import app; client = app.test_client(); print(client.get('/').status_code)"

نکته

برای callback واقعی، مقدار APP_BASE_URL باید از بیرون قابل دسترسی باشد. اگر روی localhost اجرا می کنید، فقط بخش local flow را راحت تست می کنید.