/// PaymentMethods - Create
///
/// Creates and stores a payment method against a customer.
/// In case of cards, this API should be used only by PCI compliant merchants.
#[utoipa::path(
    post,
    path = "/payment_methods",
    request_body (
        content = PaymentMethodCreate,
        examples  (( "Save a card" =(
        value =json!( {
            "payment_method": "card",
            "payment_method_type": "credit",
            "payment_method_issuer": "Visa",
            "card": {
            "card_number": "4242424242424242",
            "card_exp_month": "11",
            "card_exp_year": "30",
            "card_holder_name": "John Doe"
            },
            "customer_id": "{{customer_id}}"
        })
        )))
    ),
    responses(
        (status = 200, description = "Payment Method Created", body = PaymentMethodResponse),
        (status = 400, description = "Invalid Data")

    ),
    tag = "Payment Methods",
    operation_id = "Create a Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v1")]
pub async fn create_payment_method_api() {}

/// List payment methods for a Merchant
///
/// Lists the applicable payment methods for a particular Merchant ID.
/// Use the client secret and publishable key authorization to list all relevant payment methods of the merchant for the payment corresponding to the client secret.
#[utoipa::path(
    get,
    path = "/account/payment_methods",
    params (
        ("client_secret" = Option<String>, Query, description = "This is a token which expires after 15 minutes, used from the client to authenticate and create sessions from the SDK"),
        ("accepted_countries" = Option<Vec<CountryAlpha2>>, Query, description = "The two-letter ISO currency code"),
        ("accepted_currencies" = Option<Vec<Currency>>, Query, description = "The three-letter ISO currency code"),
        ("amount" = Option<i64>, Query, description = "The amount accepted for processing by the particular payment method."),
        ("recurring_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for recurring payments"),
        ("installment_payment_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for installment payments"),
        ("limit" = Option<i64>, Query, description = "Indicates the limit of last used payment methods"),
        ("card_networks" = Option<Vec<CardNetwork>>, Query, description = "Indicates whether the payment method is eligible for card netwotks"),
    ),
    responses(
        (status = 200, description = "Payment Methods retrieved", body = PaymentMethodListResponse),
        (status = 400, description = "Invalid Data"),
        (status = 404, description = "Payment Methods does not exist in records")
    ),
    tag = "Payment Methods",
    operation_id = "List all Payment Methods for a Merchant",
    security(("api_key" = []), ("publishable_key" = []))
)]
pub async fn list_payment_method_api() {}

/// List payment methods for a Customer
///
/// Lists all the applicable payment methods for a particular Customer ID.
#[utoipa::path(
    get,
    path = "/customers/{customer_id}/payment_methods",
    params (
        ("customer_id" = String, Path, description = "The unique identifier for the customer account"),
        ("client_secret" = Option<String>, Query, description = "This is a token which expires after 15 minutes, used from the client to authenticate and create sessions from the SDK"),
        ("accepted_countries" = Option<Vec<CountryAlpha2>>, Query, description = "The two-letter ISO currency code"),
        ("accepted_currencies" = Option<Vec<Currency>>, Query, description = "The three-letter ISO currency code"),
        ("amount" = Option<i64>, Query, description = "The amount accepted for processing by the particular payment method."),
        ("recurring_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for recurring payments"),
        ("installment_payment_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for installment payments"),
        ("limit" = Option<i64>, Query, description = "Indicates the limit of last used payment methods"),
        ("card_networks" = Option<Vec<CardNetwork>>, Query, description = "Indicates whether the payment method is eligible for card netwotks"),
    ),
    responses(
        (status = 200, description = "Payment Methods retrieved", body = CustomerPaymentMethodsListResponse),
        (status = 400, description = "Invalid Data"),
        (status = 404, description = "Payment Methods does not exist in records")
    ),
    tag = "Payment Methods",
    operation_id = "List all Payment Methods for a Customer",
    security(("api_key" = []))
)]
#[cfg(feature = "v1")]
pub async fn list_customer_payment_method_api() {}

