from abc import ABC, abstractmethod from dataclasses import dataclass @dataclass class PaymentCharge: """Unified payment charge object.""" id: str amount: float currency: str status: str # pending, confirmed, failed, etc. checkout_url: str = "" metadata: dict = None def __post_init__(self): if self.metadata is None: self.metadata = {} class PaymentProcessor(ABC): """Abstract base for all payment processors.""" @abstractmethod async def create_charge( self, amount: float, currency: str, metadata: dict ) -> PaymentCharge: """Create a payment charge.""" pass @abstractmethod async def verify_payment(self, charge_id: str) -> PaymentCharge: """Verify payment status.""" pass @abstractmethod def parse_webhook(self, payload: dict, signature: str) -> PaymentCharge: """Parse a webhook callback.""" pass