fix(router): Make v2 endpoints follow standard naming conventions

[AnuthaDev]

Type of Change

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

Description

• Consistently use kebab case in endpoint URLs
• Use plural form of resources in URLs, i.e. instead of /v2/organization, use /v2/organizations

Renamed (current version removed) endpoints:
/v2/organization -> /v2/organizations
/v2/routing-algorithm -> /v2/routing-algorithms
/v2/payment-methods-session -> /v2/payment-method-sessions
(refunds) /update_metadata -> update-metadata

Duplicated (current version not removed) endpoints:

/v2/user -> /v2/users
/create_merchant -> /create-merchant
/v2/process_tracker/revenue_recovery_workflow -> /v2/process-trackers/revenue-recovery-workflow
/list_attempts -> /list-attempts

Additional Changes

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

Motivation and Context

Closes #8629

How did you test it?

1. Organization

Request:

curl --location 'http://localhost:8080/v2/organizations' \
--header 'Authorization: admin-api-key=test_admin' \
--header 'Content-Type: application/json' \
--data '{
    "organization_name": "v2_org_1752571446"
}'

Response:

{
    "id": "org_4YoqpRWuOelFCr7Lbh2l",
    "organization_name": "v2_org_1752571419",
    "organization_details": null,
    "metadata": null,
    "modified_at": "2025-07-15 09:23:39.045598",
    "created_at": "2025-07-15 09:23:39.045496"
}

2. Payment Method Sessions:

Request:

curl --location 'http://localhost:8080/v2/payment-method-sessions' \
--header 'x-profile-id: pro_k5m9OvIbAwRr29ZJrZFN' \
--header 'Authorization: api-key=dev_e0A7pdYme3jeCbLscKnTIXBci4IcuiixFCwaN0H3usrmeVSkKcn5r701nisZsvZc' \
--header 'Content-Type: application/json' \
--header 'api-key: dev_e0A7pdYme3jeCbLscKnTIXBci4IcuiixFCwaN0H3usrmeVSkKcn5r701nisZsvZc' \
--data-raw '{
    "customer_id": "12345_cus_01980d66d85c78f28c2f25980c48a60b",
     "billing": {
        "address": {
            "first_name": "John",
            "last_name": "Dough"
        },
        "email": "[email protected]"
    }
}'

Response:

{
    "id": "12345_pms_01980d66e6ab715093173e3078818fc5",
    "customer_id": "12345_cus_01980d66d85c78f28c2f25980c48a60b",
    "billing": {
        "address": {
            "city": null,
            "country": null,
            "line1": null,
            "line2": null,
            "line3": null,
            "zip": null,
            "state": null,
            "first_name": "John",
            "last_name": "Dough"
        },
        "phone": null,
        "email": "[email protected]"
    },
    "psp_tokenization": null,
    "network_tokenization": null,
    "tokenization_data": null,
    "expires_at": "2025-07-15T09:40:04.299Z",
    "client_secret": "cs_01980d66e6ab715093173e43f85db63a",
    "return_url": null,
    "next_action": null,
    "authentication_details": null,
    "associated_payment_methods": null,
    "associated_token_id": null
}

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.rs	86% smaller
crates/router/src/lib.rs	65% smaller
api-reference/v2/openapi_spec_v2.json	0% smaller
api-reference/v2/organization/organization--create.mdx	Unsupported file format
api-reference/v2/organization/organization--merchant-account--list.mdx	Unsupported file format
api-reference/v2/organization/organization--retrieve.mdx	Unsupported file format
api-reference/v2/organization/organization--update.mdx	Unsupported file format
api-reference/v2/payment-method-session/payment-method-session--confirm-a-payment-method-session.mdx	Unsupported file format
api-reference/v2/payment-method-session/payment-method-session--create.mdx	Unsupported file format
api-reference/v2/payment-method-session/payment-method-session--delete-a-saved-payment-method.mdx	Unsupported file format
api-reference/v2/payment-method-session/payment-method-session--list-payment-methods.mdx	Unsupported file format
api-reference/v2/payment-method-session/payment-method-session--retrieve.mdx	Unsupported file format
api-reference/v2/payment-method-session/payment-method-session--update-a-saved-payment-method.mdx	Unsupported file format
api-reference/v2/revenue-recovery/revenue-recovery--retrieve.mdx	Unsupported file format
api-reference/v2/routing/routing--create.mdx	Unsupported file format
api-reference/v2/routing/routing--retrieve.mdx	Unsupported file format
crates/hyperswitch_connectors/src/connectors/hyperswitch_vault.rs	0% smaller
crates/openapi/src/routes/organization.rs	0% smaller
crates/openapi/src/routes/payment_method.rs	0% smaller
crates/openapi/src/routes/refunds.rs	0% smaller
crates/openapi/src/routes/revenue_recovery.rs	0% smaller
crates/openapi/src/routes/routing.rs	0% smaller
crates/router/src/routes/app.rs	0% smaller
cypress-tests-v2/cypress/support/commands.js	0% smaller

[deepanshu-iiitu]

Connector changes look good

[SanchithHegde]

Please inform all affected teams about these API changes.