/// List customer saved payment methods for a Payment
///
/// Lists all the applicable payment methods for a particular payment tied to the `client_secret`.
#[utoipa::path(
    get,
    path = "/customers/payment_methods",
    params (
        ("client_secret" = Option<String>, Query, description = "This is a token which expires after 15 minutes, used from the client to authenticate and create sessions from the SDK"),
        ("accepted_countries" = Option<Vec<CountryAlpha2>>, Query, description = "The two-letter ISO currency code"),
        ("accepted_currencies" = Option<Vec<Currency>>, Query, description = "The three-letter ISO currency code"),
        ("amount" = Option<i64>, Query, description = "The amount accepted for processing by the particular payment method."),
        ("recurring_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for recurring payments"),
        ("installment_payment_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for installment payments"),
        ("limit" = Option<i64>, Query, description = "Indicates the limit of last used payment methods"),
        ("card_networks" = Option<Vec<CardNetwork>>, Query, description = "Indicates whether the payment method is eligible for card netwotks"),
    ),
    responses(
        (status = 200, description = "Payment Methods retrieved for customer tied to its respective client-secret passed in the param", body = CustomerPaymentMethodsListResponse),
        (status = 400, description = "Invalid Data"),
        (status = 404, description = "Payment Methods does not exist in records")
    ),
    tag = "Payment Methods",
    operation_id = "List Customer Payment Methods via Client Secret",
    security(("publishable_key" = []))
)]
pub async fn list_customer_payment_method_api_client() {}

/// List payment methods for a Payment
///
/// Client SDK endpoint. Returns a unified response combining merchant-enabled
/// payment methods and customer saved payment methods, filtered via Euclid
/// constraint graph and session flow routing.
///
/// Supported client auth:
/// - SDK auth via `Authorization`.
/// - Publishable-key auth via `api-key: pk_...` and `client_secret` query param.
///
/// Merchant secret-key auth is intentionally not supported for this endpoint.
#[utoipa::path(
    get,
    path = "/payments/{payment_id}/client",
    params (
        ("payment_id" = String, Path, description = "The identifier for the payment"),
        ("client_secret" = Option<String>, Query, description = "This is a token which expires after 15 minutes, used from the client to authenticate and create sessions from the SDK"),
        ("accepted_countries" = Option<Vec<CountryAlpha2>>, Query, description = "The two-letter ISO currency code"),
        ("accepted_currencies" = Option<Vec<Currency>>, Query, description = "The three-letter ISO currency code"),
        ("amount" = Option<i64>, Query, description = "The amount accepted for processing by the particular payment method."),
        ("recurring_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for recurring payments"),
        ("installment_payment_enabled" = Option<bool>, Query, description = "Indicates whether the payment method is eligible for installment payments"),
        ("limit" = Option<i64>, Query, description = "Indicates the limit of last used payment methods"),
        ("card_networks" = Option<Vec<CardNetwork>>, Query, description = "Indicates whether the payment method is eligible for card netwotks"),
    ),
    responses(
        (status = 200, description = "Payment Methods retrieved", body = ClientPaymentMethodsListResponse),
        (status = 400, description = "Invalid Data"),
        (status = 404, description = "Payment Methods does not exist in records")
    ),
    tag = "Payment Methods",
    operation_id = "List Payment Methods for a Payment via Client SDK",
    security(("publishable_key" = []))
)]
#[cfg(feature = "v1")]
pub async fn list_payment_methods_for_payments_client() {}

/// Payment Method - Retrieve
///
/// Retrieves a payment method of a customer.
#[utoipa::path(
    get,
    path = "/payment_methods/{method_id}",
    params (
        ("method_id" = String, Path, description = "The unique identifier for the Payment Method"),
    ),
    responses(
        (status = 200, description = "Payment Method retrieved", body = PaymentMethodResponse),
        (status = 404, description = "Payment Method does not exist in records")
    ),
    tag = "Payment Methods",
    operation_id = "Retrieve a Payment method",
    security(("api_key" = []))
)]
#[cfg(feature = "v1")]
pub async fn payment_method_retrieve_api() {}

/// Payment Method - Update
///
/// Update an existing payment method of a customer.
/// This API is useful for use cases such as updating the card number for expired cards to prevent discontinuity in recurring payments.
#[utoipa::path(
    post,
    path = "/payment_methods/{method_id}/update",
    params (
        ("method_id" = String, Path, description = "The unique identifier for the Payment Method"),
    ),
    request_body = PaymentMethodUpdate,
    responses(
        (status = 200, description = "Payment Method updated", body = PaymentMethodResponse),
        (status = 404, description = "Payment Method does not exist in records")
    ),
    tag = "Payment Methods",
    operation_id = "Update a Payment method",
    security(("api_key" = []), ("publishable_key" = []))
)]
#[cfg(feature = "v1")]
pub async fn payment_method_update_api() {}

