mudbase 1.2.12 → 1.3.1

data/docs/BillingApi.md

@@ -4,25 +4,116 @@ All URIs are relative to *https://cloud.mudbase.dev*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**billing_check_feature_access**](BillingApi.md#billing_check_feature_access) | **GET** /api/billing/public/projects/{projectId}/feature-access | Check feature access (public) |
-| [**billing_check_subscription**](BillingApi.md#billing_check_subscription) | **GET** /api/billing/public/projects/{projectId}/subscription | Check subscription status (public) |
-| [**billing_create_checkout_session**](BillingApi.md#billing_create_checkout_session) | **POST** /api/billing/public/projects/{projectId}/checkout | Create checkout session (Flutterwave or crypto) |
-| [**billing_get_checkout_payment**](BillingApi.md#billing_get_checkout_payment) | **GET** /api/billing/public/projects/{projectId}/checkout/{paymentId} | Get checkout payment details |
-| [**billing_get_public_plans**](BillingApi.md#billing_get_public_plans) | **GET** /api/billing/public/projects/{projectId}/plans | Get public plans (no auth required) |
-| [**billing_handle_crypto_webhook**](BillingApi.md#billing_handle_crypto_webhook) | **POST** /api/billing/webhooks/crypto | Crypto payment processor webhook |
-| [**billing_handle_flutterwave_webhook**](BillingApi.md#billing_handle_flutterwave_webhook) | **POST** /api/billing/webhooks/flutterwave | Flutterwave webhook |
-| [**billing_initialize_payment**](BillingApi.md#billing_initialize_payment) | **POST** /api/projects/{projectId}/payment-processing/initialize-payment | Initialize fiat payment (app-scoped) |
-| [**billing_record_usage**](BillingApi.md#billing_record_usage) | **POST** /api/billing/public/projects/{projectId}/usage | Record usage (public) |
-| [**billing_verify_payment**](BillingApi.md#billing_verify_payment) | **POST** /api/billing/public/projects/{projectId}/verify-payment | Verify payment and create subscription |
+| [**cancel_subscription**](BillingApi.md#cancel_subscription) | **POST** /api/billing/subscriptions/{subscriptionId}/cancel | Cancel subscription |
+| [**check_feature_access**](BillingApi.md#check_feature_access) | **GET** /api/billing/public/projects/{projectId}/feature-access | Check feature access (public) |
+| [**check_subscription**](BillingApi.md#check_subscription) | **GET** /api/billing/public/projects/{projectId}/subscription | Check subscription status (public) |
+| [**create_checkout_session**](BillingApi.md#create_checkout_session) | **POST** /api/billing/public/projects/{projectId}/checkout | Create checkout session (fiat) |
+| [**create_plan**](BillingApi.md#create_plan) | **POST** /api/billing/projects/{projectId}/plans | Create billing plan |
+| [**delete_plan**](BillingApi.md#delete_plan) | **DELETE** /api/billing/projects/{projectId}/plans/{planId} | Delete billing plan |
+| [**download_invoice**](BillingApi.md#download_invoice) | **GET** /api/billing/projects/{projectId}/invoices/{invoiceId}/download | Download invoice PDF |
+| [**enable_payment_processing**](BillingApi.md#enable_payment_processing) | **POST** /api/orgs/{orgId}/payment-processing/enable | Enable payment processing for organization |
+| [**export_invoice**](BillingApi.md#export_invoice) | **GET** /api/billing/projects/{projectId}/invoices/{invoiceId}/export | Export invoice (e.g. PDF URL or file) |
+| [**get_billing_estimate**](BillingApi.md#get_billing_estimate) | **GET** /api/billing/estimate | Get billing estimate and forecast |
+| [**get_checkout_payment**](BillingApi.md#get_checkout_payment) | **GET** /api/billing/public/projects/{projectId}/checkout/{paymentId} | Get checkout payment details (not used for fiat billing) |
+| [**get_dashboard**](BillingApi.md#get_dashboard) | **GET** /api/billing/projects/{projectId}/dashboard | Get billing dashboard data |
+| [**get_fee_breakdown**](BillingApi.md#get_fee_breakdown) | **GET** /api/orgs/{orgId}/payment-processing/fee-breakdown | Get fee breakdown for a given amount |
+| [**get_invoice**](BillingApi.md#get_invoice) | **GET** /api/billing/projects/{projectId}/invoices/{invoiceId} | Get single invoice |
+| [**get_invoices**](BillingApi.md#get_invoices) | **GET** /api/billing/projects/{projectId}/invoices | List project invoices |
+| [**get_payment_records**](BillingApi.md#get_payment_records) | **GET** /api/orgs/{orgId}/payment-processing/records | List fiat payment records for organization |
+| [**get_plans**](BillingApi.md#get_plans) | **GET** /api/billing/projects/{projectId}/plans | Get billing plans |
+| [**get_public_plans**](BillingApi.md#get_public_plans) | **GET** /api/billing/public/projects/{projectId}/plans | Get public plans (no auth required) |
+| [**get_subscription_tier_by_id**](BillingApi.md#get_subscription_tier_by_id) | **GET** /api/billing/plans/{planId} | Get one subscription tier by id |
+| [**get_subscription_tiers**](BillingApi.md#get_subscription_tiers) | **GET** /api/billing/plans | Get subscription tiers (org-level BaaS plans) |
+| [**get_subscriptions**](BillingApi.md#get_subscriptions) | **GET** /api/billing/projects/{projectId}/subscriptions | Get subscriptions |
+| [**handle_flutterwave_webhook**](BillingApi.md#handle_flutterwave_webhook) | **POST** /api/billing/webhooks/flutterwave | Payment gateway webhook |
+| [**initialize_org_plan_checkout**](BillingApi.md#initialize_org_plan_checkout) | **POST** /api/billing/org/checkout | Initialize org-level BaaS plan payment (Starter, Growth, Scale) |
+| [**initialize_payment**](BillingApi.md#initialize_payment) | **POST** /api/orgs/{orgId}/payment-processing/initialize-payment | Initialize fiat payment with split (org subaccount + platform fee) |
+| [**initialize_payment_for_project**](BillingApi.md#initialize_payment_for_project) | **POST** /api/projects/{projectId}/payment-processing/initialize-payment | Initialize fiat payment (project-scoped) |
+| [**record_usage**](BillingApi.md#record_usage) | **POST** /api/billing/public/projects/{projectId}/usage | Record usage (public) |
+| [**update_plan**](BillingApi.md#update_plan) | **PATCH** /api/billing/projects/{projectId}/plans/{planId} | Update billing plan |
+| [**verify_org_plan_payment**](BillingApi.md#verify_org_plan_payment) | **POST** /api/billing/org/verify-payment | Verify org-level plan payment |
+| [**verify_payment**](BillingApi.md#verify_payment) | **POST** /api/billing/public/projects/{projectId}/verify-payment | Verify payment and create subscription |
+
+
+## cancel_subscription
+
+> <DeleteRole200Response> cancel_subscription(subscription_id, opts)
+
+Cancel subscription
 
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
 
-## billing_check_feature_access
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
 
-> <BillingCheckFeatureAccess200Response> billing_check_feature_access(project_id, email, feature)
+api_instance = Mudbase::BillingApi.new
+subscription_id = 'subscription_id_example' # String | 
+opts = {
+  cancel_subscription_request: Mudbase::CancelSubscriptionRequest.new # CancelSubscriptionRequest | 
+}
 
-Check feature access (public)
+begin
+  # Cancel subscription
+  result = api_instance.cancel_subscription(subscription_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->cancel_subscription: #{e}"
+end
+```
+
+#### Using the cancel_subscription_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<DeleteRole200Response>, Integer, Hash)> cancel_subscription_with_http_info(subscription_id, opts)
+
+```ruby
+begin
+  # Cancel subscription
+  data, status_code, headers = api_instance.cancel_subscription_with_http_info(subscription_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <DeleteRole200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->cancel_subscription_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **subscription_id** | **String** |  |  |
+| **cancel_subscription_request** | [**CancelSubscriptionRequest**](CancelSubscriptionRequest.md) |  | [optional] |
+
+### Return type
+
+[**DeleteRole200Response**](DeleteRole200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## check_feature_access
+
+> <CheckFeatureAccess200Response> check_feature_access(project_id, email, feature)
 
-Check whether a customer has access to a feature (by plan or entitlement). Public; no auth required.
+Check feature access (public)
 
 ### Examples
 
@@ -31,34 +122,34 @@ require 'time'
 require 'mudbase'
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID (MongoDB ObjectId) for the billing project.
+project_id = 'project_id_example' # String | 
 email = 'email_example' # String | Customer email
 feature = 'feature_example' # String | Feature slug to check access for
 
 begin
   # Check feature access (public)
-  result = api_instance.billing_check_feature_access(project_id, email, feature)
+  result = api_instance.check_feature_access(project_id, email, feature)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_check_feature_access: #{e}"
+  puts "Error when calling BillingApi->check_feature_access: #{e}"
 end
 ```
 
-#### Using the billing_check_feature_access_with_http_info variant
+#### Using the check_feature_access_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingCheckFeatureAccess200Response>, Integer, Hash)> billing_check_feature_access_with_http_info(project_id, email, feature)
+> <Array(<CheckFeatureAccess200Response>, Integer, Hash)> check_feature_access_with_http_info(project_id, email, feature)
 
 ```ruby
 begin
   # Check feature access (public)
-  data, status_code, headers = api_instance.billing_check_feature_access_with_http_info(project_id, email, feature)
+  data, status_code, headers = api_instance.check_feature_access_with_http_info(project_id, email, feature)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingCheckFeatureAccess200Response>
+  p data # => <CheckFeatureAccess200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_check_feature_access_with_http_info: #{e}"
+  puts "Error when calling BillingApi->check_feature_access_with_http_info: #{e}"
 end
 ```
 
@@ -66,13 +157,13 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID (MongoDB ObjectId) for the billing project. |  |
+| **project_id** | **String** |  |  |
 | **email** | **String** | Customer email |  |
 | **feature** | **String** | Feature slug to check access for |  |
 
 ### Return type
 
-[**BillingCheckFeatureAccess200Response**](BillingCheckFeatureAccess200Response.md)
+[**CheckFeatureAccess200Response**](CheckFeatureAccess200Response.md)
 
 ### Authorization
 
@@ -84,14 +175,12 @@ No authorization required
 - **Accept**: application/json
 
 
-## billing_check_subscription
+## check_subscription
 
-> <BillingCheckSubscription200Response> billing_check_subscription(project_id, email)
+> <CheckSubscription200Response> check_subscription(project_id, email)
 
 Check subscription status (public)
 
-Check whether a customer (by email) has an active subscription for the project. Public; no auth required.
-
 ### Examples
 
 ```ruby
@@ -99,33 +188,33 @@ require 'time'
 require 'mudbase'
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID (MongoDB ObjectId) for the billing project.
+project_id = 'project_id_example' # String | 
 email = 'email_example' # String | Customer email to check subscription for
 
 begin
   # Check subscription status (public)
-  result = api_instance.billing_check_subscription(project_id, email)
+  result = api_instance.check_subscription(project_id, email)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_check_subscription: #{e}"
+  puts "Error when calling BillingApi->check_subscription: #{e}"
 end
 ```
 
-#### Using the billing_check_subscription_with_http_info variant
+#### Using the check_subscription_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingCheckSubscription200Response>, Integer, Hash)> billing_check_subscription_with_http_info(project_id, email)
+> <Array(<CheckSubscription200Response>, Integer, Hash)> check_subscription_with_http_info(project_id, email)
 
 ```ruby
 begin
   # Check subscription status (public)
-  data, status_code, headers = api_instance.billing_check_subscription_with_http_info(project_id, email)
+  data, status_code, headers = api_instance.check_subscription_with_http_info(project_id, email)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingCheckSubscription200Response>
+  p data # => <CheckSubscription200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_check_subscription_with_http_info: #{e}"
+  puts "Error when calling BillingApi->check_subscription_with_http_info: #{e}"
 end
 ```
 
@@ -133,12 +222,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID (MongoDB ObjectId) for the billing project. |  |
+| **project_id** | **String** |  |  |
 | **email** | **String** | Customer email to check subscription for |  |
 
 ### Return type
 
-[**BillingCheckSubscription200Response**](BillingCheckSubscription200Response.md)
+[**CheckSubscription200Response**](CheckSubscription200Response.md)
 
 ### Authorization
 
@@ -150,13 +239,13 @@ No authorization required
 - **Accept**: application/json
 
 
-## billing_create_checkout_session
+## create_checkout_session
 
-> <BillingCreateCheckoutSession200Response> billing_create_checkout_session(project_id, billing_create_checkout_session_request)
+> <CreateCheckoutSession200Response> create_checkout_session(project_id, create_checkout_session_request)
 
-Create checkout session (Flutterwave or crypto)
+Create checkout session (fiat)
 
-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. 
+**Customer subscription flow — Step 2.** Creates a fiat checkout session. Request body must include planId (from GET public plans), billingCycle (monthly|yearly), and customerInfo.email. Redirect the user to **checkoutUrl** (same URL as authorizationUrl). After payment, call verify-payment with **reference** (mudbase_...). Response includes only fiat fields (no paymentAddress, paymentOptions, network, asset, or pmt_ references). 
 
 ### Examples
 
@@ -165,33 +254,33 @@ require 'time'
 require 'mudbase'
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID (MongoDB ObjectId) for the billing project.
-billing_create_checkout_session_request = Mudbase::BillingCreateCheckoutSessionRequest.new({plan_id: 'plan_id_example', billing_cycle: 'monthly', customer_info: Mudbase::BillingCreateCheckoutSessionRequestCustomerInfo.new({email: 'email_example'})}) # BillingCreateCheckoutSessionRequest | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
+project_id = 'project_id_example' # String | Project ID
+create_checkout_session_request = Mudbase::CreateCheckoutSessionRequest.new({plan_id: 'plan_id_example', billing_cycle: 'monthly', customer_info: Mudbase::CreateCheckoutSessionRequestCustomerInfo.new({email: 'email_example'})}) # CreateCheckoutSessionRequest | 
 
 begin
-  # Create checkout session (Flutterwave or crypto)
-  result = api_instance.billing_create_checkout_session(project_id, billing_create_checkout_session_request)
+  # Create checkout session (fiat)
+  result = api_instance.create_checkout_session(project_id, create_checkout_session_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_create_checkout_session: #{e}"
+  puts "Error when calling BillingApi->create_checkout_session: #{e}"
 end
 ```
 
-#### Using the billing_create_checkout_session_with_http_info variant
+#### Using the create_checkout_session_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingCreateCheckoutSession200Response>, Integer, Hash)> billing_create_checkout_session_with_http_info(project_id, billing_create_checkout_session_request)
+> <Array(<CreateCheckoutSession200Response>, Integer, Hash)> create_checkout_session_with_http_info(project_id, create_checkout_session_request)
 
 ```ruby
 begin
-  # Create checkout session (Flutterwave or crypto)
-  data, status_code, headers = api_instance.billing_create_checkout_session_with_http_info(project_id, billing_create_checkout_session_request)
+  # Create checkout session (fiat)
+  data, status_code, headers = api_instance.create_checkout_session_with_http_info(project_id, create_checkout_session_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingCreateCheckoutSession200Response>
+  p data # => <CreateCheckoutSession200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_create_checkout_session_with_http_info: #{e}"
+  puts "Error when calling BillingApi->create_checkout_session_with_http_info: #{e}"
 end
 ```
 
@@ -199,12 +288,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID (MongoDB ObjectId) for the billing project. |  |
-| **billing_create_checkout_session_request** | [**BillingCreateCheckoutSessionRequest**](BillingCreateCheckoutSessionRequest.md) | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs. |  |
+| **project_id** | **String** | Project ID |  |
+| **create_checkout_session_request** | [**CreateCheckoutSessionRequest**](CreateCheckoutSessionRequest.md) |  |  |
 
 ### Return type
 
-[**BillingCreateCheckoutSession200Response**](BillingCreateCheckoutSession200Response.md)
+[**CreateCheckoutSession200Response**](CreateCheckoutSession200Response.md)
 
 ### Authorization
 
@@ -216,48 +305,126 @@ No authorization required
 - **Accept**: application/json
 
 
-## billing_get_checkout_payment
+## create_plan
+
+> <CreatePlan201Response> create_plan(project_id, create_plan_request)
+
+Create billing plan
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+create_plan_request = Mudbase::CreatePlanRequest.new({name: 'name_example', price: 3.56, currency: 'USD', interval: 'month'}) # CreatePlanRequest | 
+
+begin
+  # Create billing plan
+  result = api_instance.create_plan(project_id, create_plan_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->create_plan: #{e}"
+end
+```
+
+#### Using the create_plan_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreatePlan201Response>, Integer, Hash)> create_plan_with_http_info(project_id, create_plan_request)
+
+```ruby
+begin
+  # Create billing plan
+  data, status_code, headers = api_instance.create_plan_with_http_info(project_id, create_plan_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreatePlan201Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->create_plan_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+| **create_plan_request** | [**CreatePlanRequest**](CreatePlanRequest.md) |  |  |
+
+### Return type
+
+[**CreatePlan201Response**](CreatePlan201Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
 
-> <BillingGetCheckoutPayment200Response> billing_get_checkout_payment(project_id, payment_id)
 
-Get checkout payment details
+## delete_plan
 
-Returns payment intent/checkout status (for refresh or deep link). No auth required.
+> <MessageResponse> delete_plan(project_id, plan_id)
+
+Delete billing plan
 
 ### Examples
 
 ```ruby
 require 'time'
 require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID (MongoDB ObjectId) for the billing project.
-payment_id = 'payment_id_example' # String | Payment ID or reference from checkout session
+project_id = 'project_id_example' # String | 
+plan_id = 'plan_id_example' # String | 
 
 begin
-  # Get checkout payment details
-  result = api_instance.billing_get_checkout_payment(project_id, payment_id)
+  # Delete billing plan
+  result = api_instance.delete_plan(project_id, plan_id)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_get_checkout_payment: #{e}"
+  puts "Error when calling BillingApi->delete_plan: #{e}"
 end
 ```
 
-#### Using the billing_get_checkout_payment_with_http_info variant
+#### Using the delete_plan_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingGetCheckoutPayment200Response>, Integer, Hash)> billing_get_checkout_payment_with_http_info(project_id, payment_id)
+> <Array(<MessageResponse>, Integer, Hash)> delete_plan_with_http_info(project_id, plan_id)
 
 ```ruby
 begin
-  # Get checkout payment details
-  data, status_code, headers = api_instance.billing_get_checkout_payment_with_http_info(project_id, payment_id)
+  # Delete billing plan
+  data, status_code, headers = api_instance.delete_plan_with_http_info(project_id, plan_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingGetCheckoutPayment200Response>
+  p data # => <MessageResponse>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_get_checkout_payment_with_http_info: #{e}"
+  puts "Error when calling BillingApi->delete_plan_with_http_info: #{e}"
 end
 ```
 
@@ -265,16 +432,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID (MongoDB ObjectId) for the billing project. |  |
-| **payment_id** | **String** | Payment ID or reference from checkout session |  |
+| **project_id** | **String** |  |  |
+| **plan_id** | **String** |  |  |
 
 ### Return type
 
-[**BillingGetCheckoutPayment200Response**](BillingGetCheckoutPayment200Response.md)
+[**MessageResponse**](MessageResponse.md)
 
 ### Authorization
 
-No authorization required
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -282,47 +449,54 @@ No authorization required
 - **Accept**: application/json
 
 
-## billing_get_public_plans
+## download_invoice
 
-> <BillingGetPublicPlans200Response> billing_get_public_plans(project_id)
-
-Get public plans (no auth required)
+> File download_invoice(project_id, invoice_id)
 
-Returns subscription plans available for the project. Public; no authentication required. Use for pricing pages and checkout flow.
+Download invoice PDF
 
 ### Examples
 
 ```ruby
 require 'time'
 require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID (MongoDB ObjectId) to list plans for.
+project_id = 'project_id_example' # String | 
+invoice_id = 'invoice_id_example' # String | 
 
 begin
-  # Get public plans (no auth required)
-  result = api_instance.billing_get_public_plans(project_id)
+  # Download invoice PDF
+  result = api_instance.download_invoice(project_id, invoice_id)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_get_public_plans: #{e}"
+  puts "Error when calling BillingApi->download_invoice: #{e}"
 end
 ```
 
-#### Using the billing_get_public_plans_with_http_info variant
+#### Using the download_invoice_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingGetPublicPlans200Response>, Integer, Hash)> billing_get_public_plans_with_http_info(project_id)
+> <Array(File, Integer, Hash)> download_invoice_with_http_info(project_id, invoice_id)
 
 ```ruby
 begin
-  # Get public plans (no auth required)
-  data, status_code, headers = api_instance.billing_get_public_plans_with_http_info(project_id)
+  # Download invoice PDF
+  data, status_code, headers = api_instance.download_invoice_with_http_info(project_id, invoice_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingGetPublicPlans200Response>
+  p data # => File
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_get_public_plans_with_http_info: #{e}"
+  puts "Error when calling BillingApi->download_invoice_with_http_info: #{e}"
 end
 ```
 
@@ -330,63 +504,70 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID (MongoDB ObjectId) to list plans for. |  |
+| **project_id** | **String** |  |  |
+| **invoice_id** | **String** |  |  |
 
 ### Return type
 
-[**BillingGetPublicPlans200Response**](BillingGetPublicPlans200Response.md)
+**File**
 
 ### Authorization
 
-No authorization required
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
 - **Content-Type**: Not defined
-- **Accept**: application/json
+- **Accept**: application/pdf, application/json
 
 
-## billing_handle_crypto_webhook
+## enable_payment_processing
 
-> <BillingHandleCryptoWebhook200Response> billing_handle_crypto_webhook(billing_handle_crypto_webhook_request)
+> <EnablePaymentProcessing200Response> enable_payment_processing(org_id, enable_payment_processing_request)
 
-Crypto payment processor webhook
+Enable payment processing for organization
 
-Receives crypto payment events (payment.completed, etc.) for platform billing. No auth; verified by provider signature.
+Creates a payment-collection subaccount for the org with the provided bank details. Use USD-capable bank (e.g. country US) for USD settlement. BVN only required when country is NG. Requires owner or admin role.
 
 ### Examples
 
 ```ruby
 require 'time'
 require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
 
 api_instance = Mudbase::BillingApi.new
-billing_handle_crypto_webhook_request = Mudbase::BillingHandleCryptoWebhookRequest.new({event: 'payment.created', data: Mudbase::BillingHandleCryptoWebhookRequestData.new}) # BillingHandleCryptoWebhookRequest | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
+org_id = 'org_id_example' # String | 
+enable_payment_processing_request = Mudbase::EnablePaymentProcessingRequest.new({account_bank: 'account_bank_example', account_number: 'account_number_example', country: 'country_example', business_name: 'business_name_example'}) # EnablePaymentProcessingRequest | 
 
 begin
-  # Crypto payment processor webhook
-  result = api_instance.billing_handle_crypto_webhook(billing_handle_crypto_webhook_request)
+  # Enable payment processing for organization
+  result = api_instance.enable_payment_processing(org_id, enable_payment_processing_request)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_handle_crypto_webhook: #{e}"
+  puts "Error when calling BillingApi->enable_payment_processing: #{e}"
 end
 ```
 
-#### Using the billing_handle_crypto_webhook_with_http_info variant
+#### Using the enable_payment_processing_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingHandleCryptoWebhook200Response>, Integer, Hash)> billing_handle_crypto_webhook_with_http_info(billing_handle_crypto_webhook_request)
+> <Array(<EnablePaymentProcessing200Response>, Integer, Hash)> enable_payment_processing_with_http_info(org_id, enable_payment_processing_request)
 
 ```ruby
 begin
-  # Crypto payment processor webhook
-  data, status_code, headers = api_instance.billing_handle_crypto_webhook_with_http_info(billing_handle_crypto_webhook_request)
+  # Enable payment processing for organization
+  data, status_code, headers = api_instance.enable_payment_processing_with_http_info(org_id, enable_payment_processing_request)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingHandleCryptoWebhook200Response>
+  p data # => <EnablePaymentProcessing200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_handle_crypto_webhook_with_http_info: #{e}"
+  puts "Error when calling BillingApi->enable_payment_processing_with_http_info: #{e}"
 end
 ```
 
@@ -394,15 +575,16 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **billing_handle_crypto_webhook_request** | [**BillingHandleCryptoWebhookRequest**](BillingHandleCryptoWebhookRequest.md) | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata). |  |
+| **org_id** | **String** |  |  |
+| **enable_payment_processing_request** | [**EnablePaymentProcessingRequest**](EnablePaymentProcessingRequest.md) |  |  |
 
 ### Return type
 
-[**BillingHandleCryptoWebhook200Response**](BillingHandleCryptoWebhook200Response.md)
+[**EnablePaymentProcessing200Response**](EnablePaymentProcessing200Response.md)
 
 ### Authorization
 
-No authorization required
+[OrgBearerAuth](../README.md#OrgBearerAuth)
 
 ### HTTP request headers
 
@@ -410,47 +592,54 @@ No authorization required
 - **Accept**: application/json
 
 
-## billing_handle_flutterwave_webhook
-
-> <BillingHandleCryptoWebhook200Response> billing_handle_flutterwave_webhook(billing_handle_flutterwave_webhook_request)
+## export_invoice
 
-Flutterwave webhook
+> <DownloadInvoice200Response> export_invoice(project_id, invoice_id)
 
-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. 
+Export invoice (e.g. PDF URL or file)
 
 ### Examples
 
 ```ruby
 require 'time'
 require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
 
 api_instance = Mudbase::BillingApi.new
-billing_handle_flutterwave_webhook_request = Mudbase::BillingHandleFlutterwaveWebhookRequest.new # BillingHandleFlutterwaveWebhookRequest | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
+project_id = 'project_id_example' # String | 
+invoice_id = 'invoice_id_example' # String | 
 
 begin
-  # Flutterwave webhook
-  result = api_instance.billing_handle_flutterwave_webhook(billing_handle_flutterwave_webhook_request)
+  # Export invoice (e.g. PDF URL or file)
+  result = api_instance.export_invoice(project_id, invoice_id)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_handle_flutterwave_webhook: #{e}"
+  puts "Error when calling BillingApi->export_invoice: #{e}"
 end
 ```
 
-#### Using the billing_handle_flutterwave_webhook_with_http_info variant
+#### Using the export_invoice_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingHandleCryptoWebhook200Response>, Integer, Hash)> billing_handle_flutterwave_webhook_with_http_info(billing_handle_flutterwave_webhook_request)
+> <Array(<DownloadInvoice200Response>, Integer, Hash)> export_invoice_with_http_info(project_id, invoice_id)
 
 ```ruby
 begin
-  # Flutterwave webhook
-  data, status_code, headers = api_instance.billing_handle_flutterwave_webhook_with_http_info(billing_handle_flutterwave_webhook_request)
+  # Export invoice (e.g. PDF URL or file)
+  data, status_code, headers = api_instance.export_invoice_with_http_info(project_id, invoice_id)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingHandleCryptoWebhook200Response>
+  p data # => <DownloadInvoice200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_handle_flutterwave_webhook_with_http_info: #{e}"
+  puts "Error when calling BillingApi->export_invoice_with_http_info: #{e}"
 end
 ```
 
@@ -458,29 +647,30 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **billing_handle_flutterwave_webhook_request** | [**BillingHandleFlutterwaveWebhookRequest**](BillingHandleFlutterwaveWebhookRequest.md) | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing). |  |
+| **project_id** | **String** |  |  |
+| **invoice_id** | **String** |  |  |
 
 ### Return type
 
-[**BillingHandleCryptoWebhook200Response**](BillingHandleCryptoWebhook200Response.md)
+[**DownloadInvoice200Response**](DownloadInvoice200Response.md)
 
 ### Authorization
 
-No authorization required
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## billing_initialize_payment
+## get_billing_estimate
 
-> billing_initialize_payment(project_id, billing_initialize_payment_request)
+> <GetBillingEstimate200Response> get_billing_estimate
 
-Initialize fiat payment (app-scoped)
+Get billing estimate and forecast
 
-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.
+Returns current-month overage estimate and an optional end-of-month forecast for the authenticated organization. Includes spend limit settings (soft/hard) and whether usage is currently blocked. Requires org-level JWT. 
 
 ### Examples
 
@@ -489,37 +679,98 @@ require 'time'
 require 'mudbase'
 # setup authorization
 Mudbase.configure do |config|
-  # Configure Bearer authorization (JWT): BearerToken
+  # Configure Bearer authorization (JWT): OrgBearerAuth
   config.access_token = 'YOUR_BEARER_TOKEN'
 end
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID for payment scope and tx_ref.
-billing_initialize_payment_request = Mudbase::BillingInitializePaymentRequest.new({amount: 3.56, customer: Mudbase::BillingInitializePaymentRequestCustomer.new({email: 'email_example'})}) # BillingInitializePaymentRequest | Payment amount, currency, customer (email, name), and optional metadata.
 
 begin
-  # Initialize fiat payment (app-scoped)
-  api_instance.billing_initialize_payment(project_id, billing_initialize_payment_request)
+  # Get billing estimate and forecast
+  result = api_instance.get_billing_estimate
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_billing_estimate: #{e}"
+end
+```
+
+#### Using the get_billing_estimate_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetBillingEstimate200Response>, Integer, Hash)> get_billing_estimate_with_http_info
+
+```ruby
+begin
+  # Get billing estimate and forecast
+  data, status_code, headers = api_instance.get_billing_estimate_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetBillingEstimate200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_billing_estimate_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetBillingEstimate200Response**](GetBillingEstimate200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_checkout_payment
+
+> get_checkout_payment(project_id, payment_id)
+
+Get checkout payment details (not used for fiat billing)
+
+**Fiat-only billing:** checkout is completed on the payment gateway's hosted page; there is no server-side payment intent to poll. The live API returns **404** for this route. Reserved for compatibility; do not rely on a success body for project billing. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+payment_id = 'payment_id_example' # String | Opaque id from checkout (fiat billing does not expose pollable payment state here)
+
+begin
+  # Get checkout payment details (not used for fiat billing)
+  api_instance.get_checkout_payment(project_id, payment_id)
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_initialize_payment: #{e}"
+  puts "Error when calling BillingApi->get_checkout_payment: #{e}"
 end
 ```
 
-#### Using the billing_initialize_payment_with_http_info variant
+#### Using the get_checkout_payment_with_http_info variant
 
 This returns an Array which contains the response data (`nil` in this case), status code and headers.
 
-> <Array(nil, Integer, Hash)> billing_initialize_payment_with_http_info(project_id, billing_initialize_payment_request)
+> <Array(nil, Integer, Hash)> get_checkout_payment_with_http_info(project_id, payment_id)
 
 ```ruby
 begin
-  # Initialize fiat payment (app-scoped)
-  data, status_code, headers = api_instance.billing_initialize_payment_with_http_info(project_id, billing_initialize_payment_request)
+  # Get checkout payment details (not used for fiat billing)
+  data, status_code, headers = api_instance.get_checkout_payment_with_http_info(project_id, payment_id)
   p status_code # => 2xx
   p headers # => { ... }
   p data # => nil
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_initialize_payment_with_http_info: #{e}"
+  puts "Error when calling BillingApi->get_checkout_payment_with_http_info: #{e}"
 end
 ```
 
@@ -527,8 +778,8 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID for payment scope and tx_ref. |  |
-| **billing_initialize_payment_request** | [**BillingInitializePaymentRequest**](BillingInitializePaymentRequest.md) | Payment amount, currency, customer (email, name), and optional metadata. |  |
+| **project_id** | **String** |  |  |
+| **payment_id** | **String** | Opaque id from checkout (fiat billing does not expose pollable payment state here) |  |
 
 ### Return type
 
@@ -536,56 +787,134 @@ nil (empty response body)
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+No authorization required
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## billing_record_usage
+## get_dashboard
 
-> <MessageResponse> billing_record_usage(project_id, billing_record_usage_request)
+> <GetDashboard200Response> get_dashboard(project_id)
 
-Record usage (public)
+Get billing dashboard data
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+
+begin
+  # Get billing dashboard data
+  result = api_instance.get_dashboard(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_dashboard: #{e}"
+end
+```
+
+#### Using the get_dashboard_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetDashboard200Response>, Integer, Hash)> get_dashboard_with_http_info(project_id)
+
+```ruby
+begin
+  # Get billing dashboard data
+  data, status_code, headers = api_instance.get_dashboard_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetDashboard200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_dashboard_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+
+### Return type
+
+[**GetDashboard200Response**](GetDashboard200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_fee_breakdown
 
-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.
+> <GetFeeBreakdown200Response> get_fee_breakdown(org_id, amount, opts)
+
+Get fee breakdown for a given amount
+
+Returns orgReceives, platformPercent, platformFixed, processingFee for the given amount (7% + $0.50 platform fee; processing fee absorbed from platform share).
 
 ### Examples
 
 ```ruby
 require 'time'
 require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID (MongoDB ObjectId) for the billing project.
-billing_record_usage_request = Mudbase::BillingRecordUsageRequest.new({email: 'email_example', metric: 'metric_example', quantity: 3.56}) # BillingRecordUsageRequest | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
+org_id = 'org_id_example' # String | 
+amount = 8.14 # Float | 
+opts = {
+  currency: 'currency_example' # String | 
+}
 
 begin
-  # Record usage (public)
-  result = api_instance.billing_record_usage(project_id, billing_record_usage_request)
+  # Get fee breakdown for a given amount
+  result = api_instance.get_fee_breakdown(org_id, amount, opts)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_record_usage: #{e}"
+  puts "Error when calling BillingApi->get_fee_breakdown: #{e}"
 end
 ```
 
-#### Using the billing_record_usage_with_http_info variant
+#### Using the get_fee_breakdown_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<MessageResponse>, Integer, Hash)> billing_record_usage_with_http_info(project_id, billing_record_usage_request)
+> <Array(<GetFeeBreakdown200Response>, Integer, Hash)> get_fee_breakdown_with_http_info(org_id, amount, opts)
 
 ```ruby
 begin
-  # Record usage (public)
-  data, status_code, headers = api_instance.billing_record_usage_with_http_info(project_id, billing_record_usage_request)
+  # Get fee breakdown for a given amount
+  data, status_code, headers = api_instance.get_fee_breakdown_with_http_info(org_id, amount, opts)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <MessageResponse>
+  p data # => <GetFeeBreakdown200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_record_usage_with_http_info: #{e}"
+  puts "Error when calling BillingApi->get_fee_breakdown_with_http_info: #{e}"
 end
 ```
 
@@ -593,30 +922,1062 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID (MongoDB ObjectId) for the billing project. |  |
-| **billing_record_usage_request** | [**BillingRecordUsageRequest**](BillingRecordUsageRequest.md) | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record. |  |
+| **org_id** | **String** |  |  |
+| **amount** | **Float** |  |  |
+| **currency** | **String** |  | [optional][default to &#39;USD&#39;] |
 
 ### Return type
 
-[**MessageResponse**](MessageResponse.md)
+[**GetFeeBreakdown200Response**](GetFeeBreakdown200Response.md)
 
 ### Authorization
 
-No authorization required
+[OrgBearerAuth](../README.md#OrgBearerAuth)
 
 ### HTTP request headers
 
-- **Content-Type**: application/json
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_invoice
+
+> <GetInvoice200Response> get_invoice(project_id, invoice_id)
+
+Get single invoice
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+invoice_id = 'invoice_id_example' # String | 
+
+begin
+  # Get single invoice
+  result = api_instance.get_invoice(project_id, invoice_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_invoice: #{e}"
+end
+```
+
+#### Using the get_invoice_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetInvoice200Response>, Integer, Hash)> get_invoice_with_http_info(project_id, invoice_id)
+
+```ruby
+begin
+  # Get single invoice
+  data, status_code, headers = api_instance.get_invoice_with_http_info(project_id, invoice_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetInvoice200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_invoice_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+| **invoice_id** | **String** |  |  |
+
+### Return type
+
+[**GetInvoice200Response**](GetInvoice200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_invoices
+
+> <GetInvoices200Response> get_invoices(project_id)
+
+List project invoices
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+
+begin
+  # List project invoices
+  result = api_instance.get_invoices(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_invoices: #{e}"
+end
+```
+
+#### Using the get_invoices_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetInvoices200Response>, Integer, Hash)> get_invoices_with_http_info(project_id)
+
+```ruby
+begin
+  # List project invoices
+  data, status_code, headers = api_instance.get_invoices_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetInvoices200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_invoices_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+
+### Return type
+
+[**GetInvoices200Response**](GetInvoices200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_payment_records
+
+> <GetPaymentRecords200Response> get_payment_records(org_id, opts)
+
+List fiat payment records for organization
+
+Paginated list of FiatPaymentRecord for this org (txRef, amount, orgReceives, status, paidAt).
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+org_id = 'org_id_example' # String | 
+opts = {
+  page: 56, # Integer | 
+  limit: 56, # Integer | 
+  status: 'pending' # String | 
+}
+
+begin
+  # List fiat payment records for organization
+  result = api_instance.get_payment_records(org_id, opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_payment_records: #{e}"
+end
+```
+
+#### Using the get_payment_records_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetPaymentRecords200Response>, Integer, Hash)> get_payment_records_with_http_info(org_id, opts)
+
+```ruby
+begin
+  # List fiat payment records for organization
+  data, status_code, headers = api_instance.get_payment_records_with_http_info(org_id, opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetPaymentRecords200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_payment_records_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **org_id** | **String** |  |  |
+| **page** | **Integer** |  | [optional][default to 1] |
+| **limit** | **Integer** |  | [optional][default to 20] |
+| **status** | **String** |  | [optional] |
+
+### Return type
+
+[**GetPaymentRecords200Response**](GetPaymentRecords200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_plans
+
+> <GetPlans200Response> get_plans(project_id)
+
+Get billing plans
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+
+begin
+  # Get billing plans
+  result = api_instance.get_plans(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_plans: #{e}"
+end
+```
+
+#### Using the get_plans_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetPlans200Response>, Integer, Hash)> get_plans_with_http_info(project_id)
+
+```ruby
+begin
+  # Get billing plans
+  data, status_code, headers = api_instance.get_plans_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetPlans200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_plans_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+
+### Return type
+
+[**GetPlans200Response**](GetPlans200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_public_plans
+
+> <GetPublicPlans200Response> get_public_plans(project_id)
+
+Get public plans (no auth required)
+
+**Customer subscription flow — Step 1.** Returns all active plans for the project. Use a plan's _id as planId in the checkout request. No authentication required (for pricing/checkout pages). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+
+begin
+  # Get public plans (no auth required)
+  result = api_instance.get_public_plans(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_public_plans: #{e}"
+end
+```
+
+#### Using the get_public_plans_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetPublicPlans200Response>, Integer, Hash)> get_public_plans_with_http_info(project_id)
+
+```ruby
+begin
+  # Get public plans (no auth required)
+  data, status_code, headers = api_instance.get_public_plans_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetPublicPlans200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_public_plans_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+
+### Return type
+
+[**GetPublicPlans200Response**](GetPublicPlans200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_subscription_tier_by_id
+
+> <GetSubscriptionTierById200Response> get_subscription_tier_by_id(plan_id)
+
+Get one subscription tier by id
+
+Returns a single org-level BaaS plan (free, starter, growth, scale, enterprise). Public; no auth required.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::BillingApi.new
+plan_id = 'plan_id_example' # String | Plan id (free, starter, growth, scale, enterprise)
+
+begin
+  # Get one subscription tier by id
+  result = api_instance.get_subscription_tier_by_id(plan_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_subscription_tier_by_id: #{e}"
+end
+```
+
+#### Using the get_subscription_tier_by_id_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetSubscriptionTierById200Response>, Integer, Hash)> get_subscription_tier_by_id_with_http_info(plan_id)
+
+```ruby
+begin
+  # Get one subscription tier by id
+  data, status_code, headers = api_instance.get_subscription_tier_by_id_with_http_info(plan_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetSubscriptionTierById200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_subscription_tier_by_id_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **plan_id** | **String** | Plan id (free, starter, growth, scale, enterprise) |  |
+
+### Return type
+
+[**GetSubscriptionTierById200Response**](GetSubscriptionTierById200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_subscription_tiers
+
+> <GetSubscriptionTiers200Response> get_subscription_tiers
+
+Get subscription tiers (org-level BaaS plans)
+
+**Org-level BaaS plan catalog** (source of truth in paymentService.js). Returns Free, Starter ($29), Growth ($69), Scale ($199), Enterprise. Use for pricing page and to get plan ids for POST /api/billing/org/checkout. Public; no auth required. Each plan includes id (free|starter|growth|scale|enterprise), name, description, price (cents), priceYearly (cents, 8% off), currency, limits, overages, enforcement. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::BillingApi.new
+
+begin
+  # Get subscription tiers (org-level BaaS plans)
+  result = api_instance.get_subscription_tiers
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_subscription_tiers: #{e}"
+end
+```
+
+#### Using the get_subscription_tiers_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetSubscriptionTiers200Response>, Integer, Hash)> get_subscription_tiers_with_http_info
+
+```ruby
+begin
+  # Get subscription tiers (org-level BaaS plans)
+  data, status_code, headers = api_instance.get_subscription_tiers_with_http_info
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetSubscriptionTiers200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_subscription_tiers_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+[**GetSubscriptionTiers200Response**](GetSubscriptionTiers200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## get_subscriptions
+
+> <GetSubscriptions200Response> get_subscriptions(project_id)
+
+Get subscriptions
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+
+begin
+  # Get subscriptions
+  result = api_instance.get_subscriptions(project_id)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_subscriptions: #{e}"
+end
+```
+
+#### Using the get_subscriptions_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<GetSubscriptions200Response>, Integer, Hash)> get_subscriptions_with_http_info(project_id)
+
+```ruby
+begin
+  # Get subscriptions
+  data, status_code, headers = api_instance.get_subscriptions_with_http_info(project_id)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <GetSubscriptions200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->get_subscriptions_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+
+### Return type
+
+[**GetSubscriptions200Response**](GetSubscriptions200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: application/json
+
+
+## handle_flutterwave_webhook
+
+> <HandleFlutterwaveWebhook200Response> handle_flutterwave_webhook(handle_flutterwave_webhook_request)
+
+Payment gateway webhook
+
+Receives payment gateway 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. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::BillingApi.new
+handle_flutterwave_webhook_request = Mudbase::HandleFlutterwaveWebhookRequest.new # HandleFlutterwaveWebhookRequest | 
+
+begin
+  # Payment gateway webhook
+  result = api_instance.handle_flutterwave_webhook(handle_flutterwave_webhook_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->handle_flutterwave_webhook: #{e}"
+end
+```
+
+#### Using the handle_flutterwave_webhook_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<HandleFlutterwaveWebhook200Response>, Integer, Hash)> handle_flutterwave_webhook_with_http_info(handle_flutterwave_webhook_request)
+
+```ruby
+begin
+  # Payment gateway webhook
+  data, status_code, headers = api_instance.handle_flutterwave_webhook_with_http_info(handle_flutterwave_webhook_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <HandleFlutterwaveWebhook200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->handle_flutterwave_webhook_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **handle_flutterwave_webhook_request** | [**HandleFlutterwaveWebhookRequest**](HandleFlutterwaveWebhookRequest.md) |  |  |
+
+### Return type
+
+[**HandleFlutterwaveWebhook200Response**](HandleFlutterwaveWebhook200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## initialize_org_plan_checkout
+
+> <InitializeOrgPlanCheckout200Response> initialize_org_plan_checkout(initialize_org_plan_checkout_request)
+
+Initialize org-level BaaS plan payment (Starter, Growth, Scale)
+
+**Org plan payment flow — Step 2.** Creates a payment link for the authenticated org to subscribe to a BaaS plan (starter, growth, scale). Enterprise has no price; use contact-sales flow. Redirect the user to the returned link; after payment, call POST /api/billing/org/verify-payment with the tx_ref from the redirect. Requires org-level JWT. 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+initialize_org_plan_checkout_request = Mudbase::InitializeOrgPlanCheckoutRequest.new({plan_name: 'starter'}) # InitializeOrgPlanCheckoutRequest | 
+
+begin
+  # Initialize org-level BaaS plan payment (Starter, Growth, Scale)
+  result = api_instance.initialize_org_plan_checkout(initialize_org_plan_checkout_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->initialize_org_plan_checkout: #{e}"
+end
+```
+
+#### Using the initialize_org_plan_checkout_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<InitializeOrgPlanCheckout200Response>, Integer, Hash)> initialize_org_plan_checkout_with_http_info(initialize_org_plan_checkout_request)
+
+```ruby
+begin
+  # Initialize org-level BaaS plan payment (Starter, Growth, Scale)
+  data, status_code, headers = api_instance.initialize_org_plan_checkout_with_http_info(initialize_org_plan_checkout_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <InitializeOrgPlanCheckout200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->initialize_org_plan_checkout_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **initialize_org_plan_checkout_request** | [**InitializeOrgPlanCheckoutRequest**](InitializeOrgPlanCheckoutRequest.md) |  |  |
+
+### Return type
+
+[**InitializeOrgPlanCheckout200Response**](InitializeOrgPlanCheckout200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## initialize_payment
+
+> <InitializePayment200Response> initialize_payment(org_id, initialize_payment_request)
+
+Initialize fiat payment with split (org subaccount + platform fee)
+
+Creates a payment link. Customer pays; org receives (amount - 7% - $0.50) to their subaccount; platform fee (7% + $0.50, minus processing fee) stays on main account or goes to configured platform subaccounts. Requires payment processing enabled for org.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+org_id = 'org_id_example' # String | 
+initialize_payment_request = Mudbase::InitializePaymentRequest.new({amount: 3.56, customer: Mudbase::InitializePaymentRequestCustomer.new({email: 'email_example'})}) # InitializePaymentRequest | 
+
+begin
+  # Initialize fiat payment with split (org subaccount + platform fee)
+  result = api_instance.initialize_payment(org_id, initialize_payment_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->initialize_payment: #{e}"
+end
+```
+
+#### Using the initialize_payment_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<InitializePayment200Response>, Integer, Hash)> initialize_payment_with_http_info(org_id, initialize_payment_request)
+
+```ruby
+begin
+  # Initialize fiat payment with split (org subaccount + platform fee)
+  data, status_code, headers = api_instance.initialize_payment_with_http_info(org_id, initialize_payment_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <InitializePayment200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->initialize_payment_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **org_id** | **String** |  |  |
+| **initialize_payment_request** | [**InitializePaymentRequest**](InitializePaymentRequest.md) |  |  |
+
+### Return type
+
+[**InitializePayment200Response**](InitializePayment200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## initialize_payment_for_project
+
+> initialize_payment_for_project(project_id, initialize_payment_for_project_request)
+
+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 payment-processing subaccount.
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+initialize_payment_for_project_request = Mudbase::InitializePaymentForProjectRequest.new({amount: 3.56, customer: Mudbase::InitializePaymentRequestCustomer.new({email: 'email_example'})}) # InitializePaymentForProjectRequest | 
+
+begin
+  # Initialize fiat payment (project-scoped)
+  api_instance.initialize_payment_for_project(project_id, initialize_payment_for_project_request)
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->initialize_payment_for_project: #{e}"
+end
+```
+
+#### Using the initialize_payment_for_project_with_http_info variant
+
+This returns an Array which contains the response data (`nil` in this case), status code and headers.
+
+> <Array(nil, Integer, Hash)> initialize_payment_for_project_with_http_info(project_id, initialize_payment_for_project_request)
+
+```ruby
+begin
+  # Initialize fiat payment (project-scoped)
+  data, status_code, headers = api_instance.initialize_payment_for_project_with_http_info(project_id, initialize_payment_for_project_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => nil
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->initialize_payment_for_project_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+| **initialize_payment_for_project_request** | [**InitializePaymentForProjectRequest**](InitializePaymentForProjectRequest.md) |  |  |
+
+### Return type
+
+nil (empty response body)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## record_usage
+
+> <MessageResponse> record_usage(project_id, record_usage_request)
+
+Record usage (public)
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+record_usage_request = Mudbase::RecordUsageRequest.new({email: 'email_example', metric: 'metric_example', quantity: 3.56}) # RecordUsageRequest | 
+
+begin
+  # Record usage (public)
+  result = api_instance.record_usage(project_id, record_usage_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->record_usage: #{e}"
+end
+```
+
+#### Using the record_usage_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<MessageResponse>, Integer, Hash)> record_usage_with_http_info(project_id, record_usage_request)
+
+```ruby
+begin
+  # Record usage (public)
+  data, status_code, headers = api_instance.record_usage_with_http_info(project_id, record_usage_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <MessageResponse>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->record_usage_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+| **record_usage_request** | [**RecordUsageRequest**](RecordUsageRequest.md) |  |  |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## update_plan
+
+> <CreatePlan201Response> update_plan(project_id, plan_id, update_plan_request)
+
+Update billing plan
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+# setup authorization
+Mudbase.configure do |config|
+  # Configure Bearer authorization (JWT): OrgBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+
+  # Configure Bearer authorization (JWT): ProjectBearerAuth
+  config.access_token = 'YOUR_BEARER_TOKEN'
+end
+
+api_instance = Mudbase::BillingApi.new
+project_id = 'project_id_example' # String | 
+plan_id = 'plan_id_example' # String | 
+update_plan_request = Mudbase::UpdatePlanRequest.new # UpdatePlanRequest | 
+
+begin
+  # Update billing plan
+  result = api_instance.update_plan(project_id, plan_id, update_plan_request)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->update_plan: #{e}"
+end
+```
+
+#### Using the update_plan_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<CreatePlan201Response>, Integer, Hash)> update_plan_with_http_info(project_id, plan_id, update_plan_request)
+
+```ruby
+begin
+  # Update billing plan
+  data, status_code, headers = api_instance.update_plan_with_http_info(project_id, plan_id, update_plan_request)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <CreatePlan201Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->update_plan_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **project_id** | **String** |  |  |
+| **plan_id** | **String** |  |  |
+| **update_plan_request** | [**UpdatePlanRequest**](UpdatePlanRequest.md) |  |  |
+
+### Return type
+
+[**CreatePlan201Response**](CreatePlan201Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: application/json
+- **Accept**: application/json
+
+
+## verify_org_plan_payment
+
+> <VerifyOrgPlanPayment200Response> verify_org_plan_payment(opts)
+
+Verify org-level plan payment
+
+**Org plan payment flow — Step 3.** Call after the user completes payment (redirect or webhook). Pass tx_ref (or reference) from the payment redirect. Updates org plan and billing; idempotent. No auth required (redirect callback can call this). 
+
+### Examples
+
+```ruby
+require 'time'
+require 'mudbase'
+
+api_instance = Mudbase::BillingApi.new
+opts = {
+  tx_ref: 'tx_ref_example', # String | Payment reference (mudbase_org_...) from checkout redirect
+  reference: 'reference_example' # String | Alias for tx_ref
+}
+
+begin
+  # Verify org-level plan payment
+  result = api_instance.verify_org_plan_payment(opts)
+  p result
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->verify_org_plan_payment: #{e}"
+end
+```
+
+#### Using the verify_org_plan_payment_with_http_info variant
+
+This returns an Array which contains the response data, status code and headers.
+
+> <Array(<VerifyOrgPlanPayment200Response>, Integer, Hash)> verify_org_plan_payment_with_http_info(opts)
+
+```ruby
+begin
+  # Verify org-level plan payment
+  data, status_code, headers = api_instance.verify_org_plan_payment_with_http_info(opts)
+  p status_code # => 2xx
+  p headers # => { ... }
+  p data # => <VerifyOrgPlanPayment200Response>
+rescue Mudbase::ApiError => e
+  puts "Error when calling BillingApi->verify_org_plan_payment_with_http_info: #{e}"
+end
+```
+
+### Parameters
+
+| Name | Type | Description | Notes |
+| ---- | ---- | ----------- | ----- |
+| **tx_ref** | **String** | Payment reference (mudbase_org_...) from checkout redirect | [optional] |
+| **reference** | **String** | Alias for tx_ref | [optional] |
+
+### Return type
+
+[**VerifyOrgPlanPayment200Response**](VerifyOrgPlanPayment200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
 - **Accept**: application/json
 
 
-## billing_verify_payment
+## verify_payment
 
-> <BillingVerifyPayment200Response> billing_verify_payment(project_id, reference)
+> <VerifyPayment200Response> verify_payment(project_id, reference)
 
 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. 
+**Customer subscription flow — Step 3.** Call after the user completes payment. Pass **reference** as query (?reference=mudbase_...). On success, a subscription is created. No auth required when using the platform gateway (mudbase_ refs). Org-level gateway verification may require JWT. References starting with pmt_ are rejected (crypto billing is not enabled on this API). 
 
 ### Examples
 
@@ -625,33 +1986,33 @@ require 'time'
 require 'mudbase'
 
 api_instance = Mudbase::BillingApi.new
-project_id = 'project_id_example' # String | Project ID (MongoDB ObjectId) for the billing project.
-reference = 'reference_example' # String | Payment reference (e.g. mudbase_abc123 or pmt_abc123)
+project_id = 'project_id_example' # String | 
+reference = 'reference_example' # String | Payment transaction reference (mudbase_...)
 
 begin
   # Verify payment and create subscription
-  result = api_instance.billing_verify_payment(project_id, reference)
+  result = api_instance.verify_payment(project_id, reference)
   p result
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_verify_payment: #{e}"
+  puts "Error when calling BillingApi->verify_payment: #{e}"
 end
 ```
 
-#### Using the billing_verify_payment_with_http_info variant
+#### Using the verify_payment_with_http_info variant
 
 This returns an Array which contains the response data, status code and headers.
 
-> <Array(<BillingVerifyPayment200Response>, Integer, Hash)> billing_verify_payment_with_http_info(project_id, reference)
+> <Array(<VerifyPayment200Response>, Integer, Hash)> verify_payment_with_http_info(project_id, reference)
 
 ```ruby
 begin
   # Verify payment and create subscription
-  data, status_code, headers = api_instance.billing_verify_payment_with_http_info(project_id, reference)
+  data, status_code, headers = api_instance.verify_payment_with_http_info(project_id, reference)
   p status_code # => 2xx
   p headers # => { ... }
-  p data # => <BillingVerifyPayment200Response>
+  p data # => <VerifyPayment200Response>
 rescue Mudbase::ApiError => e
-  puts "Error when calling BillingApi->billing_verify_payment_with_http_info: #{e}"
+  puts "Error when calling BillingApi->verify_payment_with_http_info: #{e}"
 end
 ```
 
@@ -659,12 +2020,12 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **project_id** | **String** | Project ID (MongoDB ObjectId) for the billing project. |  |
-| **reference** | **String** | Payment reference (e.g. mudbase_abc123 or pmt_abc123) |  |
+| **project_id** | **String** |  |  |
+| **reference** | **String** | Payment transaction reference (mudbase_...) |  |
 
 ### Return type
 
-[**BillingVerifyPayment200Response**](BillingVerifyPayment200Response.md)
+[**VerifyPayment200Response**](VerifyPayment200Response.md)
 
 ### Authorization