{"openapi":"3.1.0","info":{"title":"AI Revenue Recovery Engine","description":"Autonomous engine that detects, diagnoses, and recovers failed payments.","version":"0.1.0"},"paths":{"/api/v1/webhooks/razorpay/payment":{"post":{"tags":["Webhooks"],"summary":"Razorpay payment webhook","description":"Full pipeline: signature validation → parse → classify → store → enqueue.\nIdempotent: duplicate payment_id returns 200 with status=duplicate.","operationId":"razorpay_payment_webhook_api_v1_webhooks_razorpay_payment_post","parameters":[{"name":"X-Razorpay-Signature","in":"header","required":true,"schema":{"type":"string","title":"X-Razorpay-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/webhooks/razorpay/order":{"post":{"tags":["Webhooks"],"summary":"Razorpay order webhook","description":"Order-level events — stored for audit, not routed to recovery pipeline.","operationId":"razorpay_order_webhook_api_v1_webhooks_razorpay_order_post","parameters":[{"name":"X-Razorpay-Signature","in":"header","required":true,"schema":{"type":"string","title":"X-Razorpay-Signature"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities":{"get":{"tags":["Recovery Opportunities"],"summary":"List recovery opportunities","description":"Returns paginated list of recovery opportunities with optional filters.","operationId":"list_opportunities_api_v1_opportunities_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by status","title":"Status"},"description":"Filter by status"},{"name":"priority","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by priority","title":"Priority"},"description":"Filter by priority"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RecoveryOpportunityRead"},"title":"Response List Opportunities Api V1 Opportunities Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/{opportunity_id}/agent-trace":{"get":{"tags":["Recovery Opportunities"],"summary":"Get formatted agent trace for all 6 recovery stages","description":"Returns formatted step-by-step outputs of all 6 agents (Detect, Diagnose, Strategy, Policy, Action, Outcome)\nfor a given recovery opportunity.","operationId":"get_opportunity_agent_trace_api_v1_opportunities__opportunity_id__agent_trace_get","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/{opportunity_id}":{"get":{"tags":["Recovery Opportunities"],"summary":"Get opportunity detail","description":"Returns a single opportunity by ID.","operationId":"get_opportunity_api_v1_opportunities__opportunity_id__get","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecoveryOpportunityRead"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/detect":{"post":{"tags":["Recovery Opportunities"],"summary":"Run Detection Agent on payment event","description":"Evaluates payment event eligibility, calculates recoverability score,\nassigns priority, and idempotently creates RecoveryOpportunity + WorkflowState.","operationId":"run_detection_agent_api_v1_opportunities_detect_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetectionInput"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/{opportunity_id}/diagnose":{"post":{"tags":["Recovery Opportunities"],"summary":"Run Diagnosis Agent on opportunity","description":"Diagnoses failure cause using failure_taxonomy.yaml and customer history,\ntransitions WorkflowState to DIAGNOSED, and logs audit record.","operationId":"run_diagnosis_agent_api_v1_opportunities__opportunity_id__diagnose_post","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/{opportunity_id}/select-strategy":{"post":{"tags":["Recovery Opportunities"],"summary":"Run Recovery Strategy Engine on opportunity","description":"Evaluates candidate interventions using Expected Net Recovery formula,\nranks actions by expected value, creates RecoveryDecision, and transitions WorkflowState.","operationId":"run_strategy_agent_api_v1_opportunities__opportunity_id__select_strategy_post","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/{opportunity_id}/evaluate-policy":{"post":{"tags":["Recovery Opportunities"],"summary":"Run Policy Gateway evaluation on opportunity","description":"Enforces hard merchant policy guardrails (retry limits, allowed channels, cost caps, approval thresholds).\nIssues signed HMAC clearance token on approval or queues for human review.","operationId":"evaluate_opportunity_policy_api_v1_opportunities__opportunity_id__evaluate_policy_post","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/{opportunity_id}/execute-action":{"post":{"tags":["Recovery Opportunities"],"summary":"Run Action Agent to execute intervention","description":"Verifies signed clearance token signature and dispatches intervention call to Razorpay sandbox.\nCreates Intervention record and transitions WorkflowState to EXECUTING.","operationId":"execute_opportunity_action_api_v1_opportunities__opportunity_id__execute_action_post","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}},{"name":"x-clearance-token","in":"header","required":true,"schema":{"type":"string","description":"Signed HMAC clearance token","title":"X-Clearance-Token"},"description":"Signed HMAC clearance token"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/opportunities/{opportunity_id}/record-outcome":{"post":{"tags":["Recovery Opportunities"],"summary":"Record recovery outcome for opportunity","description":"Evaluates time-window attribution and TREATMENT vs CONTROL baseline incrementality,\nrecords RecoveryOutcome, updates strategy probability feedback matrix, and updates workflow state to RECOVERED or FAILED.","operationId":"record_opportunity_outcome_api_v1_opportunities__opportunity_id__record_outcome_post","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomeRecordRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/metrics/recovery-summary":{"get":{"tags":["Metrics"],"summary":"Aggregate recovery summary KPIs","description":"Returns aggregated business metrics:\ntotal_opportunities, recovery_rate_pct, total_expected_revenue,\ntotal_recovered_amount, total_incremental_recovery, total_intervention_cost, net_incremental_revenue, roi_pct","operationId":"recovery_metrics_api_v1_metrics_recovery_summary_get","parameters":[{"name":"period_days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Period Days"}},{"name":"merchant_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Merchant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/metrics/incrementality":{"get":{"tags":["Metrics"],"summary":"A/B experiment incrementality results","description":"Returns incrementality data comparing TREATMENT vs CONTROL baseline conversion lift.","operationId":"incrementality_metrics_api_v1_metrics_incrementality_get","parameters":[{"name":"period_days","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"default":30,"title":"Period Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/audit":{"get":{"tags":["Audit"],"summary":"Paginated audit log","description":"Returns immutable audit trail of all financial actions.\nSupports filtering by entity, actor, and time range.\n100% coverage required — every financial action must appear here.","operationId":"list_audit_logs_api_v1_audit_get","parameters":[{"name":"entity_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Type"}},{"name":"entity_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entity Id"}},{"name":"actor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Actor"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/AuditLogRead"},"title":"Response List Audit Logs Api V1 Audit Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/approvals":{"get":{"tags":["Human Approvals"],"summary":"List pending human approvals","description":"Returns list of opportunities currently awaiting human manager approval.","operationId":"list_pending_approvals_api_v1_approvals_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/approvals/{opportunity_id}/approve":{"post":{"tags":["Human Approvals"],"summary":"Approve a pending recovery decision","description":"Human manager approves an above-threshold recovery opportunity.\nIssues signed HMAC clearance token, executes intervention action, and records recovery outcome.","operationId":"approve_recovery_decision_api_v1_approvals__opportunity_id__approve_post","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/approvals/{opportunity_id}/reject":{"post":{"tags":["Human Approvals"],"summary":"Reject a pending recovery decision","description":"Human manager rejects an above-threshold recovery opportunity.\nAdvances workflow state to POLICY_REJECTED.","operationId":"reject_recovery_decision_api_v1_approvals__opportunity_id__reject_post","parameters":[{"name":"opportunity_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Opportunity Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApprovalDecision"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/merchants/{merchant_id}/policy":{"get":{"tags":["Merchants"],"summary":"Get merchant recovery policy","description":"Returns the active recovery policy for a merchant.","operationId":"get_merchant_policy_api_v1_merchants__merchant_id__policy_get","parameters":[{"name":"merchant_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Merchant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyRead-Output"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"tags":["Merchants"],"summary":"Update merchant recovery policy","description":"Updates merchant recovery policy. Creates new version — old version preserved.\nPolicy changes take effect on next workflow execution.","operationId":"update_merchant_policy_api_v1_merchants__merchant_id__policy_put","parameters":[{"name":"merchant_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Merchant Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyRead-Output"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/merchants/simulate-payment":{"post":{"tags":["Merchants","Development"],"summary":"Inject synthetic payment failure event (dev/test only)","description":"Injects a synthetic failed payment event for testing the recovery pipeline.\nOnly available in development environment.","operationId":"simulate_payment_failure_api_v1_merchants_simulate_payment_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/simulate/payment-failure":{"post":{"tags":["Development / Simulation"],"summary":"Inject a synthetic failed payment event","description":"Creates a synthetic failed PaymentEvent and runs through the complete\nrecovery pipeline (ingest → detect → diagnose → select strategy → evaluate policy).\nSimulated events instantly generate RecoveryOpportunities and PendingApprovals in DB.","operationId":"simulate_payment_failure_api_v1_simulate_payment_failure_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulatePaymentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/simulate/batch":{"post":{"tags":["Development / Simulation"],"summary":"Inject a batch of synthetic payment failures","description":"Injects `count` synthetic payment failures with the given failure_code.\nUseful for populating data for dashboard testing.","operationId":"simulate_batch_api_v1_simulate_batch_post","parameters":[{"name":"count","in":"query","required":false,"schema":{"type":"integer","default":10,"title":"Count"}},{"name":"failure_code","in":"query","required":false,"schema":{"type":"string","default":"GATEWAY_ERROR","title":"Failure Code"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/":{"get":{"tags":["System"],"summary":"Root status check","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["System"],"summary":"Service health check","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ApprovalDecision":{"properties":{"approved":{"type":"boolean","title":"Approved"},"reviewer_id":{"type":"string","title":"Reviewer Id","description":"ID or email of approving manager"},"notes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Notes","description":"Optional reviewer feedback"}},"type":"object","required":["approved","reviewer_id"],"title":"ApprovalDecision"},"AuditLogRead":{"properties":{"entity_type":{"type":"string","title":"Entity Type"},"entity_id":{"type":"string","format":"uuid","title":"Entity Id"},"actor":{"type":"string","title":"Actor"},"action":{"type":"string","title":"Action"},"input_snapshot":{"type":"object","title":"Input Snapshot"},"output_snapshot":{"type":"object","title":"Output Snapshot"},"model_version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Version"},"confidence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Confidence"},"policy_applied":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Policy Applied"},"audit_id":{"type":"string","format":"uuid","title":"Audit Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["entity_type","entity_id","actor","action","input_snapshot","output_snapshot","audit_id","timestamp"],"title":"AuditLogRead"},"CustomerContext":{"properties":{"customer_id":{"type":"string","format":"uuid","title":"Customer Id"},"historical_payment_count":{"type":"integer","title":"Historical Payment Count"},"successful_payment_count":{"type":"integer","title":"Successful Payment Count"},"average_transaction_value":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Average Transaction Value"},"risk_score":{"type":"number","title":"Risk Score"},"last_successful_payment":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Successful Payment"}},"type":"object","required":["customer_id","historical_payment_count","successful_payment_count","average_transaction_value","risk_score"],"title":"CustomerContext","description":"Lightweight customer context passed to agents — avoids full customer object."},"DetectionInput":{"properties":{"payment_event":{"$ref":"#/components/schemas/PaymentEventRead"},"customer_context":{"$ref":"#/components/schemas/CustomerContext"},"merchant_policy":{"$ref":"#/components/schemas/PolicyRead-Input"}},"type":"object","required":["payment_event","customer_context","merchant_policy"],"title":"DetectionInput"},"ExperimentGroup":{"type":"string","enum":["TREATMENT","CONTROL"],"title":"ExperimentGroup"},"FailureCause":{"type":"string","enum":["TEMPORARY_FAILURE","INSUFFICIENT_FUNDS","PAYMENT_METHOD_FAILURE","CUSTOMER_ABANDONMENT","EXPIRED_PAYMENT","RISK_REJECTION","UNKNOWN"],"title":"FailureCause"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"OpportunityStatus":{"type":"string","enum":["OPEN","DIAGNOSING","DIAGNOSED","STRATEGY_SELECTED","AWAITING_POLICY","AWAITING_APPROVAL","IN_PROGRESS","EXECUTING","RECOVERED","FAILED","POLICY_REJECTED","ABANDONED"],"title":"OpportunityStatus"},"OutcomeRecordRequest":{"properties":{"payment_status":{"type":"string","title":"Payment Status","description":"Payment outcome status (captured, failed)"},"recovered_amount":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Recovered Amount","description":"Actual recovered amount"},"experiment_group":{"$ref":"#/components/schemas/ExperimentGroup","description":"TREATMENT or CONTROL group","default":"TREATMENT"}},"type":"object","required":["payment_status"],"title":"OutcomeRecordRequest"},"PaymentEventRead":{"properties":{"merchant_id":{"type":"string","format":"uuid","title":"Merchant Id"},"customer_id":{"type":"string","format":"uuid","title":"Customer Id"},"payment_id":{"type":"string","title":"Payment Id","description":"Razorpay payment ID — used as idempotency key"},"amount":{"anyOf":[{"type":"number"},{"type":"string"}],"title":"Amount"},"currency":{"type":"string","title":"Currency","default":"INR"},"payment_method":{"$ref":"#/components/schemas/PaymentMethod"},"status":{"type":"string","title":"Status"},"failure_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Failure Code"},"failure_category":{"anyOf":[{"$ref":"#/components/schemas/FailureCause"},{"type":"null"}]},"metadata_":{"type":"object","title":"Metadata "},"event_id":{"type":"string","format":"uuid","title":"Event Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["merchant_id","customer_id","payment_id","amount","payment_method","status","event_id","timestamp"],"title":"PaymentEventRead"},"PaymentMethod":{"type":"string","enum":["CARD","UPI","NETBANKING","WALLET","EMI","OTHER"],"title":"PaymentMethod"},"PolicyRead-Input":{"properties":{"merchant_id":{"type":"string","format":"uuid","title":"Merchant Id"},"max_retry_count":{"type":"integer","maximum":10.0,"minimum":0.0,"title":"Max Retry Count","default":2},"max_discount_pct":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"string"}],"title":"Max Discount Pct","default":"5.00"},"allowed_channels":{"items":{"type":"string"},"type":"array","title":"Allowed Channels"},"approval_threshold":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Approval Threshold","default":"25000.00"},"max_intervention_cost":{"anyOf":[{"type":"number","minimum":0.0},{"type":"string"}],"title":"Max Intervention Cost","default":"50.00"},"active":{"type":"boolean","title":"Active","default":true},"version":{"type":"integer","title":"Version","default":1},"policy_id":{"type":"string","format":"uuid","title":"Policy Id"}},"type":"object","required":["merchant_id","policy_id"],"title":"PolicyRead"},"PolicyRead-Output":{"properties":{"merchant_id":{"type":"string","format":"uuid","title":"Merchant Id"},"max_retry_count":{"type":"integer","maximum":10.0,"minimum":0.0,"title":"Max Retry Count","default":2},"max_discount_pct":{"type":"string","title":"Max Discount Pct","default":"5.00"},"allowed_channels":{"items":{"type":"string"},"type":"array","title":"Allowed Channels"},"approval_threshold":{"type":"string","title":"Approval Threshold","default":"25000.00"},"max_intervention_cost":{"type":"string","title":"Max Intervention Cost","default":"50.00"},"active":{"type":"boolean","title":"Active","default":true},"version":{"type":"integer","title":"Version","default":1},"policy_id":{"type":"string","format":"uuid","title":"Policy Id"}},"type":"object","required":["merchant_id","policy_id"],"title":"PolicyRead"},"PolicyUpdate":{"properties":{"max_retry_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Retry Count"},"max_discount_pct":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Max Discount Pct"},"allowed_channels":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Allowed Channels"},"approval_threshold":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Approval Threshold"},"max_intervention_cost":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Max Intervention Cost"}},"type":"object","title":"PolicyUpdate","description":"Partial update — only include fields that change."},"Priority":{"type":"string","enum":["HIGH","MEDIUM","LOW"],"title":"Priority"},"RecoveryOpportunityRead":{"properties":{"payment_id":{"type":"string","title":"Payment Id"},"recoverability_score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Recoverability Score"},"expected_revenue":{"type":"string","title":"Expected Revenue"},"priority":{"$ref":"#/components/schemas/Priority"},"status":{"$ref":"#/components/schemas/OpportunityStatus","default":"OPEN"},"opportunity_id":{"type":"string","format":"uuid","title":"Opportunity Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["payment_id","recoverability_score","expected_revenue","priority","opportunity_id","created_at"],"title":"RecoveryOpportunityRead"},"SimulatePaymentRequest":{"properties":{"merchant_id":{"type":"string","format":"uuid","title":"Merchant Id"},"customer_id":{"type":"string","format":"uuid","title":"Customer Id"},"amount":{"anyOf":[{"type":"number","exclusiveMinimum":0.0},{"type":"string"}],"title":"Amount"},"currency":{"type":"string","title":"Currency","default":"INR"},"payment_method":{"$ref":"#/components/schemas/PaymentMethod","default":"CARD"},"failure_code":{"type":"string","title":"Failure Code","default":"GATEWAY_ERROR"},"metadata":{"type":"object","title":"Metadata"}},"type":"object","required":["merchant_id","customer_id","amount"],"title":"SimulatePaymentRequest","description":"Used by /api/v1/payments/simulate for synthetic event injection."},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}