mudbase-sdk 1.2.12 → 1.3.7

package/docs/BillingApi.md

@@ -4,26 +4,120 @@ All URIs are relative to *https://cloud.mudbase.dev*
 
 | Method | HTTP request | Description |
 |------------- | ------------- | -------------|
-| [**billingCheckFeatureAccess**](BillingApi.md#billingcheckfeatureaccess) | **GET** /api/billing/public/projects/{projectId}/feature-access | Check feature access (public) |
-| [**billingCheckSubscription**](BillingApi.md#billingchecksubscription) | **GET** /api/billing/public/projects/{projectId}/subscription | Check subscription status (public) |
-| [**billingCreateCheckoutSession**](BillingApi.md#billingcreatecheckoutsessionoperation) | **POST** /api/billing/public/projects/{projectId}/checkout | Create checkout session (Flutterwave or crypto) |
-| [**billingGetCheckoutPayment**](BillingApi.md#billinggetcheckoutpayment) | **GET** /api/billing/public/projects/{projectId}/checkout/{paymentId} | Get checkout payment details |
-| [**billingGetPublicPlans**](BillingApi.md#billinggetpublicplans) | **GET** /api/billing/public/projects/{projectId}/plans | Get public plans (no auth required) |
-| [**billingHandleCryptoWebhook**](BillingApi.md#billinghandlecryptowebhookoperation) | **POST** /api/billing/webhooks/crypto | Crypto payment processor webhook |
-| [**billingHandleFlutterwaveWebhook**](BillingApi.md#billinghandleflutterwavewebhookoperation) | **POST** /api/billing/webhooks/flutterwave | Flutterwave webhook |
-| [**billingInitializePayment**](BillingApi.md#billinginitializepaymentoperation) | **POST** /api/projects/{projectId}/payment-processing/initialize-payment | Initialize fiat payment (app-scoped) |
-| [**billingRecordUsage**](BillingApi.md#billingrecordusageoperation) | **POST** /api/billing/public/projects/{projectId}/usage | Record usage (public) |
-| [**billingVerifyPayment**](BillingApi.md#billingverifypayment) | **POST** /api/billing/public/projects/{projectId}/verify-payment | Verify payment and create subscription |
+| [**cancelSubscription**](BillingApi.md#cancelsubscriptionoperation) | **POST** /api/billing/subscriptions/{subscriptionId}/cancel | Cancel subscription |
+| [**checkFeatureAccess**](BillingApi.md#checkfeatureaccess) | **GET** /api/billing/public/projects/{projectId}/feature-access | Check feature access (public) |
+| [**checkSubscription**](BillingApi.md#checksubscription) | **GET** /api/billing/public/projects/{projectId}/subscription | Check subscription status (public) |
+| [**createCheckoutSession**](BillingApi.md#createcheckoutsessionoperation) | **POST** /api/billing/public/projects/{projectId}/checkout | Create checkout session (fiat) |
+| [**createPlan**](BillingApi.md#createplanoperation) | **POST** /api/billing/projects/{projectId}/plans | Create billing plan |
+| [**deletePlan**](BillingApi.md#deleteplan) | **DELETE** /api/billing/projects/{projectId}/plans/{planId} | Delete billing plan |
+| [**downloadInvoice**](BillingApi.md#downloadinvoice) | **GET** /api/billing/projects/{projectId}/invoices/{invoiceId}/download | Download invoice PDF |
+| [**enablePaymentProcessing**](BillingApi.md#enablepaymentprocessingoperation) | **POST** /api/orgs/{orgId}/payment-processing/enable | Enable payment processing for organization |
+| [**exportInvoice**](BillingApi.md#exportinvoice) | **GET** /api/billing/projects/{projectId}/invoices/{invoiceId}/export | Export invoice (e.g. PDF URL or file) |
+| [**getBillingEstimate**](BillingApi.md#getbillingestimate) | **GET** /api/billing/estimate | Get billing estimate and forecast |
+| [**getCheckoutPayment**](BillingApi.md#getcheckoutpayment) | **GET** /api/billing/public/projects/{projectId}/checkout/{paymentId} | Get checkout payment details (not used for fiat billing) |
+| [**getDashboard**](BillingApi.md#getdashboard) | **GET** /api/billing/projects/{projectId}/dashboard | Get billing dashboard data |
+| [**getFeeBreakdown**](BillingApi.md#getfeebreakdown) | **GET** /api/orgs/{orgId}/payment-processing/fee-breakdown | Get fee breakdown for a given amount |
+| [**getInvoice**](BillingApi.md#getinvoice) | **GET** /api/billing/projects/{projectId}/invoices/{invoiceId} | Get single invoice |
+| [**getInvoices**](BillingApi.md#getinvoices) | **GET** /api/billing/projects/{projectId}/invoices | List project invoices |
+| [**getPaymentRecords**](BillingApi.md#getpaymentrecords) | **GET** /api/orgs/{orgId}/payment-processing/records | List fiat payment records for organization |
+| [**getPlans**](BillingApi.md#getplans) | **GET** /api/billing/projects/{projectId}/plans | Get billing plans |
+| [**getPublicPlans**](BillingApi.md#getpublicplans) | **GET** /api/billing/public/projects/{projectId}/plans | Get public plans (no auth required) |
+| [**getSubscriptionTierById**](BillingApi.md#getsubscriptiontierbyid) | **GET** /api/billing/plans/{planId} | Get one subscription tier by id |
+| [**getSubscriptionTiers**](BillingApi.md#getsubscriptiontiers) | **GET** /api/billing/plans | Get subscription tiers (org-level BaaS plans) |
+| [**getSubscriptions**](BillingApi.md#getsubscriptions) | **GET** /api/billing/projects/{projectId}/subscriptions | Get subscriptions |
+| [**handleFlutterwaveWebhook**](BillingApi.md#handleflutterwavewebhookoperation) | **POST** /api/billing/webhooks/flutterwave | Payment gateway webhook |
+| [**initializeOrgPlanCheckout**](BillingApi.md#initializeorgplancheckoutoperation) | **POST** /api/billing/org/checkout | Initialize org-level BaaS plan payment (Starter, Growth, Scale) |
+| [**initializePayment**](BillingApi.md#initializepaymentoperation) | **POST** /api/orgs/{orgId}/payment-processing/initialize-payment | Initialize fiat payment with split (org subaccount + platform fee) |
+| [**initializePaymentForProject**](BillingApi.md#initializepaymentforprojectoperation) | **POST** /api/projects/{projectId}/payment-processing/initialize-payment | Initialize fiat payment (project-scoped) |
+| [**recordUsage**](BillingApi.md#recordusageoperation) | **POST** /api/billing/public/projects/{projectId}/usage | Record usage (public) |
+| [**updatePlan**](BillingApi.md#updateplanoperation) | **PATCH** /api/billing/projects/{projectId}/plans/{planId} | Update billing plan |
+| [**verifyOrgPlanPayment**](BillingApi.md#verifyorgplanpayment) | **POST** /api/billing/org/verify-payment | Verify org-level plan payment |
+| [**verifyPayment**](BillingApi.md#verifypayment) | **POST** /api/billing/public/projects/{projectId}/verify-payment | Verify payment and create subscription |
+
+
+
+## cancelSubscription
+
+> DeleteRole200Response cancelSubscription(subscriptionId, cancelSubscriptionRequest)
+
+Cancel subscription
 
+### Example
 
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { CancelSubscriptionOperationRequest } from 'mudbase-sdk';
 
-## billingCheckFeatureAccess
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
 
-> BillingCheckFeatureAccess200Response billingCheckFeatureAccess(projectId, email, feature)
+  const body = {
+    // string
+    subscriptionId: subscriptionId_example,
+    // CancelSubscriptionRequest (optional)
+    cancelSubscriptionRequest: {"cancelImmediately":false},
+  } satisfies CancelSubscriptionOperationRequest;
 
-Check feature access (public)
+  try {
+    const data = await api.cancelSubscription(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **subscriptionId** | `string` |  | [Defaults to `undefined`] |
+| **cancelSubscriptionRequest** | [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`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Subscription cancelled |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## checkFeatureAccess
+
+> CheckFeatureAccess200Response checkFeatureAccess(projectId, email, feature)
 
-Check whether a customer has access to a feature (by plan or entitlement). Public; no auth required.
+Check feature access (public)
 
 ### Example
 
@@ -32,23 +126,23 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingCheckFeatureAccessRequest } from 'mudbase-sdk';
+import type { CheckFeatureAccessRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const api = new BillingApi();
 
   const body = {
-    // string | Project ID (MongoDB ObjectId) for the billing project.
+    // string
     projectId: projectId_example,
     // string | Customer email
     email: email_example,
     // string | Feature slug to check access for
     feature: feature_example,
-  } satisfies BillingCheckFeatureAccessRequest;
+  } satisfies CheckFeatureAccessRequest;
 
   try {
-    const data = await api.billingCheckFeatureAccess(body);
+    const data = await api.checkFeatureAccess(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -64,13 +158,13 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
 | **email** | `string` | Customer email | [Defaults to `undefined`] |
 | **feature** | `string` | Feature slug to check access for | [Defaults to `undefined`] |
 
 ### Return type
 
-[**BillingCheckFeatureAccess200Response**](BillingCheckFeatureAccess200Response.md)
+[**CheckFeatureAccess200Response**](CheckFeatureAccess200Response.md)
 
 ### Authorization
 
@@ -86,20 +180,16 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Feature access status |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingCheckSubscription
+## checkSubscription
 
-> BillingCheckSubscription200Response billingCheckSubscription(projectId, email)
+> CheckSubscription200Response checkSubscription(projectId, email)
 
 Check subscription status (public)
 
-Check whether a customer (by email) has an active subscription for the project. Public; no auth required.
-
 ### Example
 
 ```ts
@@ -107,21 +197,21 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingCheckSubscriptionRequest } from 'mudbase-sdk';
+import type { CheckSubscriptionRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const api = new BillingApi();
 
   const body = {
-    // string | Project ID (MongoDB ObjectId) for the billing project.
+    // string
     projectId: projectId_example,
     // string | Customer email to check subscription for
     email: email_example,
-  } satisfies BillingCheckSubscriptionRequest;
+  } satisfies CheckSubscriptionRequest;
 
   try {
-    const data = await api.billingCheckSubscription(body);
+    const data = await api.checkSubscription(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -137,12 +227,12 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
 | **email** | `string` | Customer email to check subscription for | [Defaults to `undefined`] |
 
 ### Return type
 
-[**BillingCheckSubscription200Response**](BillingCheckSubscription200Response.md)
+[**CheckSubscription200Response**](CheckSubscription200Response.md)
 
 ### Authorization
 
@@ -158,19 +248,17 @@ No authorization required
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
 | **200** | Subscription status |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingCreateCheckoutSession
+## createCheckoutSession
 
-> BillingCreateCheckoutSession200Response billingCreateCheckoutSession(projectId, billingCreateCheckoutSessionRequest)
+> CreateCheckoutSession200Response createCheckoutSession(projectId, createCheckoutSessionRequest)
 
-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). 
 
 ### Example
 
@@ -179,21 +267,21 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingCreateCheckoutSessionOperationRequest } from 'mudbase-sdk';
+import type { CreateCheckoutSessionOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const api = new BillingApi();
 
   const body = {
-    // string | Project ID (MongoDB ObjectId) for the billing project.
+    // string | Project ID
     projectId: projectId_example,
-    // BillingCreateCheckoutSessionRequest | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs.
-    billingCreateCheckoutSessionRequest: {"planId":"65a1b2c3d4e5f6789012345d","billingCycle":"monthly","customerInfo":{"email":"customer@example.com","name":"John Doe"},"successUrl":"https://app.example.com/success","cancelUrl":"https://app.example.com/cancel"},
-  } satisfies BillingCreateCheckoutSessionOperationRequest;
+    // CreateCheckoutSessionRequest
+    createCheckoutSessionRequest: {"planId":"65a1b2c3d4e5f6789012345d","billingCycle":"monthly","customerInfo":{"email":"customer@example.com","name":"John Doe"},"successUrl":"https://app.example.com/success","cancelUrl":"https://app.example.com/cancel"},
+  } satisfies CreateCheckoutSessionOperationRequest;
 
   try {
-    const data = await api.billingCreateCheckoutSession(body);
+    const data = await api.createCheckoutSession(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -209,12 +297,12 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
-| **billingCreateCheckoutSessionRequest** | [BillingCreateCheckoutSessionRequest](BillingCreateCheckoutSessionRequest.md) | Plan to subscribe to, billing cycle, customer email/name, and optional success/cancel redirect URLs. | |
+| **projectId** | `string` | Project ID | [Defaults to `undefined`] |
+| **createCheckoutSessionRequest** | [CreateCheckoutSessionRequest](CreateCheckoutSessionRequest.md) |  | |
 
 ### Return type
 
-[**BillingCreateCheckoutSession200Response**](BillingCreateCheckoutSession200Response.md)
+[**CreateCheckoutSession200Response**](CreateCheckoutSession200Response.md)
 
 ### Authorization
 
@@ -231,20 +319,92 @@ No authorization required
 |-------------|-------------|------------------|
 | **200** | Checkout session created |  -  |
 | **400** | Missing planId, billingCycle, or customerInfo.email |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+| **500** | Internal server error |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingGetCheckoutPayment
+## createPlan
+
+> CreatePlan201Response createPlan(projectId, createPlanRequest)
+
+Create billing plan
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { CreatePlanOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    projectId: projectId_example,
+    // CreatePlanRequest
+    createPlanRequest: {"name":"Pro Plan","description":"Professional plan with advanced features","price":29.99,"currency":"USD","interval":"month","features":["Unlimited API calls","Priority support","Advanced analytics"]},
+  } satisfies CreatePlanOperationRequest;
+
+  try {
+    const data = await api.createPlan(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **createPlanRequest** | [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`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **201** | Plan created |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
-> BillingGetCheckoutPayment200Response billingGetCheckoutPayment(projectId, paymentId)
 
-Get checkout payment details
+## deletePlan
 
-Returns payment intent/checkout status (for refresh or deep link). No auth required.
+> MessageResponse deletePlan(projectId, planId)
+
+Delete billing plan
 
 ### Example
 
@@ -253,21 +413,27 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingGetCheckoutPaymentRequest } from 'mudbase-sdk';
+import type { DeletePlanRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
-  const api = new BillingApi();
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
 
   const body = {
-    // string | Project ID (MongoDB ObjectId) for the billing project.
+    // string
     projectId: projectId_example,
-    // string | Payment ID or reference from checkout session
-    paymentId: paymentId_example,
-  } satisfies BillingGetCheckoutPaymentRequest;
+    // string
+    planId: planId_example,
+  } satisfies DeletePlanRequest;
 
   try {
-    const data = await api.billingGetCheckoutPayment(body);
+    const data = await api.deletePlan(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -283,16 +449,16 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
-| **paymentId** | `string` | Payment ID or reference from checkout session | [Defaults to `undefined`] |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **planId** | `string` |  | [Defaults to `undefined`] |
 
 ### Return type
 
-[**BillingGetCheckoutPayment200Response**](BillingGetCheckoutPayment200Response.md)
+[**MessageResponse**](MessageResponse.md)
 
 ### Authorization
 
-No authorization required
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
 
 ### HTTP request headers
 
@@ -303,22 +469,18 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Payment details |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **404** | Payment not found (exact backend message for payment admin endpoints). |  -  |
-| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+| **200** | Plan deleted |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingGetPublicPlans
+## downloadInvoice
 
-> BillingGetPublicPlans200Response billingGetPublicPlans(projectId)
+> Blob downloadInvoice(projectId, invoiceId)
 
-Get public plans (no auth required)
-
-Returns subscription plans available for the project. Public; no authentication required. Use for pricing pages and checkout flow.
+Download invoice PDF
 
 ### Example
 
@@ -327,19 +489,27 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingGetPublicPlansRequest } from 'mudbase-sdk';
+import type { DownloadInvoiceRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
-  const api = new BillingApi();
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
 
   const body = {
-    // string | Project ID (MongoDB ObjectId) to list plans for.
+    // string
     projectId: projectId_example,
-  } satisfies BillingGetPublicPlansRequest;
+    // string
+    invoiceId: invoiceId_example,
+  } satisfies DownloadInvoiceRequest;
 
   try {
-    const data = await api.billingGetPublicPlans(body);
+    const data = await api.downloadInvoice(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -355,39 +525,41 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID (MongoDB ObjectId) to list plans for. | [Defaults to `undefined`] |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **invoiceId** | `string` |  | [Defaults to `undefined`] |
 
 ### Return type
 
-[**BillingGetPublicPlans200Response**](BillingGetPublicPlans200Response.md)
+**Blob**
 
 ### 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`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Public plans list |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **200** | Invoice PDF file or redirect URL |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Invoice not found |  -  |
+| **500** | Internal server error |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingHandleCryptoWebhook
+## enablePaymentProcessing
 
-> BillingHandleCryptoWebhook200Response billingHandleCryptoWebhook(billingHandleCryptoWebhookRequest)
+> EnablePaymentProcessing200Response enablePaymentProcessing(orgId, enablePaymentProcessingRequest)
 
-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.
 
 ### Example
 
@@ -396,19 +568,25 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingHandleCryptoWebhookOperationRequest } from 'mudbase-sdk';
+import type { EnablePaymentProcessingOperationRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
-  const api = new BillingApi();
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
 
   const body = {
-    // BillingHandleCryptoWebhookRequest | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata).
-    billingHandleCryptoWebhookRequest: {"event":"payment.completed","data":{"paymentId":"pmt_abc123xyz789","reference":"pmt_abc123xyz789","amount":29.99,"currency":"USD","network":"polygon","status":"completed","metadata":{"isPlatformBilling":true,"planId":"65a1b2c3d4e5f6789012345d","billingCycle":"monthly","customerEmail":"customer@example.com"}}},
-  } satisfies BillingHandleCryptoWebhookOperationRequest;
+    // string
+    orgId: orgId_example,
+    // EnablePaymentProcessingRequest
+    enablePaymentProcessingRequest: {"accountBank":"044","accountNumber":"0123456789","country":"US","businessName":"Acme Inc","businessMobile":"+1234567890"},
+  } satisfies EnablePaymentProcessingOperationRequest;
 
   try {
-    const data = await api.billingHandleCryptoWebhook(body);
+    const data = await api.enablePaymentProcessing(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -424,15 +602,16 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **billingHandleCryptoWebhookRequest** | [BillingHandleCryptoWebhookRequest](BillingHandleCryptoWebhookRequest.md) | Crypto payment webhook payload (event type and data with paymentId, reference, amount, currency, network, status, metadata). | |
+| **orgId** | `string` |  | [Defaults to `undefined`] |
+| **enablePaymentProcessingRequest** | [EnablePaymentProcessingRequest](EnablePaymentProcessingRequest.md) |  | |
 
 ### Return type
 
-[**BillingHandleCryptoWebhook200Response**](BillingHandleCryptoWebhook200Response.md)
+[**EnablePaymentProcessing200Response**](EnablePaymentProcessing200Response.md)
 
 ### Authorization
 
-No authorization required
+[OrgBearerAuth](../README.md#OrgBearerAuth)
 
 ### HTTP request headers
 
@@ -443,22 +622,20 @@ No authorization required
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Webhook processed |  -  |
-| **400** | Event type is required or invalid payload |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+| **200** | Payment processing enabled (or already enabled) |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **403** | Access denied |  -  |
+| **500** | Internal server error |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingHandleFlutterwaveWebhook
-
-> BillingHandleCryptoWebhook200Response billingHandleFlutterwaveWebhook(billingHandleFlutterwaveWebhookRequest)
+## exportInvoice
 
-Flutterwave webhook
+> DownloadInvoice200Response exportInvoice(projectId, invoiceId)
 
-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)
 
 ### Example
 
@@ -467,19 +644,27 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingHandleFlutterwaveWebhookOperationRequest } from 'mudbase-sdk';
+import type { ExportInvoiceRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
-  const api = new BillingApi();
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
 
   const body = {
-    // BillingHandleFlutterwaveWebhookRequest | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing).
-    billingHandleFlutterwaveWebhookRequest: {"event":"charge.completed","data":{"id":123456789,"tx_ref":"mudbase_fiat_org123_project456_1234567890_abc","amount":100,"currency":"USD","status":"successful","customer":{"email":"customer@example.com","name":"John Doe"},"meta":{"orgId":"65a1b2c3d4e5f6789012345a","projectId":"65a1b2c3d4e5f6789012345b","isPaymentProcessing":true}}},
-  } satisfies BillingHandleFlutterwaveWebhookOperationRequest;
+    // string
+    projectId: projectId_example,
+    // string
+    invoiceId: invoiceId_example,
+  } satisfies ExportInvoiceRequest;
 
   try {
-    const data = await api.billingHandleFlutterwaveWebhook(body);
+    const data = await api.exportInvoice(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -495,41 +680,41 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **billingHandleFlutterwaveWebhookRequest** | [BillingHandleFlutterwaveWebhookRequest](BillingHandleFlutterwaveWebhookRequest.md) | Flutterwave webhook payload (event and data with id, tx_ref, amount, currency, status, customer, meta for subscription or payment-processing). | |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **invoiceId** | `string` |  | [Defaults to `undefined`] |
 
 ### 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`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Webhook received |  -  |
-| **400** | Invalid or missing event |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
-| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+| **200** | Export result (URL or file) |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Invoice not found |  -  |
+| **500** | Internal server error |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingInitializePayment
+## getBillingEstimate
 
-> billingInitializePayment(projectId, billingInitializePaymentRequest)
+> GetBillingEstimate200Response getBillingEstimate()
 
-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. 
 
 ### Example
 
@@ -538,25 +723,86 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingInitializePaymentOperationRequest } from 'mudbase-sdk';
+import type { GetBillingEstimateRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const config = new Configuration({ 
-    // Configure HTTP bearer authorization: BearerToken
+    // Configure HTTP bearer authorization: OrgBearerAuth
     accessToken: "YOUR BEARER TOKEN",
   });
   const api = new BillingApi(config);
 
+  try {
+    const data = await api.getBillingEstimate();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### 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`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Billing estimate and forecast |  -  |
+| **401** | Authentication required |  -  |
+| **503** | Service temporarily unavailable. Returned when the organization is restricted (e.g. suspended due to unpaid overage, spend limit exceeded, or API usage limit reached). End-users see a generic message; the real reason is logged server-side only.  |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getCheckoutPayment
+
+> getCheckoutPayment(projectId, paymentId)
+
+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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetCheckoutPaymentRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new BillingApi();
+
   const body = {
-    // string | Project ID for payment scope and tx_ref.
+    // string
     projectId: projectId_example,
-    // BillingInitializePaymentRequest | Payment amount, currency, customer (email, name), and optional metadata.
-    billingInitializePaymentRequest: ...,
-  } satisfies BillingInitializePaymentOperationRequest;
+    // string | Opaque id from checkout (fiat billing does not expose pollable payment state here)
+    paymentId: paymentId_example,
+  } satisfies GetCheckoutPaymentRequest;
 
   try {
-    const data = await api.billingInitializePayment(body);
+    const data = await api.getCheckoutPayment(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -572,8 +818,8 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID for payment scope and tx_ref. | [Defaults to `undefined`] |
-| **billingInitializePaymentRequest** | [BillingInitializePaymentRequest](BillingInitializePaymentRequest.md) | Payment amount, currency, customer (email, name), and optional metadata. | |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **paymentId** | `string` | Opaque id from checkout (fiat billing does not expose pollable payment state here) | [Defaults to `undefined`] |
 
 ### Return type
 
@@ -581,32 +827,28 @@ example().catch(console.error);
 
 ### Authorization
 
-[BearerToken](../README.md#BearerToken)
+No authorization required
 
 ### HTTP request headers
 
-- **Content-Type**: `application/json`
+- **Content-Type**: Not defined
 - **Accept**: `application/json`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Payment link and fee breakdown (same shape as org-level) |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+| **404** | Payment not found |  -  |
+| **500** | Internal server error |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingRecordUsage
+## getDashboard
 
-> MessageResponse billingRecordUsage(projectId, billingRecordUsageRequest)
+> GetDashboard200Response getDashboard(projectId)
 
-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.
+Get billing dashboard data
 
 ### Example
 
@@ -615,21 +857,25 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingRecordUsageOperationRequest } from 'mudbase-sdk';
+import type { GetDashboardRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
-  const api = new BillingApi();
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
 
   const body = {
-    // string | Project ID (MongoDB ObjectId) for the billing project.
+    // string
     projectId: projectId_example,
-    // BillingRecordUsageRequest | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record.
-    billingRecordUsageRequest: {"email":"customer@example.com","metric":"api_calls","quantity":150},
-  } satisfies BillingRecordUsageOperationRequest;
+  } satisfies GetDashboardRequest;
 
   try {
-    const data = await api.billingRecordUsage(body);
+    const data = await api.getDashboard(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -645,41 +891,1205 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
-| **billingRecordUsageRequest** | [BillingRecordUsageRequest](BillingRecordUsageRequest.md) | Customer email, metric name (e.g. api_calls, storage_mb), and quantity to record. | |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
 
 ### Return type
 
-[**MessageResponse**](MessageResponse.md)
+[**GetDashboard200Response**](GetDashboard200Response.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`
 
 
 ### HTTP response details
 | Status code | Description | Response headers |
 |-------------|-------------|------------------|
-| **200** | Usage recorded |  -  |
-| **400** | Bad request or validation error. The **error** field contains the exact backend message, e.g. \"Validation failed\", \"projectId is required\", \"No file provided\", \"Invalid project ID format\". **details** may contain validation errors when present.  |  -  |
-| **401** | Not authenticated. The **error** field contains the exact backend message, e.g. \"Invalid token.\", \"Access denied. No token provided.\", \"Authentication required\", \"Invalid API key\", \"API key expired\".  |  -  |
-| **403** | Access denied. The **error** field contains the exact backend message, e.g. \"Access denied\", \"Insufficient permissions\", \"You don\'t have permission to view this organization\'s projects\", \"Account suspended\".  |  -  |
+| **200** | Dashboard data |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Project not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getFeeBreakdown
+
+> GetFeeBreakdown200Response getFeeBreakdown(orgId, amount, currency)
+
+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).
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetFeeBreakdownRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    orgId: orgId_example,
+    // number
+    amount: 8.14,
+    // string (optional)
+    currency: currency_example,
+  } satisfies GetFeeBreakdownRequest;
+
+  try {
+    const data = await api.getFeeBreakdown(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **orgId** | `string` |  | [Defaults to `undefined`] |
+| **amount** | `number` |  | [Defaults to `undefined`] |
+| **currency** | `string` |  | [Optional] [Defaults to `'USD'`] |
+
+### Return type
+
+[**GetFeeBreakdown200Response**](GetFeeBreakdown200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Fee breakdown |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getInvoice
+
+> GetInvoice200Response getInvoice(projectId, invoiceId)
+
+Get single invoice
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetInvoiceRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    projectId: projectId_example,
+    // string
+    invoiceId: invoiceId_example,
+  } satisfies GetInvoiceRequest;
+
+  try {
+    const data = await api.getInvoice(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **invoiceId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetInvoice200Response**](GetInvoice200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Invoice details |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Invoice not found |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getInvoices
+
+> GetInvoices200Response getInvoices(projectId)
+
+List project invoices
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetInvoicesRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    projectId: projectId_example,
+  } satisfies GetInvoicesRequest;
+
+  try {
+    const data = await api.getInvoices(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetInvoices200Response**](GetInvoices200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Invoices list |  -  |
+| **401** | Authentication required |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getPaymentRecords
+
+> GetPaymentRecords200Response getPaymentRecords(orgId, page, limit, status)
+
+List fiat payment records for organization
+
+Paginated list of FiatPaymentRecord for this org (txRef, amount, orgReceives, status, paidAt).
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetPaymentRecordsRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    orgId: orgId_example,
+    // number (optional)
+    page: 56,
+    // number (optional)
+    limit: 56,
+    // 'pending' | 'successful' | 'failed' (optional)
+    status: status_example,
+  } satisfies GetPaymentRecordsRequest;
+
+  try {
+    const data = await api.getPaymentRecords(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **orgId** | `string` |  | [Defaults to `undefined`] |
+| **page** | `number` |  | [Optional] [Defaults to `1`] |
+| **limit** | `number` |  | [Optional] [Defaults to `20`] |
+| **status** | `pending`, `successful`, `failed` |  | [Optional] [Defaults to `undefined`] [Enum: pending, successful, failed] |
+
+### Return type
+
+[**GetPaymentRecords200Response**](GetPaymentRecords200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Records and pagination |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getPlans
+
+> GetPlans200Response getPlans(projectId)
+
+Get billing plans
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetPlansRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    projectId: projectId_example,
+  } satisfies GetPlansRequest;
+
+  try {
+    const data = await api.getPlans(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetPlans200Response**](GetPlans200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Plans list |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getPublicPlans
+
+> GetPublicPlans200Response getPublicPlans(projectId)
+
+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). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetPublicPlansRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new BillingApi();
+
+  const body = {
+    // string
+    projectId: projectId_example,
+  } satisfies GetPublicPlansRequest;
+
+  try {
+    const data = await api.getPublicPlans(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetPublicPlans200Response**](GetPublicPlans200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Public plans list |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getSubscriptionTierById
+
+> GetSubscriptionTierById200Response getSubscriptionTierById(planId)
+
+Get one subscription tier by id
+
+Returns a single org-level BaaS plan (free, starter, growth, scale, enterprise). Public; no auth required.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetSubscriptionTierByIdRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new BillingApi();
+
+  const body = {
+    // string | Plan id (free, starter, growth, scale, enterprise)
+    planId: planId_example,
+  } satisfies GetSubscriptionTierByIdRequest;
+
+  try {
+    const data = await api.getSubscriptionTierById(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **planId** | `string` | Plan id (free, starter, growth, scale, enterprise) | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetSubscriptionTierById200Response**](GetSubscriptionTierById200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Plan details |  -  |
+| **404** | Plan not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getSubscriptionTiers
+
+> GetSubscriptionTiers200Response getSubscriptionTiers()
+
+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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetSubscriptionTiersRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new BillingApi();
+
+  try {
+    const data = await api.getSubscriptionTiers();
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### 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`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Plan list |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## getSubscriptions
+
+> GetSubscriptions200Response getSubscriptions(projectId)
+
+Get subscriptions
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { GetSubscriptionsRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    projectId: projectId_example,
+  } satisfies GetSubscriptionsRequest;
+
+  try {
+    const data = await api.getSubscriptions(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+
+### Return type
+
+[**GetSubscriptions200Response**](GetSubscriptions200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Subscriptions list |  -  |
+| **401** | Authentication required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## handleFlutterwaveWebhook
+
+> HandleFlutterwaveWebhook200Response handleFlutterwaveWebhook(handleFlutterwaveWebhookRequest)
+
+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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { HandleFlutterwaveWebhookOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new BillingApi();
+
+  const body = {
+    // HandleFlutterwaveWebhookRequest
+    handleFlutterwaveWebhookRequest: {"event":"charge.completed","data":{"id":123456789,"tx_ref":"mudbase_fiat_org123_project456_1234567890_abc","amount":100,"currency":"USD","status":"successful","customer":{"email":"customer@example.com","name":"John Doe"},"meta":{"orgId":"65a1b2c3d4e5f6789012345a","projectId":"65a1b2c3d4e5f6789012345b","isPaymentProcessing":true}}},
+  } satisfies HandleFlutterwaveWebhookOperationRequest;
+
+  try {
+    const data = await api.handleFlutterwaveWebhook(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **handleFlutterwaveWebhookRequest** | [HandleFlutterwaveWebhookRequest](HandleFlutterwaveWebhookRequest.md) |  | |
+
+### Return type
+
+[**HandleFlutterwaveWebhook200Response**](HandleFlutterwaveWebhook200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Webhook received |  -  |
+| **400** | Invalid or missing event |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## initializeOrgPlanCheckout
+
+> InitializeOrgPlanCheckout200Response initializeOrgPlanCheckout(initializeOrgPlanCheckoutRequest)
+
+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. 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { InitializeOrgPlanCheckoutOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // InitializeOrgPlanCheckoutRequest
+    initializeOrgPlanCheckoutRequest: {"planName":"starter","billingCycle":"monthly"},
+  } satisfies InitializeOrgPlanCheckoutOperationRequest;
+
+  try {
+    const data = await api.initializeOrgPlanCheckout(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **initializeOrgPlanCheckoutRequest** | [InitializeOrgPlanCheckoutRequest](InitializeOrgPlanCheckoutRequest.md) |  | |
+
+### Return type
+
+[**InitializeOrgPlanCheckout200Response**](InitializeOrgPlanCheckout200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Payment link created |  -  |
+| **400** | Invalid planName or payment gateway not configured |  -  |
+| **401** | Organization context required |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## initializePayment
+
+> InitializePayment200Response initializePayment(orgId, initializePaymentRequest)
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { InitializePaymentOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    orgId: orgId_example,
+    // InitializePaymentRequest
+    initializePaymentRequest: {"amount":100,"currency":"USD","customer":{"email":"buyer@example.com","name":"Buyer Name"},"metadata":{"title":"Order #123","description":"Payment for order"}},
+  } satisfies InitializePaymentOperationRequest;
+
+  try {
+    const data = await api.initializePayment(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **orgId** | `string` |  | [Defaults to `undefined`] |
+| **initializePaymentRequest** | [InitializePaymentRequest](InitializePaymentRequest.md) |  | |
+
+### Return type
+
+[**InitializePayment200Response**](InitializePayment200Response.md)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Payment link and fee breakdown |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## initializePaymentForProject
+
+> initializePaymentForProject(projectId, initializePaymentForProjectRequest)
+
+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.
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { InitializePaymentForProjectOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    projectId: projectId_example,
+    // InitializePaymentForProjectRequest
+    initializePaymentForProjectRequest: {"amount":0.01,"customer":{"email":"email_example"}},
+  } satisfies InitializePaymentForProjectOperationRequest;
+
+  try {
+    const data = await api.initializePaymentForProject(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **initializePaymentForProjectRequest** | [InitializePaymentForProjectRequest](InitializePaymentForProjectRequest.md) |  | |
+
+### Return type
+
+`void` (Empty response body)
+
+### Authorization
+
+[OrgBearerAuth](../README.md#OrgBearerAuth), [ProjectBearerAuth](../README.md#ProjectBearerAuth)
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Payment link and fee breakdown (same shape as org-level) |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **500** | Internal server error |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## recordUsage
+
+> MessageResponse recordUsage(projectId, recordUsageRequest)
+
+Record usage (public)
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { RecordUsageOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new BillingApi();
+
+  const body = {
+    // string
+    projectId: projectId_example,
+    // RecordUsageRequest
+    recordUsageRequest: {"email":"customer@example.com","metric":"api_calls","quantity":150},
+  } satisfies RecordUsageOperationRequest;
+
+  try {
+    const data = await api.recordUsage(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **recordUsageRequest** | [RecordUsageRequest](RecordUsageRequest.md) |  | |
+
+### Return type
+
+[**MessageResponse**](MessageResponse.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: `application/json`
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Usage recorded |  -  |
+| **400** | Bad request |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## updatePlan
+
+> CreatePlan201Response updatePlan(projectId, planId, updatePlanRequest)
+
+Update billing plan
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { UpdatePlanOperationRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const config = new Configuration({ 
+    // Configure HTTP bearer authorization: OrgBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+    // Configure HTTP bearer authorization: ProjectBearerAuth
+    accessToken: "YOUR BEARER TOKEN",
+  });
+  const api = new BillingApi(config);
+
+  const body = {
+    // string
+    projectId: projectId_example,
+    // string
+    planId: planId_example,
+    // UpdatePlanRequest
+    updatePlanRequest: {"name":"Pro Plan Updated","description":"Updated professional plan","price":39.99,"features":["Unlimited API calls","Priority support","Advanced analytics"]},
+  } satisfies UpdatePlanOperationRequest;
+
+  try {
+    const data = await api.updatePlan(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **planId** | `string` |  | [Defaults to `undefined`] |
+| **updatePlanRequest** | [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`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Plan updated |  -  |
+| **400** | Bad request |  -  |
+| **401** | Authentication required |  -  |
+| **404** | Resource not found |  -  |
+
+[[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
+
+
+## verifyOrgPlanPayment
+
+> VerifyOrgPlanPayment200Response verifyOrgPlanPayment(txRef, reference)
+
+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). 
+
+### Example
+
+```ts
+import {
+  Configuration,
+  BillingApi,
+} from 'mudbase-sdk';
+import type { VerifyOrgPlanPaymentRequest } from 'mudbase-sdk';
+
+async function example() {
+  console.log("🚀 Testing mudbase-sdk SDK...");
+  const api = new BillingApi();
+
+  const body = {
+    // string | Payment reference (mudbase_org_...) from checkout redirect (optional)
+    txRef: txRef_example,
+    // string | Alias for tx_ref (optional)
+    reference: reference_example,
+  } satisfies VerifyOrgPlanPaymentRequest;
+
+  try {
+    const data = await api.verifyOrgPlanPayment(body);
+    console.log(data);
+  } catch (error) {
+    console.error(error);
+  }
+}
+
+// Run the test
+example().catch(console.error);
+```
+
+### Parameters
+
+
+| Name | Type | Description  | Notes |
+|------------- | ------------- | ------------- | -------------|
+| **txRef** | `string` | Payment reference (mudbase_org_...) from checkout redirect | [Optional] [Defaults to `undefined`] |
+| **reference** | `string` | Alias for tx_ref | [Optional] [Defaults to `undefined`] |
+
+### Return type
+
+[**VerifyOrgPlanPayment200Response**](VerifyOrgPlanPayment200Response.md)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: `application/json`
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+| **200** | Payment verified and org plan updated |  -  |
+| **400** | tx_ref required, invalid reference, or payment verification failed |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)
 
 
-## billingVerifyPayment
+## verifyPayment
 
-> BillingVerifyPayment200Response billingVerifyPayment(projectId, reference)
+> VerifyPayment200Response verifyPayment(projectId, 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). 
 
 ### Example
 
@@ -688,21 +2098,21 @@ import {
   Configuration,
   BillingApi,
 } from 'mudbase-sdk';
-import type { BillingVerifyPaymentRequest } from 'mudbase-sdk';
+import type { VerifyPaymentRequest } from 'mudbase-sdk';
 
 async function example() {
   console.log("🚀 Testing mudbase-sdk SDK...");
   const api = new BillingApi();
 
   const body = {
-    // string | Project ID (MongoDB ObjectId) for the billing project.
+    // string
     projectId: projectId_example,
-    // string | Payment reference (e.g. mudbase_abc123 or pmt_abc123)
+    // string | Payment transaction reference (mudbase_...)
     reference: reference_example,
-  } satisfies BillingVerifyPaymentRequest;
+  } satisfies VerifyPaymentRequest;
 
   try {
-    const data = await api.billingVerifyPayment(body);
+    const data = await api.verifyPayment(body);
     console.log(data);
   } catch (error) {
     console.error(error);
@@ -718,12 +2128,12 @@ example().catch(console.error);
 
 | Name | Type | Description  | Notes |
 |------------- | ------------- | ------------- | -------------|
-| **projectId** | `string` | Project ID (MongoDB ObjectId) for the billing project. | [Defaults to `undefined`] |
-| **reference** | `string` | Payment reference (e.g. mudbase_abc123 or pmt_abc123) | [Defaults to `undefined`] |
+| **projectId** | `string` |  | [Defaults to `undefined`] |
+| **reference** | `string` | Payment transaction reference (mudbase_...) | [Defaults to `undefined`] |
 
 ### Return type
 
-[**BillingVerifyPayment200Response**](BillingVerifyPayment200Response.md)
+[**VerifyPayment200Response**](VerifyPayment200Response.md)
 
 ### Authorization
 
@@ -741,7 +2151,7 @@ No authorization required
 | **200** | Payment verified and subscription created |  -  |
 | **400** | reference is required or organization context missing |  -  |
 | **403** | Payment does not belong to your organization |  -  |
-| **500** | Server error. The **error** field contains the exact backend message, e.g. \"Authentication failed\", \"Failed to upload file\", \"Failed to fetch project\".  |  -  |
+| **500** | Internal server error |  -  |
 
 [[Back to top]](#) [[Back to API list]](../README.md#api-endpoints) [[Back to Model list]](../README.md#models) [[Back to README]](../README.md)