# Razorpay Payment Integration Architecture ## Dual Asynchronous Signal Architecture Browser callbacks and server webhooks are processed as **independent, asynchronous signals**. Order state confirmation does not rely on the browser remaining open. ```mermaid flowchart TD Razorpay["Razorpay Gateway"] Razorpay -.->|Signal 1: Browser Callback| Browser["FastAPI /payment/verify"] Razorpay -.->|Signal 2: Server Webhook| Webhook["FastAPI /payment/webhook"] subgraph Payment Processing Engine Browser --> IdempotencyCheck{"Payment Idempotency Guard\n(razorpay_payment_id)"} Webhook --> IdempotencyCheck IdempotencyCheck -->|First Time Received| VerifyHMAC["HMAC-SHA256 Verification"] IdempotencyCheck -->|Already Processed| ReturnExisting["Return Current Payment Status (ACK)"] VerifyHMAC --> PaymentLedger["Record in Payment Ledger"] PaymentLedger --> OrderStateMachine["Transition Order State\n(PAYMENT_CAPTURED -> ORDER_CONFIRMED)"] end ``` --- ## HMAC-SHA256 Verification Formula ```python import hmac import hashlib def verify_razorpay_signature(order_id: str, payment_id: str, signature: str, secret: str) -> bool: generated_signature = hmac.new( key=secret.encode('utf-8'), msg=f"{order_id}|{payment_id}".encode('utf-8'), digestmod=hashlib.sha256 ).hexdigest() return hmac.compare_digest(generated_signature, signature) ```