feat(router): Add v2 endpoint to retrieve payment filters at merchant and profile level

[aniketburman014]

Type of Change

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

Description

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

Key Changes

1. `get_payment_filters_profile` -> `crates/router/src/routes/payments.rs`
   - Supports profile-based filtering for merchants.
   
2. `get_payment_filters` -> `crates/router/src/core/payments.rs`
   - Refactor get_payment_filters to support both v1 and v2  
   - Updated get_payment_filters to work with both PaymentListFiltersV1 and 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/api_models/src/admin.rs
2. crates/api_models/src/payment_methods.rs
3. crates/router/src/routes/payments.rs
4. crates/common_types/src/payment_methods.rs
5. crates/router/Cargo.toml
6. crates/router/src/core/payments.rs
7. crates/router/src/routes/app.rs

Motivation and Context

How did you test it?

-Request

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

• Response

    "connector": {
        "stripe": [
            {
                "connector_label": "stripe_business11",
                "merchant_connector_id": "mca_2jsckz0TAfE0z52dJUY1"
            }
        ]
    },
    "currency": [
        "AED",
        "AFN",
        "ALL",
        "AMD",
        "ANG",
        "AOA",
        "ARS",
        "AUD",
        "AWG",
        "AZN",
        "BAM",
        "BBD",
        "BDT",
        "BGN",
        "BHD",
        "BIF",
        "BMD",
        "BND",
        "BOB",
        "BRL",
        "BSD",
        "BTN",
        "BWP",
        "BYN",
        "BZD",
        "CAD",
        "CDF",
        "CHF",
        "CLP",
        "CNY",
        "COP",
        "CRC",
        "CUP",
        "CVE",
        "CZK",
        "DJF",
        "DKK",
        "DOP",
        "DZD",
        "EGP",
        "ERN",
        "ETB",
        "EUR",
        "FJD",
        "FKP",
        "GBP",
        "GEL",
        "GHS",
        "GIP",
        "GMD",
        "GNF",
        "GTQ",
        "GYD",
        "HKD",
        "HNL",
        "HRK",
        "HTG",
        "HUF",
        "IDR",
        "ILS",
        "INR",
        "IQD",
        "IRR",
        "ISK",
        "JMD",
        "JOD",
        "JPY",
        "KES",
        "KGS",
        "KHR",
        "KMF",
        "KPW",
        "KRW",
        "KWD",
        "KYD",
        "KZT",
        "LAK",
        "LBP",
        "LKR",
        "LRD",
        "LSL",
        "LYD",
        "MAD",
        "MDL",
        "MGA",
        "MKD",
        "MMK",
        "MNT",
        "MOP",
        "MRU",
        "MUR",
        "MVR",
        "MWK",
        "MXN",
        "MYR",
        "MZN",
        "NAD",
        "NGN",
        "NIO",
        "NOK",
        "NPR",
        "NZD",
        "OMR",
        "PAB",
        "PEN",
        "PGK",
        "PHP",
        "PKR",
        "PLN",
        "PYG",
        "QAR",
        "RON",
        "RSD",
        "RUB",
        "RWF",
        "SAR",
        "SBD",
        "SCR",
        "SDG",
        "SEK",
        "SGD",
        "SHP",
        "SLE",
        "SLL",
        "SOS",
        "SRD",
        "SSP",
        "STN",
        "SVC",
        "SYP",
        "SZL",
        "THB",
        "TJS",
        "TMT",
        "TND",
        "TOP",
        "TRY",
        "TTD",
        "TWD",
        "TZS",
        "UAH",
        "UGX",
        "USD",
        "UYU",
        "UZS",
        "VES",
        "VND",
        "VUV",
        "WST",
        "XAF",
        "XCD",
        "XOF",
        "XPF",
        "YER",
        "ZAR",
        "ZMW",
        "ZWL"
    ],
    "status": [
        "succeeded",
        "failed",
        "cancelled",
        "processing",
        "requires_customer_action",
        "requires_merchant_action",
        "requires_payment_method",
        "requires_confirmation",
        "requires_capture",
        "partially_captured",
        "partially_captured_and_capturable"
    ],
    "payment_method": {
        "card": [
            "debit",
            "credit"
        ]
    },
    "authentication_type": [
        "three_ds",
        "no_three_ds"
    ],
    "card_network": [
        "Visa",
        "Mastercard",
        "AmericanExpress",
        "JCB",
        "DinersClub",
        "Discover",
        "CartesBancaires",
        "UnionPay",
        "Interac",
        "RuPay",
        "Maestro"
    ]
}

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/core/payments.rs	85% smaller
crates/router/src/routes/app.rs	5% smaller
crates/api_models/src/admin.rs	0% smaller
crates/api_models/src/payment_methods.rs	0% smaller
crates/common_types/src/payment_methods.rs	0% smaller
crates/router/Cargo.toml	Unsupported file format
crates/router/src/routes/payments.rs	0% smaller

[ShankarSinghC]

Nit: Consider avoiding single-letter variable names like p. It's generally more readable to use more descriptive names that convey the purpose of the variable.