/// Payment Method - Delete
///
/// Deletes a payment method of a customer.
#[utoipa::path(
    delete,
    path = "/payment_methods/{method_id}",
    params (
        ("method_id" = String, Path, description = "The unique identifier for the Payment Method"),
    ),
    responses(
        (status = 200, description = "Payment Method deleted", body = PaymentMethodDeleteResponse),
        (status = 404, description = "Payment Method does not exist in records")
    ),
    tag = "Payment Methods",
    operation_id = "Delete a Payment method",
    security(("api_key" = []))
)]
#[cfg(feature = "v1")]
pub async fn payment_method_delete_api() {}

/// Payment Method - Set Default Payment Method for Customer
///
/// Set the Payment Method as Default for the Customer.
#[utoipa::path(
    post,
    path = "/{customer_id}/payment_methods/{payment_method_id}/default",
    params (
        ("customer_id" = String,Path, description ="The unique identifier for the Customer"),
        ("payment_method_id" = String,Path, description = "The unique identifier for the Payment Method"),
    ),
    responses(
        (status = 200, description = "Payment Method has been set as default", body =CustomerDefaultPaymentMethodResponse ),
        (status = 400, description = "Payment Method has already been set as default for that customer"),
        (status = 404, description = "Payment Method not found for the customer")
    ),
    tag = "Payment Methods",
    operation_id = "Set the Payment Method as Default",
    security(("ephemeral_key" = []))
)]
#[cfg(feature = "v1")]
pub async fn default_payment_method_set_api() {}

/// Payment Method - Set Default Payment Method for Customer
///
/// Set the Payment Method as Default for the Customer.
#[utoipa::path(
    post,
    path = "/v1/{customer_id}/payment-methods/{payment_method_id}/default",
    params (
        ("customer_id" = String,Path, description ="The unique identifier for the Customer"),
        ("payment_method_id" = String,Path, description = "The unique identifier for the Payment Method"),
    ),
    responses(
        (status = 200, description = "Payment Method has been set as default", body =CustomerDefaultPaymentMethodResponse ),
        (status = 400, description = "Payment Method has already been set as default for that customer"),
        (status = 404, description = "Payment Method not found for the customer")
    ),
    tag = "Payment Methods",
    operation_id = "Set the Payment Method as Default",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn default_payment_method_set_api() {}

/// Payment Method - Create Intent
///
/// Creates a payment method for customer with billing information and other metadata.
#[utoipa::path(
    post,
    path = "/v2/payment-methods/create-intent",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodIntentCreate,
    // TODO: Add examples
    ),
    responses(
        (status = 200, description = "Payment Method Intent Created", body = PaymentMethodResponse),
        (status = 400, description = "Invalid Data"),
    ),
    tag = "Payment Methods",
    operation_id = "Create Payment Method Intent",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn create_payment_method_intent_api() {}
/// Payment Method - Confirm Intent
///
/// Update a payment method with customer's payment method related information.
#[utoipa::path(
    post,
    path = "/v2/payment-methods/{id}/confirm-intent",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodIntentConfirm,
    // TODO: Add examples
    ),
    responses(
        (status = 200, description = "Payment Method Intent Confirmed", body = PaymentMethodResponse),
        (status = 400, description = "Invalid Data"),
    ),
    tag = "Payment Methods",
    operation_id = "Confirm Payment Method Intent",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn confirm_payment_method_intent_api() {}
/// Payment Method - Create
///
/// Creates and stores a payment method against a customer. In case of cards, this API should be used only by PCI compliant merchants.
#[utoipa::path(
    post,
    path = "/v2/payment-methods",
    params(
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodCreate,
    // TODO: Add examples
    ),
    responses(
        (status = 200, description = "Payment Method Created", body = PaymentMethodResponse),
        (status = 400, description = "Invalid Data"),
    ),
    tag = "Payment Methods",
    operation_id = "Create Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn create_payment_method_api() {}

