mudbase 1.1.4

data/lib/mudbase/api/billing_api.rb

@@ -0,0 +1,729 @@
+=begin
+#MUDBASESDK
+
+#MUDBASE is a scalable, real-time, and secure Backend-as-a-Service (BaaS) platform  designed for modern applications. Built with custom logic, it offers fine-grained  control, extensibility, and enterprise-grade security.  ## Features - 🔐 Multi-provider authentication (30+ OAuth providers) - 📊 Real-time database with collections - 📁 File storage and management - 🔑 API key management with permissions - 🔗 Webhook system with retry logic - ⚡ Serverless functions - 💬 Multi-channel messaging (Push, Email, SMS) - 📈 Usage analytics and monitoring - 🌐 Real-time WebSocket events - 🔍 Full-text search capabilities - 💳 Billing: Flutterwave only for fiat (platform subscriptions + org payment processing with 7% + $0.50 split); crypto payment processor for multi-chain checkout - 📡 Block-based multi-chain wallet monitoring (ETH/UTXO scanners, GetBlock, scanner metrics API)  ## Testing Configurations Below are example configurations for testing in different environments:  ### Production ```json {   \"scheme\": \"http\",   \"base_path\": \"\",   \"host\": \"cloud.mudbase.dev\",   \"xApiKey\": \"xApiKey\",   \"bearerToken\": \"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY4NWFjYmUwZTEyOTkzMmZiYjdhMGZjMiIsImVtYWlsIjoibXVkaGF4a3NlcnZpY2VzQGdtYWlsLmNvbSIsImlhdCI6MTc1MDc4MDg5OCwiZXhwIjoxNzUwODY3Mjk4fQ.sfoqzEbCuz5Y8qHkLItzrZZYC823SPT4RbO7Kucqvuc\",   \"userId\": \"685acbe0e129932fbb7a0fc2\",   \"projectId\": \"685ad30be129932fbb7a1047\",   \"collectionId\": \"685ada8fd9416ac02f171abf\",   \"documentId\": \"685ae1210136e73fa1dcaf36\",   \"apikeyId\": \"685ae8a785426b6a4190d5fc\",   \"webhookId\": \"685af3992f9c4c96514247e9\",   \"functionId\": \"685af8b85d73a104065b6a77\",   \"fileId\": \"685af8b85d73a104065b6a77\" } 
+
+The version of the OpenAPI document: 1.1.4
+Contact: support@mudbase.dev
+Generated by: https://openapi-generator.tech
+Generator version: 7.20.0
+
+=end
+
+require 'cgi'
+
+module Mudbase
+  class BillingApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Check feature access (public)
+    # Check whether a customer has access to a feature (by plan or entitlement). Public; no auth required.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param email [String] Customer email
+    # @param feature [String] Feature slug to check access for
+    # @param [Hash] opts the optional parameters
+    # @return [CheckFeatureAccess200Response]
+    def check_feature_access(project_id, email, feature, opts = {})
+      data, _status_code, _headers = check_feature_access_with_http_info(project_id, email, feature, opts)
+      data
+    end
+
+    # Check feature access (public)
+    # Check whether a customer has access to a feature (by plan or entitlement). Public; no auth required.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param email [String] Customer email
+    # @param feature [String] Feature slug to check access for
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CheckFeatureAccess200Response, Integer, Hash)>] CheckFeatureAccess200Response data, response status code and response headers
+    def check_feature_access_with_http_info(project_id, email, feature, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.check_feature_access ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.check_feature_access"
+      end
+      # verify the required parameter 'email' is set
+      if @api_client.config.client_side_validation && email.nil?
+        fail ArgumentError, "Missing the required parameter 'email' when calling BillingApi.check_feature_access"
+      end
+      # verify the required parameter 'feature' is set
+      if @api_client.config.client_side_validation && feature.nil?
+        fail ArgumentError, "Missing the required parameter 'feature' when calling BillingApi.check_feature_access"
+      end
+      # resource path
+      local_var_path = '/api/billing/public/projects/{projectId}/feature-access'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'email'] = email
+      query_params[:'feature'] = feature
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CheckFeatureAccess200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.check_feature_access",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#check_feature_access\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Check subscription status (public)
+    # Check whether a customer (by email) has an active subscription for the project. Public; no auth required.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param email [String] Customer email to check subscription for
+    # @param [Hash] opts the optional parameters
+    # @return [CheckSubscription200Response]
+    def check_subscription(project_id, email, opts = {})
+      data, _status_code, _headers = check_subscription_with_http_info(project_id, email, opts)
+      data
+    end
+
+    # Check subscription status (public)
+    # Check whether a customer (by email) has an active subscription for the project. Public; no auth required.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param email [String] Customer email to check subscription for
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CheckSubscription200Response, Integer, Hash)>] CheckSubscription200Response data, response status code and response headers
+    def check_subscription_with_http_info(project_id, email, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.check_subscription ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.check_subscription"
+      end
+      # verify the required parameter 'email' is set
+      if @api_client.config.client_side_validation && email.nil?
+        fail ArgumentError, "Missing the required parameter 'email' when calling BillingApi.check_subscription"
+      end
+      # resource path
+      local_var_path = '/api/billing/public/projects/{projectId}/subscription'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'email'] = email
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CheckSubscription200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.check_subscription",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#check_subscription\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create checkout session (Flutterwave or crypto)
+    # Creates a checkout session for subscription billing. When Flutterwave is configured (platform), returns authorizationUrl and accessCode for redirect. When using crypto payment processor, returns checkoutUrl, paymentOptions (multi-chain USDC/USDT/BTC Lightning), and reference. 
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param create_checkout_session_request [CreateCheckoutSessionRequest] Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
+    # @param [Hash] opts the optional parameters
+    # @return [CreateCheckoutSession200Response]
+    def create_checkout_session(project_id, create_checkout_session_request, opts = {})
+      data, _status_code, _headers = create_checkout_session_with_http_info(project_id, create_checkout_session_request, opts)
+      data
+    end
+
+    # Create checkout session (Flutterwave or crypto)
+    # Creates a checkout session for subscription billing. When Flutterwave is configured (platform), returns authorizationUrl and accessCode for redirect. When using crypto payment processor, returns checkoutUrl, paymentOptions (multi-chain USDC/USDT/BTC Lightning), and reference. 
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param create_checkout_session_request [CreateCheckoutSessionRequest] Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(CreateCheckoutSession200Response, Integer, Hash)>] CreateCheckoutSession200Response data, response status code and response headers
+    def create_checkout_session_with_http_info(project_id, create_checkout_session_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.create_checkout_session ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.create_checkout_session"
+      end
+      # verify the required parameter 'create_checkout_session_request' is set
+      if @api_client.config.client_side_validation && create_checkout_session_request.nil?
+        fail ArgumentError, "Missing the required parameter 'create_checkout_session_request' when calling BillingApi.create_checkout_session"
+      end
+      # resource path
+      local_var_path = '/api/billing/public/projects/{projectId}/checkout'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(create_checkout_session_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CreateCheckoutSession200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.create_checkout_session",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#create_checkout_session\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get checkout payment details
+    # Returns payment intent/checkout status (for refresh or deep link). No auth required.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param payment_id [String] Payment ID or reference from checkout session
+    # @param [Hash] opts the optional parameters
+    # @return [GetCheckoutPayment200Response]
+    def get_checkout_payment(project_id, payment_id, opts = {})
+      data, _status_code, _headers = get_checkout_payment_with_http_info(project_id, payment_id, opts)
+      data
+    end
+
+    # Get checkout payment details
+    # Returns payment intent/checkout status (for refresh or deep link). No auth required.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param payment_id [String] Payment ID or reference from checkout session
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetCheckoutPayment200Response, Integer, Hash)>] GetCheckoutPayment200Response data, response status code and response headers
+    def get_checkout_payment_with_http_info(project_id, payment_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.get_checkout_payment ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.get_checkout_payment"
+      end
+      # verify the required parameter 'payment_id' is set
+      if @api_client.config.client_side_validation && payment_id.nil?
+        fail ArgumentError, "Missing the required parameter 'payment_id' when calling BillingApi.get_checkout_payment"
+      end
+      # resource path
+      local_var_path = '/api/billing/public/projects/{projectId}/checkout/{paymentId}'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s)).sub('{' + 'paymentId' + '}', CGI.escape(payment_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetCheckoutPayment200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.get_checkout_payment",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#get_checkout_payment\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get public plans (no auth required)
+    # Returns subscription plans available for the project. Public; no authentication required. Use for pricing pages and checkout flow.
+    # @param project_id [String] Project ID (MongoDB ObjectId) to list plans for.
+    # @param [Hash] opts the optional parameters
+    # @return [GetPublicPlans200Response]
+    def get_public_plans(project_id, opts = {})
+      data, _status_code, _headers = get_public_plans_with_http_info(project_id, opts)
+      data
+    end
+
+    # Get public plans (no auth required)
+    # Returns subscription plans available for the project. Public; no authentication required. Use for pricing pages and checkout flow.
+    # @param project_id [String] Project ID (MongoDB ObjectId) to list plans for.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(GetPublicPlans200Response, Integer, Hash)>] GetPublicPlans200Response data, response status code and response headers
+    def get_public_plans_with_http_info(project_id, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.get_public_plans ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.get_public_plans"
+      end
+      # resource path
+      local_var_path = '/api/billing/public/projects/{projectId}/plans'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'GetPublicPlans200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.get_public_plans",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#get_public_plans\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Crypto payment processor webhook
+    # Receives crypto payment events (payment.completed, etc.) for platform billing. No auth; verified by provider signature.
+    # @param handle_crypto_payment_webhook_request [HandleCryptoPaymentWebhookRequest] Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
+    # @param [Hash] opts the optional parameters
+    # @return [HandleCryptoPaymentWebhook200Response]
+    def handle_crypto_payment_webhook(handle_crypto_payment_webhook_request, opts = {})
+      data, _status_code, _headers = handle_crypto_payment_webhook_with_http_info(handle_crypto_payment_webhook_request, opts)
+      data
+    end
+
+    # Crypto payment processor webhook
+    # Receives crypto payment events (payment.completed, etc.) for platform billing. No auth; verified by provider signature.
+    # @param handle_crypto_payment_webhook_request [HandleCryptoPaymentWebhookRequest] Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(HandleCryptoPaymentWebhook200Response, Integer, Hash)>] HandleCryptoPaymentWebhook200Response data, response status code and response headers
+    def handle_crypto_payment_webhook_with_http_info(handle_crypto_payment_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.handle_crypto_payment_webhook ...'
+      end
+      # verify the required parameter 'handle_crypto_payment_webhook_request' is set
+      if @api_client.config.client_side_validation && handle_crypto_payment_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'handle_crypto_payment_webhook_request' when calling BillingApi.handle_crypto_payment_webhook"
+      end
+      # resource path
+      local_var_path = '/api/billing/webhooks/crypto'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(handle_crypto_payment_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'HandleCryptoPaymentWebhook200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.handle_crypto_payment_webhook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#handle_crypto_payment_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Flutterwave webhook
+    # Receives Flutterwave webhook events (charge.completed, payment.successful). No auth; verified by verif-hash header. - Subscription billing: meta without isPaymentProcessing triggers verifyPaymentAndCreateSubscription (mudbase_xxx refs). - Payment processing: meta.isPaymentProcessing === true triggers fiat payment record (mudbase_fiat_xxx refs); org share goes to org subaccount, platform fee to main or configured subaccounts. 
+    # @param handle_flutterwave_webhook_request [HandleFlutterwaveWebhookRequest] Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
+    # @param [Hash] opts the optional parameters
+    # @return [HandleCryptoPaymentWebhook200Response]
+    def handle_flutterwave_webhook(handle_flutterwave_webhook_request, opts = {})
+      data, _status_code, _headers = handle_flutterwave_webhook_with_http_info(handle_flutterwave_webhook_request, opts)
+      data
+    end
+
+    # Flutterwave webhook
+    # Receives Flutterwave webhook events (charge.completed, payment.successful). No auth; verified by verif-hash header. - Subscription billing: meta without isPaymentProcessing triggers verifyPaymentAndCreateSubscription (mudbase_xxx refs). - Payment processing: meta.isPaymentProcessing &#x3D;&#x3D;&#x3D; true triggers fiat payment record (mudbase_fiat_xxx refs); org share goes to org subaccount, platform fee to main or configured subaccounts. 
+    # @param handle_flutterwave_webhook_request [HandleFlutterwaveWebhookRequest] Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(HandleCryptoPaymentWebhook200Response, Integer, Hash)>] HandleCryptoPaymentWebhook200Response data, response status code and response headers
+    def handle_flutterwave_webhook_with_http_info(handle_flutterwave_webhook_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.handle_flutterwave_webhook ...'
+      end
+      # verify the required parameter 'handle_flutterwave_webhook_request' is set
+      if @api_client.config.client_side_validation && handle_flutterwave_webhook_request.nil?
+        fail ArgumentError, "Missing the required parameter 'handle_flutterwave_webhook_request' when calling BillingApi.handle_flutterwave_webhook"
+      end
+      # resource path
+      local_var_path = '/api/billing/webhooks/flutterwave'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(handle_flutterwave_webhook_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'HandleCryptoPaymentWebhook200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.handle_flutterwave_webhook",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#handle_flutterwave_webhook\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Initialize fiat payment (project-scoped)
+    # Same as org-level initialize-payment; projectId from path is used for scope and tx_ref. Resolves project to org and uses org's Flutterwave subaccount.
+    # @param project_id [String] Project ID for payment scope and tx_ref.
+    # @param initialize_payment_for_project_request [InitializePaymentForProjectRequest] Payment amount, currency, customer (email, name), and optional metadata.
+    # @param [Hash] opts the optional parameters
+    # @return [nil]
+    def initialize_payment_for_project(project_id, initialize_payment_for_project_request, opts = {})
+      initialize_payment_for_project_with_http_info(project_id, initialize_payment_for_project_request, opts)
+      nil
+    end
+
+    # Initialize fiat payment (project-scoped)
+    # Same as org-level initialize-payment; projectId from path is used for scope and tx_ref. Resolves project to org and uses org&#39;s Flutterwave subaccount.
+    # @param project_id [String] Project ID for payment scope and tx_ref.
+    # @param initialize_payment_for_project_request [InitializePaymentForProjectRequest] Payment amount, currency, customer (email, name), and optional metadata.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def initialize_payment_for_project_with_http_info(project_id, initialize_payment_for_project_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.initialize_payment_for_project ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.initialize_payment_for_project"
+      end
+      # verify the required parameter 'initialize_payment_for_project_request' is set
+      if @api_client.config.client_side_validation && initialize_payment_for_project_request.nil?
+        fail ArgumentError, "Missing the required parameter 'initialize_payment_for_project_request' when calling BillingApi.initialize_payment_for_project"
+      end
+      # resource path
+      local_var_path = '/api/projects/{projectId}/payment-processing/initialize-payment'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(initialize_payment_for_project_request)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['ProjectBearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.initialize_payment_for_project",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#initialize_payment_for_project\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Record usage (public)
+    # Record metered usage for a customer (e.g. api_calls, storage_mb). Used for usage-based billing. Public endpoint; optionally secured by webhook or API key in production.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param record_usage_request [RecordUsageRequest] Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
+    # @param [Hash] opts the optional parameters
+    # @return [MessageResponse]
+    def record_usage(project_id, record_usage_request, opts = {})
+      data, _status_code, _headers = record_usage_with_http_info(project_id, record_usage_request, opts)
+      data
+    end
+
+    # Record usage (public)
+    # Record metered usage for a customer (e.g. api_calls, storage_mb). Used for usage-based billing. Public endpoint; optionally secured by webhook or API key in production.
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param record_usage_request [RecordUsageRequest] Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(MessageResponse, Integer, Hash)>] MessageResponse data, response status code and response headers
+    def record_usage_with_http_info(project_id, record_usage_request, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.record_usage ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.record_usage"
+      end
+      # verify the required parameter 'record_usage_request' is set
+      if @api_client.config.client_side_validation && record_usage_request.nil?
+        fail ArgumentError, "Missing the required parameter 'record_usage_request' when calling BillingApi.record_usage"
+      end
+      # resource path
+      local_var_path = '/api/billing/public/projects/{projectId}/usage'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(record_usage_request)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'MessageResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.record_usage",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#record_usage\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Verify payment and create subscription
+    # Verifies payment by reference (Flutterwave mudbase_xxx or crypto pmt_xxx) and creates or updates the subscription. Call after redirect from payment provider; pass reference as query (e.g. ?reference=mudbase_abc123). Idempotent for same reference. 
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param reference [String] Payment reference (e.g. mudbase_abc123 or pmt_abc123)
+    # @param [Hash] opts the optional parameters
+    # @return [VerifyPayment200Response]
+    def verify_payment(project_id, reference, opts = {})
+      data, _status_code, _headers = verify_payment_with_http_info(project_id, reference, opts)
+      data
+    end
+
+    # Verify payment and create subscription
+    # Verifies payment by reference (Flutterwave mudbase_xxx or crypto pmt_xxx) and creates or updates the subscription. Call after redirect from payment provider; pass reference as query (e.g. ?reference&#x3D;mudbase_abc123). Idempotent for same reference. 
+    # @param project_id [String] Project ID (MongoDB ObjectId) for the billing project.
+    # @param reference [String] Payment reference (e.g. mudbase_abc123 or pmt_abc123)
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(VerifyPayment200Response, Integer, Hash)>] VerifyPayment200Response data, response status code and response headers
+    def verify_payment_with_http_info(project_id, reference, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: BillingApi.verify_payment ...'
+      end
+      # verify the required parameter 'project_id' is set
+      if @api_client.config.client_side_validation && project_id.nil?
+        fail ArgumentError, "Missing the required parameter 'project_id' when calling BillingApi.verify_payment"
+      end
+      # verify the required parameter 'reference' is set
+      if @api_client.config.client_side_validation && reference.nil?
+        fail ArgumentError, "Missing the required parameter 'reference' when calling BillingApi.verify_payment"
+      end
+      # resource path
+      local_var_path = '/api/billing/public/projects/{projectId}/verify-payment'.sub('{' + 'projectId' + '}', CGI.escape(project_id.to_s))
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'reference'] = reference
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'VerifyPayment200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || []
+
+      new_options = opts.merge(
+        :operation => :"BillingApi.verify_payment",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: BillingApi#verify_payment\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end