feat(core): Add support for updating metadata after payment has been authorized (#7776)

Co-authored-by: hyperswitch-bot[bot] <148525504+hyperswitch-bot[bot]@users.noreply.github.com>

crates/openapi/src/openapi.rs

@@ -83,6 +83,7 @@ Never share your secret api keys. Keep them guarded and secure.
         routes::payments::payments_external_authentication,
         routes::payments::payments_complete_authorize,
         routes::payments::payments_post_session_tokens,
+        routes::payments::payments_update_metadata,
 
         // Routes for relay
         routes::relay::relay,
@@ -730,6 +731,8 @@ Never share your secret api keys. Keep them guarded and secure.
         api_models::payments::DisplayAmountOnSdk,
         api_models::payments::PaymentsPostSessionTokensRequest,
         api_models::payments::PaymentsPostSessionTokensResponse,
+        api_models::payments::PaymentsUpdateMetadataRequest,
+        api_models::payments::PaymentsUpdateMetadataResponse,
         api_models::payments::CtpServiceDetails,
         api_models::feature_matrix::FeatureMatrixListResponse,
         api_models::feature_matrix::FeatureMatrixRequest,

crates/openapi/src/routes/payments.rs

@@ -599,6 +599,21 @@ pub fn payments_dynamic_tax_calculation() {}
 
 pub fn payments_post_session_tokens() {}
 
+/// Payments - Update Metadata
+#[utoipa::path(
+    post,
+    path = "/payments/{payment_id}/update_metadata",
+    request_body=PaymentsUpdateMetadataRequest,
+    responses(
+        (status = 200, description = "Metadata updated successfully", body = PaymentsUpdateMetadataResponse),
+        (status = 400, description = "Missing mandatory fields")
+    ),
+    tag = "Payments",
+    operation_id = "Update Metadata for a Payment",
+    security(("api_key" = []))
+)]
+pub fn payments_update_metadata() {}
+
 /// Payments - Create Intent
 ///
 /// **Creates a payment intent object when amount_details are passed.**