/// Payment Method - Create
///
/// Creates and stores a payment method against a customer. In case of cards, this API should be used only by PCI compliant merchants.
#[utoipa::path(
    post,
    path = "/v1/payment-methods",
    params(
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodCreate,
    // TODO: Add examples
    ),
    responses(
        (status = 200, description = "Payment Method Created", body = PaymentMethodResponse),
        (status = 400, description = "Invalid Data"),
    ),
    tag = "Payment Methods",
    operation_id = "Create Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn create_payment_method_api_v1() {}

/// Payment Method - Retrieve
///
/// Retrieves a payment method of a customer.
#[utoipa::path(
    get,
    path = "/v2/payment-methods/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "Payment Method Retrieved", body = PaymentMethodResponse),
        (status = 404, description = "Payment Method Not Found"),
    ),
    tag = "Payment Methods",
    operation_id = "Retrieve Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_retrieve_api() {}

#[utoipa::path(
    get,
    path = "/v1/payment-methods/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
      ),
    responses(
        (status = 200, description = "Payment Method Retrieved", body = PaymentMethodResponse),
        (status = 404, description = "Payment Method Not Found"),
    ),
    tag = "Payment Methods",
    operation_id = "Retrieve Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_retrieve_api_v1() {}

/// Payment Method - Update
///
/// Update an existing payment method of a customer.
#[utoipa::path(
    put,
    path = "/v2/payment-methods/{id}/update-saved-payment-method",
    params(
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodUpdate,
    // TODO: Add examples
    ),
    responses(
        (status = 200, description = "Payment Method Update", body = PaymentMethodResponse),
        (status = 400, description = "Invalid Data"),
    ),
    tag = "Payment Methods",
    operation_id = "Update Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_update_api() {}

/// Payment Method - Update
///
/// Update an existing payment method of a customer.
#[utoipa::path(
    put,
    path = "/v1/payment-methods/{id}/update-saved-payment-method",
    params(
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodUpdate,
    // TODO: Add examples
    ),
    responses(
        (status = 200, description = "Payment Method Update", body = PaymentMethodResponse),
        (status = 400, description = "Invalid Data"),
    ),
    tag = "Payment Methods",
    operation_id = "Update Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_update_api_v1() {}
/// Payment Method - Delete
///
/// Deletes a payment method of a customer.
#[utoipa::path(
    delete,
    path = "/v2/payment-methods/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "Payment Method Retrieved", body = PaymentMethodDeleteResponse),
        (status = 404, description = "Payment Method Not Found"),
    ),
    tag = "Payment Methods",
    operation_id = "Delete Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_delete_api() {}

/// Payment Method - Delete
///
/// Deletes a payment method of a customer.
#[utoipa::path(
    delete,
    path = "/v1/payment-methods/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "Payment Method Retrieved", body = PaymentMethodDeleteResponse),
        (status = 404, description = "Payment Method Not Found"),
    ),
    tag = "Payment Methods",
    operation_id = "Delete Payment Method",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_delete_api_v1() {}

/// Payment Method - Check Network Token Status
///
/// Check the status of a network token for a saved payment method
#[utoipa::path(
    get,
    path = "/v2/payment-methods/{payment_method_id}/check-network-token-status",
    params (
        ("payment_method_id" = String, Path, description = "The unique identifier for the Payment Method"),
    ),
    responses(
        (status = 200, description = "Network Token Status Retrieved", body = NetworkTokenStatusCheckResponse),
        (status = 404, description = "Payment Method Not Found"),
    ),
    tag = "Payment Methods",
    operation_id = "Check Network Token Status",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn network_token_status_check_api() {}
/// Payment Method - Get Payment Method Token Data
///
/// Retrieve the Payment method id associated with a payment method token.
#[utoipa::path(
    get,
    path = "/v2/payment-methods/token/{payment_method_temporary_token}/details",
    params (
        ("payment_method_temporary_token" = String, Path, description = "The unique identifier for the Payment Method Token"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "Payment Method Token Data Retrieved", body = PaymentMethodGetTokenDetailsResponse),
        (status = 404, description = "Payment Method Not Found | Payment method token either expired or does not exist"),
    ),
    tag = "Payment Methods",
    operation_id = "Get Payment Method Token Data",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_get_token_details_api() {}

