feat(router): add v2 endpoint retrieve payment filters based on merchant profile

[aniketburman014]

Type of Change

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

Description

Added the v2/payments/v2/filter API to retrieve available payment filters (connectors, statuses, payment methods, authentication types, etc.) for merchant profile.

This pr closes the issue #7193.

Key Changes

1. `get_payment_filters` -> `crates/router/src/routes/payments.rs`
   - Integrates the new API with authentication via API keys & JWT (`ProfilePaymentRead` permission).
   - Supports profile-based filtering for merchants.
   
2. `get_payment_filters` -> `crates/router/src/core/payments.rs`
   - Retrieves available payment filters, including:
     - Connectors
     - Currencies
     - Statuses
     - Payment methods
     - Authentication types
     - Card networks
   - Calls list_payment_connectors to fetch merchant-specific connectors (using both profile_id and merchant_id), applying profile-based filtering to return only the relevant connectors and payment methods available for the given profile and merchant combination.
   - Constructs and returns a structured response (`PaymentListFiltersV2`).

Additional Changes

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

Links to the files with corresponding changes.

1. crates/router/src/core/payments.rs
2. crates/router/src/routes/app.rs
3. crates/router/src/routes/payments.rs

Motivation and Context

How did you test it?

• Using Postman

• Curl Request Example

curl --location 'http://localhost:8080/v2/payments/v2/filter' \
--header 'X-Profile-Id: pro_68rBAUSCoq91kQ870GFR' \
--header 'X-Merchant-Id: cloth_seller_cnwkRpdOSnP0vLY1lhGb' \
--header 'api-key: dev_elV1dBHRfYgbT09Q3R914ZOZzKCsJFjMJRot4TUcByFCYDseSZHTrZbCJuBX6ZHO'

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

[semanticdiff-com]

Review changes with  

Changed Files

File	Status
crates/router/src/routes/app.rs	57% smaller
crates/router/src/routes/payments.rs	12% smaller
crates/router/src/core/payments.rs	0% smaller

[Narayanbhat166]

can you use this function

hyperswitch/crates/hyperswitch_domain_models/src/merchant_connector_account.rs

Line 162 in 886737f

pub fn from_payment_connectors_list(payment_connectors: Vec<MerchantConnectorAccount>) -> Self {

[Narayanbhat166]

And once you receive the flattened list, you can construct a hashmap from that