Bug: fix(openapi): Fix broken pages in mintlify (v2)



v2 mintlify docs have several broken pages and some endpoints are missing.
diff --git a/crates/openapi/src/routes/payments.rs b/crates/openapi/src/routes/payments.rs
index 6160b68b44b..2d25ca4f77f 100644
--- a/crates/openapi/src/routes/payments.rs
+++ b/crates/openapi/src/routes/payments.rs
@@ -923,12 +923,7 @@ pub fn payments_update_intent() {}
         "X-Profile-Id" = String, Header,
         description = "Profile ID associated to the payment intent",
         example = "pro_abcdefghijklmnop"
-      ),
-      (
-        "X-Client-Secret" = String, Header,
-        description = "Client Secret Associated with the payment intent",
-        example = json!({"X-Client-Secret": "12345_pay_0193e41106e07e518940f8b51b9c8121_secret_0193e41107027a928d61d292e6a5dba9"})
-      ),
+      )
     ),
   request_body(
       content = PaymentsConfirmIntentRequest,
@@ -1058,11 +1053,6 @@ pub(crate) enum ForceSync {
           description = "Profile ID associated to the payment intent",
           example = "pro_abcdefghijklmnop"
         ),
-        (
-          "X-Client-Secret" = String, Header,
-          description = "Client Secret Associated with the payment intent",
-          example = json!({"X-Client-Secret": "12345_pay_0193e41106e07e518940f8b51b9c8121_secret_0193e41107027a928d61d292e6a5dba9"})
-        ),
     ),
     responses(
         (status = 200, description = "Get the payment methods", body = PaymentMethodListResponseForPayments),
diff --git a/crates/openapi/src/routes/tokenization.rs b/crates/openapi/src/routes/tokenization.rs
index 22f1227a9c0..d69008911ce 100644
--- a/crates/openapi/src/routes/tokenization.rs
+++ b/crates/openapi/src/routes/tokenization.rs
@@ -1,6 +1,9 @@
 use serde_json::json;
 use utoipa::OpenApi;
 
+/// Tokenization - Create
+///
+/// Create a token with customer_id
 #[cfg(feature = "v2")]
 #[utoipa::path(
     post,

## Type of Change
<!-- Put an `x` in the boxes that apply -->

- [x] Bugfix
- [ ] New feature
- [ ] Enhancement
- [ ] Refactoring
- [ ] Dependency updates
- [x] Documentation
- [ ] CI/CD

## Description
<!-- Describe your changes in detail -->
Fixed the following mintlify pages:

- `v2/customers/customers--update.mdx`
- `payment-method-session--confirm-a-payment-method-session.mdx`
- `payment-method-session--delete-a-saved-payment-method.mdx`
- `payment-method-session--list-payment-methods.mdx`
- `payment-method-session--retrieve.mdx`
- `payment-method-session--update-a-saved-payment-method.mdx`

Added the following missing pages:

- `payment-method--list-customer-saved-payment-methods.mdx`
- `refunds--list.mdx`
- `refunds--metadata-update.mdx`
- `refunds--retrieve.mdx`
- `revenue-recovery--retrieve.mdx`

### Additional Changes

- [ ] This PR modifies the API contract
- [ ] This PR modifies the database schema
- [ ] This PR modifies application configuration/environment variables

<!--
Provide links to the files with corresponding changes.

Following are the paths where you can find config files:
1. `config`
2. `crates/router/src/configs`
3. `loadtest/config`
-->


## Motivation and Context
<!--
Why is this change required? What problem does it solve?
If it fixes an open issue, please link to the issue here.

If you don't have an issue, we'd recommend starting with one first so the PR
can focus on the implementation (unless it is an obvious bug or documentation fix
that will have little conversation).
-->
Closes #8381 

## How did you test it?
<!--
Did you write an integration/unit/API test to verify the code changes?
Or did you test this change manually (provide relevant screenshots)?
-->
Verified with `mint dev`

## Checklist
<!-- Put an `x` in the boxes that apply -->

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