/// Payment Method - Get Payment Method Token Data
///
/// Retrieve the Payment method id associated with a payment method token.
#[utoipa::path(
    get,
    path = "/v1/payment-methods/token/{payment_method_temporary_token}/details",
    params (
        ("payment_method_temporary_token" = String, Path, description = "The unique identifier for the Payment Method Token"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "Payment Method Token Data Retrieved", body = PaymentMethodGetTokenDetailsResponse),
        (status = 404, description = "Payment Method Not Found | Payment method token either expired or does not exist"),
    ),
    tag = "Payment Methods",
    operation_id = "Get Payment Method Token Data",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn payment_method_get_token_details_api_v1() {}
/// Payment Method - List Customer Saved Payment Methods
///
/// List the payment methods saved for a customer
#[utoipa::path(
    get,
    path = "/v2/customers/{id}/saved-payment-methods",
    params (
        ("id" = String, Path, description = "The unique identifier for the customer"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "Payment Methods Retrieved", body = CustomerPaymentMethodsListResponse),
        (status = 404, description = "Customer Not Found"),
    ),
    tag = "Payment Methods",
    operation_id = "List Customer Saved Payment Methods",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn list_customer_payment_method_api() {}

/// Payment Method - List Customer Saved Payment Methods
///
/// List the payment methods saved for a customer
#[utoipa::path(
    get,
    path = "/v1/customers/{id}/saved-payment-methods",
    params (
        ("id" = String, Path, description = "The unique identifier for the customer"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "Payment Methods Retrieved", body = CustomerPaymentMethodsListResponse),
        (status = 404, description = "Customer Not Found"),
    ),
    tag = "Payment Methods",
    operation_id = "List Customer Saved Payment Methods",
    security(("api_key" = []))
)]
#[cfg(feature = "v2")]
pub async fn list_customer_payment_method_api_v1() {}
/// Payment Method Session - Create
///
/// Create a payment method session for a customer
/// This is used to list the saved payment methods for the customer
/// The customer can also add a new payment method using this session
#[cfg(feature = "v2")]
#[utoipa::path(
    post,
    path = "/v2/payment-method-sessions",
    params (
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodSessionRequest,
        examples  (( "Create a payment method session with customer_id" = (
        value =json!( {
            "customer_id": "0a_cus_abcdefghijklmnopqrstuvwxyz"
        })
        )))
    ),
    responses(
        (status = 200, description = "Create the payment method session", body = PaymentMethodSessionResponse),
        (status = 400, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Create a payment method session",
    security(("api_key" = []))
)]
pub fn payment_method_session_create() {}

/// Payment Method Session - Create
///
/// Create a payment method session for a customer
/// This is used to list the saved payment methods for the customer
/// The customer can also add a new payment method using this session
#[cfg(feature = "v2")]
#[utoipa::path(
    post,
    path = "/v1/payment-method-sessions",
    params (
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
    content = PaymentMethodSessionRequest,
        examples  (( "Create a payment method session with customer_id" = (
        value =json!( {
            "customer_id": "0a_cus_abcdefghijklmnopqrstuvwxyz"
        })
        )))
    ),
    responses(
        (status = 200, description = "Create the payment method session", body = PaymentMethodSessionResponse),
        (status = 400, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Create a payment method session",
    security(("api_key" = []))
)]
pub fn payment_method_session_create_v1() {}

/// Payment Method Session - Retrieve
///
/// Retrieve the payment method session
#[cfg(feature = "v2")]
#[utoipa::path(
    get,
    path = "/v2/payment-method-sessions/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "The payment method session is retrieved successfully", body = PaymentMethodSessionResponse),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Retrieve the payment method session",
    security(("api_key" = []))
)]
pub fn payment_method_session_retrieve() {}

/// Payment Method Session - Retrieve
///
/// Retrieve the payment method session
#[cfg(feature = "v2")]
#[utoipa::path(
    get,
    path = "/v1/payment-method-sessions/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "The payment method session is retrieved successfully", body = PaymentMethodSessionResponse),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Retrieve the payment method session",
    security(("api_key" = []))
)]
pub fn payment_method_session_retrieve_v1() {}

