feat(payments): add payments module with embedded checkout

packages/sdk/README.md

@@ -29,6 +29,7 @@ The SDK provides access to Base44's functionality through the following modules:
 - **[`entities`](https://docs.base44.com/developers/references/sdk/docs/interfaces/entities)**: Work with your app's data entities using CRUD operations.
 - **[`functions`](https://docs.base44.com/developers/references/sdk/docs/interfaces/functions)**: Execute backend functions.
 - **[`integrations`](https://docs.base44.com/developers/references/sdk/docs/type-aliases/integrations)**: Access pre-built and third-party integrations.
+- **[`payments`](https://docs.base44.com/developers/references/sdk/docs/interfaces/payments)**: Embed checkouts, look up purchases, and handle refunds and subscriptions with the service role.
 
 ## Quickstarts
 

packages/sdk/scripts/mintlify-post-processing/appended-articles.json

@@ -30,5 +30,10 @@
     "interfaces/ActorClient",
     "interfaces/ActorRegistry",
     "interfaces/ActorNameRegistry"
+  ],
+  "interfaces/PaymentsModule": [
+    "type-aliases/PaymentsErrorCode",
+    "type-aliases/PurchaseStatus",
+    "type-aliases/PaymentsRecurringFrequency"
   ]
 }

packages/sdk/scripts/mintlify-post-processing/types-to-expose.json

@@ -46,6 +46,11 @@
   "FunctionsModule",
   "ImportResult",
   "IntegrationsModule",
+  "PaymentsErrorCode",
+  "PaymentsModule",
+  "PaymentsRecurringFrequency",
+  "PurchaseStatus",
+  "ServiceRolePaymentsModule",
   "SortField",
   "SsoModule",
   "UpdateManyResult"

packages/sdk/src/client.ts

@@ -23,6 +23,10 @@ import type {
   CreateClientOptions,
 } from "./client.types.js";
 import { createAnalyticsModule } from "./modules/analytics.js";
+import {
+  createPaymentsModule,
+  createServiceRolePaymentsModule,
+} from "./modules/payments.js";
 import {
   createActorsModule,
   resolveActorsHost,
@@ -263,6 +267,7 @@ export function createClient(config: CreateClientConfig): Base44Client {
     appLogs: createAppLogsModule(axiosClient, appId),
     app: createAppModule(axiosClient, appId),
     users: createUsersModule(axiosClient, appId),
+    payments: createPaymentsModule(axiosClient, appId),
     analytics: createAnalyticsModule({
       axiosClient,
       serverUrl,
@@ -314,6 +319,7 @@ export function createClient(config: CreateClientConfig): Base44Client {
       headers: aiGatewayHeaders,
     }),
     appLogs: createAppLogsModule(serviceRoleAxiosClient, appId),
+    payments: createServiceRolePaymentsModule(serviceRoleAxiosClient, appId),
     cleanup: () => {
       if (socket) {
         socket.disconnect();

packages/sdk/src/client.types.ts

@@ -2,6 +2,10 @@ import type { EntitiesModule } from "./modules/entities.types.js";
 import type { IntegrationsModule } from "./modules/integrations.types.js";
 import type { AuthModule } from "./modules/auth.types.js";
 import type { SsoModule } from "./modules/sso.types.js";
+import type {
+  PaymentsModule,
+  ServiceRolePaymentsModule,
+} from "./modules/payments.types.js";
 import type {
   ConnectorsModule,
   UserConnectorsModule,
@@ -145,6 +149,8 @@ export interface Base44Client {
   functions: FunctionsModule;
   /** {@link IntegrationsModule | Integrations module} for calling pre-built integration endpoints. */
   integrations: IntegrationsModule;
+  /** {@link PaymentsModule | Payments module} for checkouts and purchases. */
+  payments: PaymentsModule;
   /** Cleanup function to disconnect WebSocket connections. Call when you're done with the client. */
   cleanup: () => void;
 
@@ -241,6 +247,8 @@ export interface Base44Client {
     functions: FunctionsModule;
     /** {@link IntegrationsModule | Integrations module} with elevated permissions. */
     integrations: IntegrationsModule;
+    /** {@link ServiceRolePaymentsModule | Payments module} for creating checkouts, refunds, and subscription changes. */
+    payments: ServiceRolePaymentsModule;
     /** {@link SsoModule | SSO module} for generating SSO tokens. */
     sso: SsoModule;
     /** Cleanup function to disconnect WebSocket connections. */

packages/sdk/src/index.ts

@@ -136,6 +136,38 @@ export type {
 
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 
+export type {
+  PaymentsModule,
+  ServiceRolePaymentsModule,
+  PaymentsErrorCode,
+  PaymentsRecurringFrequency,
+  CheckoutBuyer,
+  CheckoutFreeTrial,
+  CheckoutItem,
+  CheckoutItemRecurring,
+  CheckoutPresentation,
+  CheckoutElement,
+  CheckoutMount,
+  MountableCheckout,
+  CreateCheckoutParams,
+  CreateCheckoutResult,
+  CompleteCheckoutResult,
+  EmbeddedCheckout,
+  PayPalEmbeddedCheckout,
+  StripeEmbeddedCheckout,
+  MountCheckoutOptions,
+  ListPurchasesParams,
+  ServiceRoleListPurchasesParams,
+  ListPurchasesResult,
+  Purchase,
+  PurchaseItem,
+  PurchaseStatus,
+  RefundParams,
+  RefundResult,
+  CancelSubscriptionOptions,
+  SubscriptionResult,
+} from "./modules/payments.types.js";
+
 export { Actor, type Conn } from "./actor.js";
 
 export type {