fix(revenue_recovery): return actionable webhook errors

[NISHANTH1221]

Type of Change

• Bugfix
• New feature
• Enhancement
• Refactoring
• Dependency updates
• Documentation
• CI/CD

Description

Returns actionable responses for revenue recovery webhook failures that cannot succeed on retry.

• Converts revenue recovery domain errors into specific webhook API errors.
• Returns an authentication error for failed source verification.
• Returns an unprocessable response for invalid invoice or transaction data.
• Identifies missing payment MCA mappings and billing retry-threshold configuration.
• Returns a failed precondition when the invoice no longer permits recording an attempt.
• Preserves processing failures for transient internal and downstream errors.
• Uses the invoice-sync error context when the billing invoice sync response fails.

Stack Dependency

Depends on #13718.

Additional Changes

• This PR modifies the API contract
• This PR modifies the database schema
• This PR modifies application configuration/environment variables

Motivation and Context

The incoming webhook handler previously converted every revenue recovery error into a generic 5xx response. Chargebee would therefore retry malformed payloads, missing merchant configuration, and terminal invoice-state failures even though replaying the same event could not resolve them.

Mapping non-retryable failures to specific 4xx responses stops futile webhook retries and exposes the configuration or state that must be corrected. Transient failures remain retryable.

How did you test it?

• cargo +nightly fmt --all -- --check
• cargo check --package router --no-default-features --features release,v2,redis-rs
• git diff --check origin/main..HEAD

Validation was run on the complete stacked branch.

Checklist

• I formatted the code cargo +nightly fmt --all
• I addressed lints thrown by cargo clippy
• I reviewed the submitted code
• I added unit tests for my changes where possible

Related Issue

Closes #13717

[semanticdiff-com]

Review changes with  

Changed Files

File	Status
crates/api_models/src/process_tracker/revenue_recovery.rs	54% smaller
crates/hyperswitch_connectors/src/connectors/paypal/transformers.rs	46% smaller
crates/router/src/core/webhooks/recovery_incoming.rs	27% smaller
crates/router/src/workflows/revenue_recovery.rs	27% smaller
crates/hyperswitch_connectors/src/connectors/chargebee/transformers.rs	20% smaller
crates/hyperswitch_connectors/src/connectors/chargebee.rs	20% smaller
crates/router/src/core/payments/transformers.rs	15% smaller
crates/router/src/core/revenue_recovery.rs	14% smaller
crates/router/src/core/errors.rs	8% smaller
crates/router/src/core/webhooks/incoming_v2.rs	5% smaller
crates/hyperswitch_connectors/src/connectors/stripe.rs	0% smaller
crates/hyperswitch_connectors/src/connectors/stripe/transformers.rs	0% smaller
crates/router/src/core/revenue_recovery/types.rs	0% smaller