/// Payment Method Session - List Payment Methods
///
/// List payment methods for the given payment method session.
/// This endpoint lists the enabled payment methods for the profile and the saved payment methods of the customer.
#[cfg(feature = "v2")]
#[utoipa::path(
    get,
    path = "/v2/payment-method-sessions/{id}/list-payment-methods",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "The payment method session is retrieved successfully", body = PaymentMethodListResponseForSession),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "List Payment methods for a Payment Method Session",
    security(("publishable_key__client_secret" = []))
)]
pub fn payment_method_session_list_payment_methods() {}

/// Payment Method Session - List Payment Methods
///
/// List payment methods for the given payment method session.
/// This endpoint lists the enabled payment methods for the profile and the saved payment methods of the customer.
#[cfg(feature = "v2")]
#[utoipa::path(
    get,
    path = "/v1/payment-method-sessions/{id}/list-payment-methods",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    responses(
        (status = 200, description = "The payment method session is retrieved successfully", body = PaymentMethodListResponseForSession),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "List Payment methods for a Payment Method Session",
    security(("publishable_key__client_secret" = []))
)]
pub fn payment_method_session_list_payment_methods_v1() {}

/// Payment Method Session - Update a saved payment method
///
/// Update a saved payment method from the given payment method session.
#[cfg(feature = "v2")]
#[utoipa::path(
    put,
    path = "/v2/payment-method-sessions/{id}/update-saved-payment-method",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
        content = PaymentMethodSessionUpdateSavedPaymentMethod,
            examples(( "Update the card holder name" = (
                value =json!( {
                    "payment_method_token": "token_9wcXDRVkfEtLEsSnYKgQ",
                    "payment_method_data": {
                        "card": {
                            "card_holder_name": "Narayan Bhat",
                            "card_cvc": "456"
                        }
                    }
                }
            )
        )))
    ),
    responses(
        (status = 200, description = "The payment method has been updated successfully", body = PaymentMethodSessionResponse),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Update a saved payment method",
    security(("publishable_key__client_secret" = []))
)]
pub fn payment_method_session_update_saved_payment_method() {}

/// Payment Method Session - Update a saved payment method
///
/// Update a saved payment method from the given payment method session.
#[cfg(feature = "v2")]
#[utoipa::path(
    put,
    path = "/v1/payment-method-sessions/{id}/update-saved-payment-method",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
        content = PaymentMethodSessionUpdateSavedPaymentMethod,
            examples(( "Update the card holder name" = (
                value =json!( {
                    "payment_method_token": "token_9wcXDRVkfEtLEsSnYKgQ",
                    "payment_method_data": {
                        "card": {
                            "card_holder_name": "Narayan Bhat",
                            "card_cvc": "456"
                        }
                    }
                }
            )
        )))
    ),
    responses(
        (status = 200, description = "The payment method has been updated successfully", body = PaymentMethodSessionResponse),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Update a saved payment method",
    security(("publishable_key__client_secret" = []))
)]
pub fn payment_method_session_update_saved_payment_method_v1() {}

/// Payment Method Session - Delete a saved payment method
///
/// Delete a saved payment method from the given payment method session.
#[cfg(feature = "v2")]
#[utoipa::path(
    delete,
    path = "/v2/payment-method-sessions/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
        content = PaymentMethodSessionDeleteSavedPaymentMethod,
            examples(( "Update the card holder name" = (
                value =json!( {
                    "payment_method_token": "token_9wcXDRVkfEtLEsSnYKgQ",
                }
            )
        )))
    ),
    responses(
        (status = 200, description = "The payment method has been deleted successfully", body = PaymentMethodDeleteSessionResponse),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Delete a saved payment method",
    security(("publishable_key__client_secret" = []))
)]
pub fn payment_method_session_delete_saved_payment_method() {}

