feat(router): Add Payments - List endpoint for v2

[AnuthaDev]

Type of Change

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

Description

Added Payments - List endpoint for v2

Additional Changes

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

Motivation and Context

How did you test it?

• Request:

curl --location 'http://localhost:8080/v2/payments/list' \
--header 'Content-Type: application/json' \
--header 'x-profile-id: pro_oJHm83lyP59ddE5WUaY8' \
--header 'api-key: dev_Mz8tRnZsfjgA5eIibpiQ3SQcL0fJ3XeHnZOjFZpOmfOv84zK6vkzhz1KL4JgXG7S' \
--data '{
    "limit": 20
}'

• Response:

{
    "count": 1,
    "total_count": 1,
    "data": [
        {
            "id": "12345_pay_0194eeb7d3c37a7081eeee3d3435e9a6",
            "merchant_id": "cloth_seller_amGnZWFTPuy2tgN2Ajxl",
            "profile_id": "pro_oJHm83lyP59ddE5WUaY8",
            "customer_id": null,
            "payment_method_id": null,
            "status": "requires_payment_method",
            "amount": {
                "order_amount": 100,
                "currency": "USD",
                "shipping_cost": null,
                "order_tax_amount": null,
                "external_tax_calculation": "skip",
                "surcharge_calculation": "skip",
                "surcharge_amount": null,
                "tax_on_surcharge": null,
                "net_amount": 100,
                "amount_to_capture": null,
                "amount_capturable": 0,
                "amount_captured": null
            },
            "created": "2025-02-10T07:16:52.303Z",
            "payment_method_type": null,
            "payment_method_subtype": null,
            "connector": null,
            "merchant_connector_id": null,
            "customer": null,
            "merchant_reference_id": null,
            "connector_payment_id": null,
            "connector_response_reference_id": null,
            "metadata": null,
            "description": null,
            "authentication_type": "no_three_ds",
            "capture_method": "manual",
            "setup_future_usage": "on_session",
            "attempt_count": 0,
            "error": null,
            "cancellation_reason": null,
            "order_details": null,
            "return_url": null,
            "statement_descriptor": null,
            "allowed_payment_method_types": null,
            "authorization_count": 0,
            "modified_at": "2025-02-10T07:16:52.303Z"
        }
    ]
}

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/helpers.rs	70% smaller
crates/router/src/routes/app.rs	69% smaller
api-reference-v2/mint.json	67% smaller
crates/storage_impl/src/mock_db/payment_attempt.rs	23% smaller
crates/api_models/src/events/payment.rs	8% smaller
crates/router/src/core/payments.rs	1% smaller
crates/hyperswitch_domain_models/src/payments/payment_attempt.rs	1% smaller
crates/router/src/db/kafka_store.rs	1% smaller
crates/storage_impl/src/payments/payment_attempt.rs	1% smaller
api-reference-v2/api-reference/payments/payments--list-by-filter.mdx	Unsupported file format
api-reference-v2/openapi_spec.json	0% smaller
crates/api_models/src/payments.rs	0% smaller
crates/diesel_models/src/query/payment_attempt.rs	0% smaller
crates/hyperswitch_domain_models/src/payments/payment_intent.rs	0% smaller
crates/openapi/src/openapi_v2.rs	0% smaller
crates/openapi/src/routes/payments.rs	0% smaller
crates/router/src/core/payments/transformers.rs	0% smaller
crates/router/src/routes/payments.rs	0% smaller
crates/storage_impl/src/mock_db/payment_intent.rs	0% smaller
crates/storage_impl/src/payments/payment_intent.rs	0% smaller

[sai-harsha-vardhan]

id should be mandatory when you are returning CustomerDetailsResponse right?

[sai-harsha-vardhan]

How's it different from connector_response_reference_id?

[sai-harsha-vardhan]

Do we need both PaymentListResponse and PaymentListResponseV2 in V2?

[sai-harsha-vardhan]

We should add JWTAuth here