import logging import json import asyncio from datetime import datetime, timezone, timedelta from typing import Optional, Dict, Any from aiohttp import web from aiogram import Bot from sqlalchemy.ext.asyncio import AsyncSession from sqlalchemy.orm import sessionmaker from yookassa.domain.notification import WebhookNotification from yookassa.domain.models.amount import Amount as YooKassaAmount from db.dal import payment_dal, user_dal, user_billing_dal from bot.services.subscription_service import SubscriptionService from bot.services.referral_service import ReferralService from bot.services.panel_api_service import PanelApiService from bot.services.yookassa_service import YooKassaService from bot.middlewares.i18n import JsonI18n from config.settings import Settings from bot.services.notification_service import NotificationService from bot.keyboards.inline.user_keyboards import get_connect_and_main_keyboard payment_processing_lock = asyncio.Lock() YOOKASSA_EVENT_PAYMENT_SUCCEEDED = 'payment.succeeded' YOOKASSA_EVENT_PAYMENT_CANCELED = 'payment.canceled' YOOKASSA_EVENT_PAYMENT_WAITING_FOR_CAPTURE = 'payment.waiting_for_capture' async def process_successful_payment(session: AsyncSession, bot: Bot, payment_info_from_webhook: dict, i18n: JsonI18n, settings: Settings, panel_service: PanelApiService, subscription_service: SubscriptionService, referral_service: ReferralService): metadata = payment_info_from_webhook.get("metadata", {}) user_id_str = metadata.get("user_id") subscription_months_str = metadata.get("subscription_months") promo_code_id_str = metadata.get("promo_code_id") payment_db_id_str = metadata.get("payment_db_id") auto_renew_subscription_id_str = metadata.get( "auto_renew_for_subscription_id") # For auto-renew payments, payment_db_id may be absent. In that case, # we will create/ensure a payment record idempotently using provider payment id. if (not user_id_str or not subscription_months_str or (not payment_db_id_str and not auto_renew_subscription_id_str)): logging.error( f"Missing crucial metadata for payment: {payment_info_from_webhook.get('id')}, metadata: {metadata}" ) return db_user = None try: user_id = int(user_id_str) subscription_months = int(subscription_months_str) payment_db_id = int( payment_db_id_str) if payment_db_id_str and payment_db_id_str.isdigit() else None is_auto_renew = bool(auto_renew_subscription_id_str and not payment_db_id) promo_code_id = int( promo_code_id_str ) if promo_code_id_str and promo_code_id_str.isdigit() else None amount_data = payment_info_from_webhook.get("amount", {}) payment_value = float(amount_data.get("value", 0.0)) # If this is an auto-renewal (no payment_db_id in metadata), ensure a payment record exists if payment_db_id is None and auto_renew_subscription_id_str: try: # Create/ensure provider payment by YooKassa payment id for idempotency yk_payment_id_from_hook = payment_info_from_webhook.get("id") from db.dal import payment_dal as _payment_dal ensured_payment = await _payment_dal.ensure_payment_with_provider_id( session, user_id=user_id, amount=payment_value, currency=amount_data.get("currency", settings.DEFAULT_CURRENCY_SYMBOL), months=subscription_months, description=payment_info_from_webhook.get( "description") or f"Auto-renewal for {subscription_months} months", provider="yookassa", provider_payment_id=yk_payment_id_from_hook, ) payment_db_id = ensured_payment.payment_id # Also persist yookassa_payment_id field if not set yet try: await _payment_dal.update_payment_status_by_db_id( session, payment_db_id, payment_info_from_webhook.get("status", "succeeded"), yk_payment_id_from_hook, ) except Exception: # Non-fatal; continue processing logging.exception( "Failed to backfill yookassa_payment_id for ensured auto-renew payment" ) except Exception as e_ensure: logging.error( f"Failed to ensure payment record for auto-renew webhook (YK {payment_info_from_webhook.get('id')}): {e_ensure}", exc_info=True, ) return db_user = await user_dal.get_user_by_id(session, user_id) if not db_user: logging.error( f"User {user_id} not found in DB during successful payment processing for YK ID {payment_info_from_webhook.get('id')}. Payment record {payment_db_id}." ) await payment_dal.update_payment_status_by_db_id( session, payment_db_id, "failed_user_not_found", payment_info_from_webhook.get("id")) return except (TypeError, ValueError) as e: logging.error( f"Invalid metadata format for payment processing: {metadata} - {e}" ) if payment_db_id_str and payment_db_id_str.isdigit(): try: await payment_dal.update_payment_status_by_db_id( session, int(payment_db_id_str), "failed_metadata_error", payment_info_from_webhook.get("id")) except Exception as e_upd: logging.error( f"Failed to update payment status after metadata error: {e_upd}" ) return try: yk_payment_id_from_hook = payment_info_from_webhook.get("id") # Try to capture and save payment method for future charges if available try: payment_method = payment_info_from_webhook.get("payment_method") if isinstance(payment_method, dict) and payment_method.get("saved", False): pm_id = payment_method.get("id") card = payment_method.get("card") or {} await user_billing_dal.upsert_yk_payment_method( session, user_id=user_id, payment_method_id=pm_id, card_last4=card.get("last4"), card_network=card.get("card_type"), ) except Exception: logging.exception("Failed to persist YooKassa payment method from webhook") updated_payment_record = await payment_dal.update_payment_status_by_db_id( session, payment_db_id=payment_db_id, new_status=payment_info_from_webhook.get("status", "succeeded"), yk_payment_id=yk_payment_id_from_hook) if not updated_payment_record: logging.error( f"Failed to update payment record {payment_db_id} for yk_id {yk_payment_id_from_hook}" ) raise Exception( f"DB Error: Could not update payment record {payment_db_id}") activation_details = await subscription_service.activate_subscription( session, user_id, subscription_months, payment_value, payment_db_id, promo_code_id_from_payment=promo_code_id, provider="yookassa") if not activation_details or not activation_details.get('end_date'): logging.error( f"Failed to activate subscription for user {user_id} after payment {yk_payment_id_from_hook}" ) raise Exception( f"Subscription Error: Failed to activate for user {user_id}") base_subscription_end_date = activation_details['end_date'] final_end_date_for_user = base_subscription_end_date applied_promo_bonus_days = activation_details.get( "applied_promo_bonus_days", 0) referral_bonus_info = await referral_service.apply_referral_bonuses_for_payment( session, user_id, subscription_months, current_payment_db_id=payment_db_id, skip_if_active_before_payment=False, ) applied_referee_bonus_days_from_referral: Optional[int] = None if referral_bonus_info and referral_bonus_info.get( "referee_new_end_date"): final_end_date_for_user = referral_bonus_info[ "referee_new_end_date"] applied_referee_bonus_days_from_referral = referral_bonus_info.get( "referee_bonus_applied_days") user_lang = db_user.language_code if db_user and db_user.language_code else settings.DEFAULT_LANGUAGE _ = lambda key, **kwargs: i18n.gettext(user_lang, key, **kwargs) # For auto-renew charges, avoid re-sending config link; send concise message if is_auto_renew and final_end_date_for_user: details_message = _( "yookassa_auto_renewal", months=subscription_months, end_date=final_end_date_for_user.strftime('%Y-%m-%d'), ) details_markup = None else: config_link = activation_details.get("subscription_url") or _( "config_link_not_available" ) if applied_referee_bonus_days_from_referral and final_end_date_for_user: inviter_name_display = _("friend_placeholder") if db_user and db_user.referred_by_id: inviter = await user_dal.get_user_by_id( session, db_user.referred_by_id) if inviter and inviter.first_name: inviter_name_display = inviter.first_name elif inviter and inviter.username: inviter_name_display = f"@{inviter.username}" details_message = _( "payment_successful_with_referral_bonus_full", months=subscription_months, base_end_date=base_subscription_end_date.strftime('%Y-%m-%d'), bonus_days=applied_referee_bonus_days_from_referral, final_end_date=final_end_date_for_user.strftime('%Y-%m-%d'), inviter_name=inviter_name_display, config_link=config_link, ) elif applied_promo_bonus_days > 0 and final_end_date_for_user: details_message = _( "payment_successful_with_promo_full", months=subscription_months, bonus_days=applied_promo_bonus_days, end_date=final_end_date_for_user.strftime('%Y-%m-%d'), config_link=config_link, ) elif final_end_date_for_user: details_message = _( "payment_successful_full", months=subscription_months, end_date=final_end_date_for_user.strftime('%Y-%m-%d'), config_link=config_link, ) else: logging.error( f"Critical error: final_end_date_for_user is None for user {user_id} after successful payment logic." ) details_message = _("payment_successful_error_details") details_markup = get_connect_and_main_keyboard( user_lang, i18n, settings, config_link ) try: await bot.send_message( user_id, details_message, reply_markup=details_markup, parse_mode="HTML", disable_web_page_preview=True, ) except Exception as e_notify: logging.error( f"Failed to send payment details message to user {user_id}: {e_notify}" ) # Send notification about payment try: notification_service = NotificationService(bot, settings, i18n) user = await user_dal.get_user_by_id(session, user_id) await notification_service.notify_payment_received( user_id=user_id, amount=payment_value, currency=settings.DEFAULT_CURRENCY_SYMBOL, months=subscription_months, payment_provider="yookassa", # This is specifically for YooKassa webhook username=user.username if user else None ) except Exception as e: logging.error(f"Failed to send payment notification: {e}") except Exception as e_process: logging.error( f"Error during process_successful_payment main try block for user {user_id}: {e_process}", exc_info=True) raise async def process_cancelled_payment(session: AsyncSession, bot: Bot, payment_info_from_webhook: dict, i18n: JsonI18n, settings: Settings): metadata = payment_info_from_webhook.get("metadata", {}) user_id_str = metadata.get("user_id") payment_db_id_str = metadata.get("payment_db_id") if not user_id_str or not payment_db_id_str: logging.warning( f"Missing metadata in cancelled payment webhook: {payment_info_from_webhook.get('id')}" ) return try: user_id = int(user_id_str) payment_db_id = int(payment_db_id_str) except ValueError: logging.error( f"Invalid metadata in cancelled payment webhook: {metadata}") return try: updated_payment = await payment_dal.update_payment_status_by_db_id( session, payment_db_id=payment_db_id, new_status=payment_info_from_webhook.get("status", "canceled"), yk_payment_id=payment_info_from_webhook.get("id")) if updated_payment: logging.info( f"Payment {payment_db_id} (YK: {payment_info_from_webhook.get('id')}) status updated to cancelled for user {user_id}." ) else: logging.warning( f"Could not find payment record {payment_db_id} to update status to cancelled for user {user_id}." ) db_user = await user_dal.get_user_by_id(session, user_id) user_lang = settings.DEFAULT_LANGUAGE if db_user and db_user.language_code: user_lang = db_user.language_code _ = lambda key, **kwargs: i18n.gettext(user_lang, key, **kwargs) await bot.send_message(user_id, _("payment_failed")) except Exception as e_process_cancel: logging.error( f"Error processing cancelled payment for user {user_id}, payment_db_id {payment_db_id}: {e_process_cancel}", exc_info=True) raise async def yookassa_webhook_route(request: web.Request): try: bot: Bot = request.app['bot'] i18n_instance: JsonI18n = request.app['i18n'] settings: Settings = request.app['settings'] panel_service: PanelApiService = request.app['panel_service'] subscription_service: SubscriptionService = request.app[ 'subscription_service'] referral_service: ReferralService = request.app['referral_service'] async_session_factory: sessionmaker = request.app[ 'async_session_factory'] except KeyError as e_app_ctx: logging.error( f"KeyError accessing app context in yookassa_webhook_route: {e_app_ctx}.", exc_info=True) return web.Response( status=500, text="Internal Server Error: Missing app context component") try: event_json = await request.json() notification_object = WebhookNotification(event_json) payment_data_from_notification = notification_object.object logging.info( f"YooKassa Webhook Parsed: Event='{notification_object.event}', " f"PaymentId='{payment_data_from_notification.id}', Status='{payment_data_from_notification.status}'" ) if not payment_data_from_notification or not hasattr( payment_data_from_notification, 'metadata') or payment_data_from_notification.metadata is None: logging.error( f"YooKassa webhook payment {payment_data_from_notification.id} lacks metadata. Cannot process." ) return web.Response(status=200, text="ok_error_no_metadata") # Safely extract payment_method details (SDK objects may not have to_dict) pm_obj = getattr(payment_data_from_notification, 'payment_method', None) pm_dict = None if pm_obj is not None: try: card_obj = getattr(pm_obj, 'card', None) pm_dict = { "id": getattr(pm_obj, 'id', None), "type": getattr(pm_obj, 'type', None), "saved": bool(getattr(pm_obj, 'saved', False)), "title": getattr(pm_obj, 'title', None), "card": ( { "first6": getattr(card_obj, 'first6', None), "last4": getattr(card_obj, 'last4', None), "expiry_month": getattr(card_obj, 'expiry_month', None), "expiry_year": getattr(card_obj, 'expiry_year', None), "card_type": getattr(card_obj, 'card_type', None), } if card_obj is not None else None ), } except Exception: logging.exception("Failed to serialize YooKassa payment_method from webhook") pm_dict = None payment_dict_for_processing = { "id": str(payment_data_from_notification.id), "status": str(payment_data_from_notification.status), "paid": bool(payment_data_from_notification.paid), "amount": { "value": str(payment_data_from_notification.amount.value), "currency": str(payment_data_from_notification.amount.currency) } if payment_data_from_notification.amount else {}, "metadata": dict(payment_data_from_notification.metadata), "description": str(payment_data_from_notification.description) if payment_data_from_notification.description else None, "payment_method": pm_dict, } async with payment_processing_lock: async with async_session_factory() as session: try: if notification_object.event == YOOKASSA_EVENT_PAYMENT_SUCCEEDED: if payment_dict_for_processing.get( "paid") and payment_dict_for_processing.get( "status") == "succeeded": await process_successful_payment( session, bot, payment_dict_for_processing, i18n_instance, settings, panel_service, subscription_service, referral_service) await session.commit() else: logging.warning( f"Payment Succeeded event for {payment_dict_for_processing.get('id')} " f"but data not as expected: status='{payment_dict_for_processing.get('status')}', " f"paid='{payment_dict_for_processing.get('paid')}'" ) elif notification_object.event == YOOKASSA_EVENT_PAYMENT_CANCELED: await process_cancelled_payment( session, bot, payment_dict_for_processing, i18n_instance, settings) await session.commit() elif notification_object.event == YOOKASSA_EVENT_PAYMENT_WAITING_FOR_CAPTURE: # Bind-only flow: save method and cancel auth if metadata has bind_only metadata = payment_dict_for_processing.get("metadata", {}) or {} if metadata.get("bind_only") == "1": try: user_id_str = metadata.get("user_id") if user_id_str and user_id_str.isdigit(): user_id = int(user_id_str) payment_method = payment_dict_for_processing.get("payment_method") if isinstance(payment_method, dict) and payment_method.get("id"): card = payment_method.get("card") or {} await user_billing_dal.upsert_yk_payment_method( session, user_id=user_id, payment_method_id=payment_method.get("id"), card_last4=card.get("last4"), card_network=card.get("card_type"), ) await session.commit() # Attempt to cancel the authorization to avoid charge hold try: yk: YooKassaService = request.app.get('yookassa_service') if yk: await yk.cancel_payment(payment_dict_for_processing.get("id")) except Exception: logging.exception("Failed to cancel bind-only payment auth") except Exception: logging.exception("Failed to handle bind-only waiting_for_capture webhook") except Exception as e_webhook_db_processing: await session.rollback() logging.error( f"Error processing YooKassa webhook event '{notification_object.event}' " f"for YK Payment ID {payment_dict_for_processing.get('id')} in DB transaction: {e_webhook_db_processing}", exc_info=True) return web.Response( status=200, text="ok_internal_processing_error_logged") return web.Response(status=200, text="ok") except json.JSONDecodeError: logging.error("YooKassa Webhook: Invalid JSON received.") return web.Response(status=400, text="bad_request_invalid_json") except Exception as e_general_webhook: logging.error( f"YooKassa Webhook general processing error: {e_general_webhook}", exc_info=True) return web.Response(status=200, text="ok_general_internal_error_logged")