/// Payment Method Session - Delete a saved payment method
///
/// Delete a saved payment method from the given payment method session.
#[cfg(feature = "v2")]
#[utoipa::path(
    delete,
    path = "/v1/payment-method-sessions/{id}",
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
        (
            "X-Profile-Id" = String, Header,
            description = "Profile ID associated to the payment method session",
            example = "pro_abcdefghijklmnop"
        )
    ),
    request_body(
        content = PaymentMethodSessionDeleteSavedPaymentMethod,
            examples(( "Update the card holder name" = (
                value =json!( {
                    "payment_method_token": "token_9wcXDRVkfEtLEsSnYKgQ",
                }
            )
        )))
    ),
    responses(
        (status = 200, description = "The payment method has been deleted successfully", body = PaymentMethodDeleteSessionResponse),
        (status = 404, description = "The request is invalid")
    ),
    tag = "Payment Method Session",
    operation_id = "Delete a saved payment method",
    security(("publishable_key__client_secret" = []))
)]
pub fn payment_method_session_delete_saved_payment_method_v1() {}
/// Card network tokenization - Create using raw card data
///
/// Create a card network token for a customer and store it as a payment method.
/// This API expects raw card details for creating a network token with the card networks.
#[utoipa::path(
    post,
    path = "/payment_methods/tokenize-card",
    request_body = CardNetworkTokenizeRequest,
    responses(
        (status = 200, description = "Payment Method Created", body = CardNetworkTokenizeResponse),
        (status = 404, description = "Customer not found"),
    ),
    tag = "Payment Methods",
    operation_id = "Create card network token",
    security(("admin_api_key" = []))
)]
pub async fn tokenize_card_api() {}

/// Card network tokenization - Create using existing payment method
///
/// Create a card network token for a customer for an existing payment method.
/// This API expects an existing payment method ID for a card.
#[utoipa::path(
    post,
    path = "/payment_methods/{id}/tokenize-card",
    request_body = CardNetworkTokenizeRequest,
    params (
        ("id" = String, Path, description = "The unique identifier for the Payment Method"),
    ),
    responses(
        (status = 200, description = "Payment Method Updated", body = CardNetworkTokenizeResponse),
        (status = 404, description = "Customer not found"),
    ),
    tag = "Payment Methods",
    operation_id = "Create card network token using Payment Method ID",
    security(("admin_api_key" = []))
)]
pub async fn tokenize_card_using_pm_api() {}

/// Payment Method Session - Confirm a payment method session
///
/// **Confirms a payment method session object with the payment method data**
#[utoipa::path(
  post,
  path = "/v2/payment-method-sessions/{id}/confirm",
  params (("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
      (
        "X-Profile-Id" = String, Header,
        description = "Profile ID associated to the payment intent",
        example = "pro_abcdefghijklmnop"
      )
    ),
  request_body(
      content = PaymentMethodSessionConfirmRequest,
      examples(
          (
              "Confirm the payment method session with card details" = (
                  value = json!({
                    "payment_method_type": "card",
                    "payment_method_subtype": "credit",
                    "payment_method_data": {
                      "card": {
                        "card_number": "4242424242424242",
                        "card_exp_month": "10",
                        "card_exp_year": "30",
                        "card_cvc": "123"
                      }
                    },
                  })
              )
          ),
      ),
  ),
  responses(
      (status = 200, description = "Payment Method created", body = PaymentMethodSessionResponse),
      (status = 400, description = "Missing Mandatory fields")
  ),
  tag = "Payment Method Session",
  operation_id = "Confirm the payment method session",
  security(("publishable_key__client_secret" = [])),
)]
#[cfg(feature = "v2")]
pub fn payment_method_session_confirm() {}

/// Payment Method Session - Confirm a payment method session
///
/// **Confirms a payment method session object with the payment method data**
#[utoipa::path(
  post,
  path = "/v1/payment-method-sessions/{id}/confirm",
  params (("id" = String, Path, description = "The unique identifier for the Payment Method Session"),
      (
        "X-Profile-Id" = String, Header,
        description = "Profile ID associated to the payment intent",
        example = "pro_abcdefghijklmnop"
      )
    ),
  request_body(
      content = PaymentMethodSessionConfirmRequest,
      examples(
          (
              "Confirm the payment method session with card details" = (
                  value = json!({
                    "payment_method_type": "card",
                    "payment_method_subtype": "credit",
                    "payment_method_data": {
                      "card": {
                        "card_number": "4242424242424242",
                        "card_exp_month": "10",
                        "card_exp_year": "30",
                        "card_cvc": "123"
                      }
                    },
                  })
              )
          ),
      ),
  ),
  responses(
      (status = 200, description = "Payment Method created", body = PaymentMethodSessionResponse),
      (status = 400, description = "Missing Mandatory fields")
  ),
  tag = "Payment Method Session",
  operation_id = "Confirm the payment method session",
  security(("publishable_key__client_secret" = [])),
)]
#[cfg(feature = "v2")]
pub fn payment_method_session_confirm_v1() {}
