@zendfi/sdk 0.6.0 → 0.7.0

package/README.md

@@ -26,11 +26,11 @@ console.log(payment.payment_url); // Send customer here
 
 | Feature | Stripe | PayPal | **ZendFi** |
 |---------|--------|--------|------------|
-| **Fees** | 2.9% + $0.30 | 3.5% + $0.49 | **0.6% flat** ✨ |
-| **Settlement** | 7 days | 3-5 days | **Instant** ✨ |
-| **Crypto Native** | Via 3rd party | Via 3rd party | **Built-in** ✨ |
-| **AI Agent Ready** | ❌ | ❌ | **✅ Native** ✨ |
-| **Setup Time** | 30 min | 30 min | **5 min** ✨ |
+| **Fees** | 2.9% + $0.30 | 3.5% + $0.49 | **0.6% flat** |
+| **Settlement** | 7 days | 3-5 days | **Instant** |
+| **Crypto Native** | Via 3rd party | Via 3rd party | **Built-in** |
+| **AI Agent Ready** | ACP  | NO | **Native** |
+| **Setup Time** | 30 min | 30 min | **5 min** |
 
 **Save 81% on fees.** Get paid instantly. Scale to AI when ready.
 
@@ -39,6 +39,7 @@ console.log(payment.payment_url); // Send customer here
 ## Features
 
 ### **Core Payments** (Start Here)
+- **Embedded Checkout** — Drop-in checkout component for your website/app
 - **Simple Payments** — QR codes, payment links, instant settlements
 - **Payment Links** — Reusable checkout pages for social/email
 - **Webhooks** — Real-time notifications with auto-verification
@@ -125,6 +126,66 @@ console.log(payment.payment_url);
 
 ---
 
+## Embedded Checkout
+
+Skip redirects entirely—embed the checkout directly into your website or app. Perfect for seamless user experiences.
+
+### Quick Example
+
+```typescript
+import { ZendFiEmbeddedCheckout } from '@zendfi/sdk';
+
+const checkout = new ZendFiEmbeddedCheckout({
+  linkCode: 'your-payment-link-code',
+  containerId: 'checkout-container',
+  mode: 'test',
+  
+  onSuccess: (payment) => {
+    console.log('Payment successful!', payment.transactionSignature);
+    // Redirect to success page or show confirmation
+  },
+  
+  onError: (error) => {
+    console.error('Payment failed:', error.message);
+  },
+});
+
+// Mount the checkout
+await checkout.mount();
+```
+
+### HTML Setup
+
+```html
+<div id="checkout-container"></div>
+<script type="module">
+  import { ZendFiEmbeddedCheckout } from '@zendfi/sdk';
+  // ... (setup code above)
+</script>
+```
+
+### Features
+
+- **Drop-in Integration** — Works with React, Vue, Next.js, or vanilla JS
+- **QR Code Generation** — Automatic mobile wallet support
+- **Wallet Connect** — Phantom, Solflare, Backpack support
+- **Real-time Updates** — Live payment confirmation polling
+- **Gasless Transactions** — Optional backend-signed payments
+- **Customizable Theme** — Match your brand colors & styles
+- **TypeScript First** — Full type safety and autocomplete
+
+### Complete Documentation
+
+For comprehensive guides, React examples, theming, and advanced usage:
+
+- **Quick Start:** [`EMBEDDED_CHECKOUT_QUICKSTART.md`](./EMBEDDED_CHECKOUT_QUICKSTART.md)
+- **Full Guide:** [`EMBEDDED_CHECKOUT.md`](./EMBEDDED_CHECKOUT.md)
+- **Implementation Details:** [`EMBEDDED_CHECKOUT_IMPLEMENTATION.md`](./EMBEDDED_CHECKOUT_IMPLEMENTATION.md)
+- **React Example:** [`examples/embedded-checkout-react.tsx`](./examples/embedded-checkout-react.tsx)
+- **Vanilla JS Example:** [`examples/embedded-checkout-vanilla.html`](./examples/embedded-checkout-vanilla.html)
+
+---
+
 ## API Key Modes
 
 ZendFi uses **smart API keys** that automatically route to the correct network:
@@ -172,7 +233,7 @@ This covers:
 
 ---
 
-## 🤖 AI-Ready Features (Optional Advanced)
+## AI-Ready Features (Optional Advanced)
 
 Building AI agents? ZendFi has native support for autonomous payments with cryptographic security and spending limits.
 
@@ -231,7 +292,10 @@ const payment = await zendfi.agent.pay({
 ### Namespaced APIs
 
 ```typescript
-import { zendfi } from '@zendfi/sdk';
+import { zendfi, ZendFiEmbeddedCheckout } from '@zendfi/sdk';
+
+// Embedded Checkout (New!)
+const checkout = new ZendFiEmbeddedCheckout({...});
 
 // Traditional Payments (Most Common)
 zendfi.createPayment(...)
@@ -814,7 +878,7 @@ await zendfi.cancelInstallmentPlan(plan.id);
 
 ---
 
-### 🧾 Invoices
+### Invoices
 
 Professional invoices with crypto payment options.
 
@@ -1202,6 +1266,45 @@ console.log('Status:', updated.status); // "Confirmed"
 
 ## Examples
 
+### Embedded Checkout Integration
+
+```typescript
+import { ZendFiEmbeddedCheckout } from '@zendfi/sdk';
+
+// React Component
+function CheckoutPage({ linkCode }) {
+  const containerRef = useRef(null);
+  
+  useEffect(() => {
+    const checkout = new ZendFiEmbeddedCheckout({
+      linkCode,
+      containerId: 'checkout-container',
+      mode: 'test',
+      
+      onSuccess: (payment) => {
+        // Payment successful - redirect or show confirmation
+        router.push(`/success?payment=${payment.paymentId}`);
+      },
+      
+      onError: (error) => {
+        // Handle errors
+        setError(error.message);
+      },
+      
+      theme: {
+        primaryColor: '#8b5cf6',
+        borderRadius: '16px',
+      },
+    });
+    
+    checkout.mount();
+    return () => checkout.unmount();
+  }, [linkCode]);
+  
+  return <div id="checkout-container" ref={containerRef} />;
+}
+```
+
 ### E-commerce Checkout
 
 ```typescript

package/dist/express.d.mts

@@ -1,4 +1,4 @@
-import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-DGBeCWT-.mjs';
+import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-D5INiR-l.mjs';
 
 /**
  * Express Webhook Handler

package/dist/express.d.ts

@@ -1,4 +1,4 @@
-import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-DGBeCWT-.js';
+import { W as WebhookHandlerConfig, a as WebhookHandlers } from './webhook-handler-D5INiR-l.js';
 
 /**
  * Express Webhook Handler

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { C as CreateAgentApiKeyRequest, A as AgentApiKey, b as CreateAgentSessionRequest, c as AgentSession, d as AgentPaymentRequest, e as AgentPaymentResponse, f as AgentAnalytics, g as CreatePaymentIntentRequest, P as PaymentIntent, h as ConfirmPaymentIntentRequest, i as PaymentIntentEvent, j as PPPFactor, k as PricingSuggestionRequest, l as PricingSuggestion, E as EnableAutonomyRequest, m as EnableAutonomyResponse, n as AutonomyStatus, S as SmartPaymentRequest, o as SmartPaymentResponse, p as CreateSessionKeyRequest, q as CreateSessionKeyResponse, r as CreateDeviceBoundSessionKeyRequest$1, s as CreateDeviceBoundSessionKeyResponse$1, t as SubmitSignedTransactionRequest, u as SubmitTransactionResponse, v as SessionKeyStatus, w as SessionKeyListResponse, T as TopUpSessionKeyRequest, x as TopUpSessionKeyResponse, Z as ZendFiConfig, y as CreatePaymentRequest, z as Payment, L as ListPaymentsRequest, B as PaginatedResponse, D as CreateSubscriptionPlanRequest, F as SubscriptionPlan, G as CreateSubscriptionRequest, H as Subscription, I as CreatePaymentLinkRequest, J as PaymentLink, K as CreateInstallmentPlanRequest, M as InstallmentPlan, N as CreateEscrowRequest, O as Escrow, Q as ApproveEscrowRequest, R as RefundEscrowRequest, U as DisputeEscrowRequest, V as CreateInvoiceRequest, X as Invoice, Y as VerifyWebhookRequest, _ as WebhookPayload } from './webhook-handler-DGBeCWT-.mjs';
-export { a5 as AgentKeyId, ao as ApiKeyMode, aD as ApiKeyScope, aJ as AutonomousDelegate, a2 as Brand, aG as CaptureMethod, aA as CreateInstallmentPlanResponse, ap as Currency, an as Environment, a9 as EscrowId, au as EscrowStatus, aa as InstallmentPlanId, at as InstallmentPlanStatus, az as InstallmentScheduleItem, ac as IntentId, a7 as InvoiceId, aC as InvoiceLineItem, av as InvoiceStatus, aO as LinkedSessionInfo, a6 as MerchantId, aI as PPPConfig, a3 as PaymentId, aF as PaymentIntentStatus, ab as PaymentLinkCode, ar as PaymentStatus, aq as PaymentToken, aB as ReleaseCondition, aK as RevokeAutonomyRequest, aP as SecurityStatus, a4 as SessionId, aM as SessionKeyInstructions, aN as SessionKeySecurityInfo, aQ as SessionKeyStats, aE as SessionLimits, aL as SmartPaymentStatus, ay as SplitRecipient, aw as SplitStatus, a8 as SubscriptionId, as as SubscriptionStatus, aH as UserProfile, ax as WebhookEvent, a1 as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, a0 as WebhookResult, af as asAgentKeyId, aj as asEscrowId, ak as asInstallmentPlanId, am as asIntentId, ah as asInvoiceId, ag as asMerchantId, ad as asPaymentId, al as asPaymentLinkCode, ae as asSessionId, ai as asSubscriptionId, $ as processWebhook } from './webhook-handler-DGBeCWT-.mjs';
+import { C as CreateAgentApiKeyRequest, A as AgentApiKey, b as CreateAgentSessionRequest, c as AgentSession, d as AgentPaymentRequest, e as AgentPaymentResponse, f as AgentAnalytics, g as CreatePaymentIntentRequest, P as PaymentIntent, h as ConfirmPaymentIntentRequest, i as PaymentIntentEvent, j as PPPFactor, k as PricingSuggestionRequest, l as PricingSuggestion, E as EnableAutonomyRequest, m as EnableAutonomyResponse, n as AutonomyStatus, S as SmartPaymentRequest, o as SmartPaymentResponse, p as CreateSessionKeyRequest, q as CreateSessionKeyResponse, r as CreateDeviceBoundSessionKeyRequest$1, s as CreateDeviceBoundSessionKeyResponse$1, t as SubmitSignedTransactionRequest, u as SubmitTransactionResponse, v as SessionKeyStatus, w as SessionKeyListResponse, T as TopUpSessionKeyRequest, x as TopUpSessionKeyResponse, Z as ZendFiConfig, y as CreatePaymentRequest, z as Payment, L as ListPaymentsRequest, B as PaginatedResponse, D as CreateSubscriptionPlanRequest, F as SubscriptionPlan, G as CreateSubscriptionRequest, H as Subscription, I as CreatePaymentLinkRequest, J as PaymentLink, K as CreateInstallmentPlanRequest, M as InstallmentPlan, N as CreateEscrowRequest, O as Escrow, Q as ApproveEscrowRequest, R as RefundEscrowRequest, U as DisputeEscrowRequest, V as CreateInvoiceRequest, X as Invoice, Y as VerifyWebhookRequest, _ as WebhookPayload, $ as ApiKeyMode } from './webhook-handler-D5INiR-l.mjs';
+export { a6 as AgentKeyId, aD as ApiKeyScope, aJ as AutonomousDelegate, a3 as Brand, aG as CaptureMethod, aA as CreateInstallmentPlanResponse, ap as Currency, ao as Environment, aa as EscrowId, au as EscrowStatus, ab as InstallmentPlanId, at as InstallmentPlanStatus, az as InstallmentScheduleItem, ad as IntentId, a8 as InvoiceId, aC as InvoiceLineItem, av as InvoiceStatus, aO as LinkedSessionInfo, a7 as MerchantId, aI as PPPConfig, a4 as PaymentId, aF as PaymentIntentStatus, ac as PaymentLinkCode, ar as PaymentStatus, aq as PaymentToken, aB as ReleaseCondition, aK as RevokeAutonomyRequest, aP as SecurityStatus, a5 as SessionId, aM as SessionKeyInstructions, aN as SessionKeySecurityInfo, aQ as SessionKeyStats, aE as SessionLimits, aL as SmartPaymentStatus, ay as SplitRecipient, aw as SplitStatus, a9 as SubscriptionId, as as SubscriptionStatus, aH as UserProfile, ax as WebhookEvent, a2 as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, a1 as WebhookResult, ag as asAgentKeyId, ak as asEscrowId, al as asInstallmentPlanId, an as asIntentId, ai as asInvoiceId, ah as asMerchantId, ae as asPaymentId, am as asPaymentLinkCode, af as asSessionId, aj as asSubscriptionId, a0 as processWebhook } from './webhook-handler-D5INiR-l.mjs';
 import { Transaction, Keypair } from '@solana/web3.js';
 
 /**
@@ -1753,6 +1753,211 @@ declare function verifyExpressWebhook(request: any, secret?: string): Promise<We
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
+/**
+ * ZendFi Embedded Checkout
+ *
+ * Embed the ZendFi checkout directly into your website/app
+ * without redirecting to checkout.zendfi.tech
+ *
+ * @example
+ * ```typescript
+ * import { ZendFiEmbeddedCheckout } from '@zendfi/sdk';
+ *
+ * const checkout = new ZendFiEmbeddedCheckout({
+ *   linkCode: 'abc123xyz',
+ *   containerId: 'zendfi-checkout',
+ *   mode: 'live',
+ *   onSuccess: (payment) => {
+ *     console.log('Payment successful!', payment);
+ *   },
+ *   onError: (error) => {
+ *     console.error('Payment failed:', error);
+ *   }
+ * });
+ *
+ * checkout.mount();
+ * ```
+ */
+
+interface EmbeddedCheckoutConfig {
+    /** Payment link code or payment ID */
+    linkCode?: string;
+    paymentId?: string;
+    /** Container element ID where checkout will be mounted */
+    containerId: string;
+    /** API mode - 'test' for devnet, 'live' for mainnet */
+    mode?: ApiKeyMode;
+    /** API base URL (defaults to production) */
+    apiUrl?: string;
+    /** Callback when payment is successful */
+    onSuccess?: (payment: PaymentSuccessData) => void;
+    /** Callback when payment fails */
+    onError?: (error: CheckoutError) => void;
+    /** Callback when checkout is loaded */
+    onLoad?: () => void;
+    /** Custom theme overrides */
+    theme?: CheckoutTheme;
+    /** Enable custom amount (Pay What You Want) */
+    allowCustomAmount?: boolean;
+    /** Show/hide specific payment methods */
+    paymentMethods?: {
+        walletConnect?: boolean;
+        qrCode?: boolean;
+        solanaWallet?: boolean;
+    };
+}
+interface CheckoutTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    borderRadius?: string;
+    fontFamily?: string;
+    textColor?: string;
+    buttonStyle?: 'solid' | 'outlined' | 'minimal';
+}
+interface PaymentSuccessData {
+    paymentId: string;
+    transactionSignature: string;
+    amount: number;
+    token: string;
+    merchantName: string;
+}
+interface CheckoutError {
+    code: string;
+    message: string;
+    details?: any;
+}
+/**
+ * ZendFi Embedded Checkout Component
+ *
+ * Provides a fully-functional checkout experience that can be
+ * embedded directly into any web application.
+ */
+declare class ZendFiEmbeddedCheckout {
+    private config;
+    private container;
+    private checkoutData;
+    private pollInterval;
+    private mounted;
+    constructor(config: EmbeddedCheckoutConfig);
+    private getDefaultApiUrl;
+    /**
+     * Mount the checkout to the DOM
+     */
+    mount(): Promise<void>;
+    /**
+     * Unmount and cleanup
+     */
+    unmount(): void;
+    /**
+     * Fetch checkout data from API
+     */
+    private fetchCheckoutData;
+    /**
+     * Poll for payment confirmation
+     */
+    private startPaymentPolling;
+    /**
+     * Handle successful payment
+     */
+    private handlePaymentSuccess;
+    /**
+     * Handle payment failure
+     */
+    private handlePaymentFailure;
+    /**
+     * Handle payment expiration
+     */
+    private handlePaymentExpired;
+    /**
+     * Render loading state
+     */
+    private renderLoading;
+    /**
+     * Render the main checkout UI
+     */
+    private render;
+    /**
+     * Render header section
+     */
+    private renderHeader;
+    /**
+     * Render payment information
+     */
+    private renderPaymentInfo;
+    /**
+     * Render custom amount input (Pay What You Want)
+     */
+    private renderCustomAmountInput;
+    /**
+     * Render payment methods
+     */
+    private renderPaymentMethods;
+    /**
+     * Render QR code payment method
+     */
+    private renderQRCodeMethod;
+    /**
+     * Render browser wallet method
+     */
+    private renderWalletMethod;
+    /**
+     * Render WalletConnect method
+     */
+    private renderWalletConnectMethod;
+    /**
+     * Render footer
+     */
+    private renderFooter;
+    /**
+     * Render success state
+     */
+    private renderSuccess;
+    /**
+     * Render error state
+     */
+    private renderError;
+    /**
+     * Attach event listeners to interactive elements
+     */
+    private attachEventListeners;
+    /**
+     * Handle wallet connection and payment
+     */
+    private handleWalletConnect;
+    /**
+     * Handle mobile wallet connection via Solana Pay deep link
+     */
+    private handleWalletConnectScan;
+    /**
+     * Generate QR code on canvas using QRious library
+     */
+    private generateQRCode;
+    /**
+     * Inject custom styles
+     */
+    private injectStyles;
+    /**
+     * Load external dependencies (QR code library, Solana web3.js)
+     */
+    private loadDependencies;
+    /**
+     * Load external script
+     */
+    private loadScript;
+    /**
+     * Get computed theme with defaults
+     */
+    private getComputedTheme;
+    /**
+     * Style helpers
+     */
+    private getCheckoutContainerStyles;
+    private getLoadingStyles;
+    private getSpinnerStyles;
+    private getSuccessStyles;
+    private getErrorStyles;
+}
+
 /**
  * ZendFi SDK Error Classes
  *
@@ -3419,4 +3624,4 @@ declare class PerformanceMonitor {
     clear(): void;
 }
 
-export { AgentAPI, AgentAnalytics, AgentApiKey, AgentPaymentRequest, AgentPaymentResponse, AgentSession, AnthropicAdapter, ApiError, ApproveEscrowRequest, AuthenticationError, AutonomyAPI, AutonomyStatus, type CachedKeypair, ConfigLoader, ConfirmPaymentIntentRequest, type ConnectedWallet, CreateAgentApiKeyRequest, CreateAgentSessionRequest, type CreateAndFundConfig, type CreateDeviceBoundSessionKeyRequest, type CreateDeviceBoundSessionKeyResponse, CreateEscrowRequest, CreateInstallmentPlanRequest, CreateInvoiceRequest, CreatePaymentIntentRequest, CreatePaymentLinkRequest, CreatePaymentRequest, CreateSessionKeyRequest, CreateSessionKeyResponse, CreateSubscriptionPlanRequest, CreateSubscriptionRequest, type CustomStorageAdapter, DevTools, DeviceBoundSessionKey, type DeviceBoundSessionKeyOptions, DeviceFingerprintGenerator, DisputeEscrowRequest, ERROR_CODES, EnableAutonomyRequest, EnableAutonomyResponse, type EncryptedSessionKey, type ErrorInterceptor, ErrorRecovery, Escrow, GeminiAdapter, InstallmentPlan, InterceptorManager, type Interceptors, Invoice, type LifecycleConfig, ListPaymentsRequest, LitCryptoSigner, type LitCryptoSignerConfig, type LitNetwork, type MockWallet, NetworkError, OpenAIAdapter, PINRateLimiter, type PINValidationResult, PINValidator, PPPFactor, PaginatedResponse, type ParsedIntent, Payment, PaymentError, PaymentIntent, PaymentIntentEvent, PaymentIntentParser, PaymentIntentsAPI, PaymentLink, type PaymentResult, PerformanceMonitor, type PollingOptions, PricingAPI, PricingSuggestion, PricingSuggestionRequest, QuickCaches, RateLimitError, RateLimiter, type RecoveryQR, RecoveryQRGenerator, RefundEscrowRequest, type RequestConfig, type RequestInterceptor, type ResponseData, type ResponseInterceptor, type RetryOptions, RetryStrategy, SPENDING_LIMIT_ACTION_CID, SecureStorage, SessionKeyCache, type SessionKeyCacheConfig, SessionKeyCrypto, SessionKeyLifecycle, SessionKeyListResponse, type SessionKeyPaymentRequest, SessionKeyStatus, SessionKeysAPI, type SignPaymentParams, type SignPaymentResult, SmartPaymentRequest, SmartPaymentResponse, SmartPaymentsAPI, SubmitSignedTransactionRequest, SubmitTransactionResponse, Subscription, SubscriptionPlan, type TestSessionKey, TopUpSessionKeyRequest, TopUpSessionKeyResponse, TransactionMonitor, TransactionPoller, type TransactionStatus, ValidationError, VerifyWebhookRequest, WalletConnector, WebhookError, WebhookPayload, ZendFiClient, ZendFiConfig, ZendFiError, type ZendFiErrorData, type ZendFiErrorType, ZendFiSessionKeyManager, createWalletHook, createZendFiError, decodeSignatureFromLit, encodeTransactionForLit, generateIdempotencyKey, isZendFiError, requiresLitSigning, setupQuickSessionKey, sleep, verifyExpressWebhook, verifyNextWebhook, verifyWebhookSignature, zendfi };
+export { AgentAPI, AgentAnalytics, AgentApiKey, AgentPaymentRequest, AgentPaymentResponse, AgentSession, AnthropicAdapter, ApiError, ApiKeyMode, ApproveEscrowRequest, AuthenticationError, AutonomyAPI, AutonomyStatus, type CachedKeypair, type CheckoutError, type CheckoutTheme, ConfigLoader, ConfirmPaymentIntentRequest, type ConnectedWallet, CreateAgentApiKeyRequest, CreateAgentSessionRequest, type CreateAndFundConfig, type CreateDeviceBoundSessionKeyRequest, type CreateDeviceBoundSessionKeyResponse, CreateEscrowRequest, CreateInstallmentPlanRequest, CreateInvoiceRequest, CreatePaymentIntentRequest, CreatePaymentLinkRequest, CreatePaymentRequest, CreateSessionKeyRequest, CreateSessionKeyResponse, CreateSubscriptionPlanRequest, CreateSubscriptionRequest, type CustomStorageAdapter, DevTools, DeviceBoundSessionKey, type DeviceBoundSessionKeyOptions, DeviceFingerprintGenerator, DisputeEscrowRequest, ERROR_CODES, type EmbeddedCheckoutConfig, EnableAutonomyRequest, EnableAutonomyResponse, type EncryptedSessionKey, type ErrorInterceptor, ErrorRecovery, Escrow, GeminiAdapter, InstallmentPlan, InterceptorManager, type Interceptors, Invoice, type LifecycleConfig, ListPaymentsRequest, LitCryptoSigner, type LitCryptoSignerConfig, type LitNetwork, type MockWallet, NetworkError, OpenAIAdapter, PINRateLimiter, type PINValidationResult, PINValidator, PPPFactor, PaginatedResponse, type ParsedIntent, Payment, PaymentError, PaymentIntent, PaymentIntentEvent, PaymentIntentParser, PaymentIntentsAPI, PaymentLink, type PaymentResult, type PaymentSuccessData, PerformanceMonitor, type PollingOptions, PricingAPI, PricingSuggestion, PricingSuggestionRequest, QuickCaches, RateLimitError, RateLimiter, type RecoveryQR, RecoveryQRGenerator, RefundEscrowRequest, type RequestConfig, type RequestInterceptor, type ResponseData, type ResponseInterceptor, type RetryOptions, RetryStrategy, SPENDING_LIMIT_ACTION_CID, SecureStorage, SessionKeyCache, type SessionKeyCacheConfig, SessionKeyCrypto, SessionKeyLifecycle, SessionKeyListResponse, type SessionKeyPaymentRequest, SessionKeyStatus, SessionKeysAPI, type SignPaymentParams, type SignPaymentResult, SmartPaymentRequest, SmartPaymentResponse, SmartPaymentsAPI, SubmitSignedTransactionRequest, SubmitTransactionResponse, Subscription, SubscriptionPlan, type TestSessionKey, TopUpSessionKeyRequest, TopUpSessionKeyResponse, TransactionMonitor, TransactionPoller, type TransactionStatus, ValidationError, VerifyWebhookRequest, WalletConnector, WebhookError, WebhookPayload, ZendFiClient, ZendFiConfig, ZendFiEmbeddedCheckout, ZendFiError, type ZendFiErrorData, type ZendFiErrorType, ZendFiSessionKeyManager, createWalletHook, createZendFiError, decodeSignatureFromLit, encodeTransactionForLit, generateIdempotencyKey, isZendFiError, requiresLitSigning, setupQuickSessionKey, sleep, verifyExpressWebhook, verifyNextWebhook, verifyWebhookSignature, zendfi };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { C as CreateAgentApiKeyRequest, A as AgentApiKey, b as CreateAgentSessionRequest, c as AgentSession, d as AgentPaymentRequest, e as AgentPaymentResponse, f as AgentAnalytics, g as CreatePaymentIntentRequest, P as PaymentIntent, h as ConfirmPaymentIntentRequest, i as PaymentIntentEvent, j as PPPFactor, k as PricingSuggestionRequest, l as PricingSuggestion, E as EnableAutonomyRequest, m as EnableAutonomyResponse, n as AutonomyStatus, S as SmartPaymentRequest, o as SmartPaymentResponse, p as CreateSessionKeyRequest, q as CreateSessionKeyResponse, r as CreateDeviceBoundSessionKeyRequest$1, s as CreateDeviceBoundSessionKeyResponse$1, t as SubmitSignedTransactionRequest, u as SubmitTransactionResponse, v as SessionKeyStatus, w as SessionKeyListResponse, T as TopUpSessionKeyRequest, x as TopUpSessionKeyResponse, Z as ZendFiConfig, y as CreatePaymentRequest, z as Payment, L as ListPaymentsRequest, B as PaginatedResponse, D as CreateSubscriptionPlanRequest, F as SubscriptionPlan, G as CreateSubscriptionRequest, H as Subscription, I as CreatePaymentLinkRequest, J as PaymentLink, K as CreateInstallmentPlanRequest, M as InstallmentPlan, N as CreateEscrowRequest, O as Escrow, Q as ApproveEscrowRequest, R as RefundEscrowRequest, U as DisputeEscrowRequest, V as CreateInvoiceRequest, X as Invoice, Y as VerifyWebhookRequest, _ as WebhookPayload } from './webhook-handler-DGBeCWT-.js';
-export { a5 as AgentKeyId, ao as ApiKeyMode, aD as ApiKeyScope, aJ as AutonomousDelegate, a2 as Brand, aG as CaptureMethod, aA as CreateInstallmentPlanResponse, ap as Currency, an as Environment, a9 as EscrowId, au as EscrowStatus, aa as InstallmentPlanId, at as InstallmentPlanStatus, az as InstallmentScheduleItem, ac as IntentId, a7 as InvoiceId, aC as InvoiceLineItem, av as InvoiceStatus, aO as LinkedSessionInfo, a6 as MerchantId, aI as PPPConfig, a3 as PaymentId, aF as PaymentIntentStatus, ab as PaymentLinkCode, ar as PaymentStatus, aq as PaymentToken, aB as ReleaseCondition, aK as RevokeAutonomyRequest, aP as SecurityStatus, a4 as SessionId, aM as SessionKeyInstructions, aN as SessionKeySecurityInfo, aQ as SessionKeyStats, aE as SessionLimits, aL as SmartPaymentStatus, ay as SplitRecipient, aw as SplitStatus, a8 as SubscriptionId, as as SubscriptionStatus, aH as UserProfile, ax as WebhookEvent, a1 as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, a0 as WebhookResult, af as asAgentKeyId, aj as asEscrowId, ak as asInstallmentPlanId, am as asIntentId, ah as asInvoiceId, ag as asMerchantId, ad as asPaymentId, al as asPaymentLinkCode, ae as asSessionId, ai as asSubscriptionId, $ as processWebhook } from './webhook-handler-DGBeCWT-.js';
+import { C as CreateAgentApiKeyRequest, A as AgentApiKey, b as CreateAgentSessionRequest, c as AgentSession, d as AgentPaymentRequest, e as AgentPaymentResponse, f as AgentAnalytics, g as CreatePaymentIntentRequest, P as PaymentIntent, h as ConfirmPaymentIntentRequest, i as PaymentIntentEvent, j as PPPFactor, k as PricingSuggestionRequest, l as PricingSuggestion, E as EnableAutonomyRequest, m as EnableAutonomyResponse, n as AutonomyStatus, S as SmartPaymentRequest, o as SmartPaymentResponse, p as CreateSessionKeyRequest, q as CreateSessionKeyResponse, r as CreateDeviceBoundSessionKeyRequest$1, s as CreateDeviceBoundSessionKeyResponse$1, t as SubmitSignedTransactionRequest, u as SubmitTransactionResponse, v as SessionKeyStatus, w as SessionKeyListResponse, T as TopUpSessionKeyRequest, x as TopUpSessionKeyResponse, Z as ZendFiConfig, y as CreatePaymentRequest, z as Payment, L as ListPaymentsRequest, B as PaginatedResponse, D as CreateSubscriptionPlanRequest, F as SubscriptionPlan, G as CreateSubscriptionRequest, H as Subscription, I as CreatePaymentLinkRequest, J as PaymentLink, K as CreateInstallmentPlanRequest, M as InstallmentPlan, N as CreateEscrowRequest, O as Escrow, Q as ApproveEscrowRequest, R as RefundEscrowRequest, U as DisputeEscrowRequest, V as CreateInvoiceRequest, X as Invoice, Y as VerifyWebhookRequest, _ as WebhookPayload, $ as ApiKeyMode } from './webhook-handler-D5INiR-l.js';
+export { a6 as AgentKeyId, aD as ApiKeyScope, aJ as AutonomousDelegate, a3 as Brand, aG as CaptureMethod, aA as CreateInstallmentPlanResponse, ap as Currency, ao as Environment, aa as EscrowId, au as EscrowStatus, ab as InstallmentPlanId, at as InstallmentPlanStatus, az as InstallmentScheduleItem, ad as IntentId, a8 as InvoiceId, aC as InvoiceLineItem, av as InvoiceStatus, aO as LinkedSessionInfo, a7 as MerchantId, aI as PPPConfig, a4 as PaymentId, aF as PaymentIntentStatus, ac as PaymentLinkCode, ar as PaymentStatus, aq as PaymentToken, aB as ReleaseCondition, aK as RevokeAutonomyRequest, aP as SecurityStatus, a5 as SessionId, aM as SessionKeyInstructions, aN as SessionKeySecurityInfo, aQ as SessionKeyStats, aE as SessionLimits, aL as SmartPaymentStatus, ay as SplitRecipient, aw as SplitStatus, a9 as SubscriptionId, as as SubscriptionStatus, aH as UserProfile, ax as WebhookEvent, a2 as WebhookEventHandler, W as WebhookHandlerConfig, a as WebhookHandlers, a1 as WebhookResult, ag as asAgentKeyId, ak as asEscrowId, al as asInstallmentPlanId, an as asIntentId, ai as asInvoiceId, ah as asMerchantId, ae as asPaymentId, am as asPaymentLinkCode, af as asSessionId, aj as asSubscriptionId, a0 as processWebhook } from './webhook-handler-D5INiR-l.js';
 import { Transaction, Keypair } from '@solana/web3.js';
 
 /**
@@ -1753,6 +1753,211 @@ declare function verifyExpressWebhook(request: any, secret?: string): Promise<We
  */
 declare function verifyWebhookSignature(payload: string, signature: string, secret: string): boolean;
 
+/**
+ * ZendFi Embedded Checkout
+ *
+ * Embed the ZendFi checkout directly into your website/app
+ * without redirecting to checkout.zendfi.tech
+ *
+ * @example
+ * ```typescript
+ * import { ZendFiEmbeddedCheckout } from '@zendfi/sdk';
+ *
+ * const checkout = new ZendFiEmbeddedCheckout({
+ *   linkCode: 'abc123xyz',
+ *   containerId: 'zendfi-checkout',
+ *   mode: 'live',
+ *   onSuccess: (payment) => {
+ *     console.log('Payment successful!', payment);
+ *   },
+ *   onError: (error) => {
+ *     console.error('Payment failed:', error);
+ *   }
+ * });
+ *
+ * checkout.mount();
+ * ```
+ */
+
+interface EmbeddedCheckoutConfig {
+    /** Payment link code or payment ID */
+    linkCode?: string;
+    paymentId?: string;
+    /** Container element ID where checkout will be mounted */
+    containerId: string;
+    /** API mode - 'test' for devnet, 'live' for mainnet */
+    mode?: ApiKeyMode;
+    /** API base URL (defaults to production) */
+    apiUrl?: string;
+    /** Callback when payment is successful */
+    onSuccess?: (payment: PaymentSuccessData) => void;
+    /** Callback when payment fails */
+    onError?: (error: CheckoutError) => void;
+    /** Callback when checkout is loaded */
+    onLoad?: () => void;
+    /** Custom theme overrides */
+    theme?: CheckoutTheme;
+    /** Enable custom amount (Pay What You Want) */
+    allowCustomAmount?: boolean;
+    /** Show/hide specific payment methods */
+    paymentMethods?: {
+        walletConnect?: boolean;
+        qrCode?: boolean;
+        solanaWallet?: boolean;
+    };
+}
+interface CheckoutTheme {
+    primaryColor?: string;
+    backgroundColor?: string;
+    borderRadius?: string;
+    fontFamily?: string;
+    textColor?: string;
+    buttonStyle?: 'solid' | 'outlined' | 'minimal';
+}
+interface PaymentSuccessData {
+    paymentId: string;
+    transactionSignature: string;
+    amount: number;
+    token: string;
+    merchantName: string;
+}
+interface CheckoutError {
+    code: string;
+    message: string;
+    details?: any;
+}
+/**
+ * ZendFi Embedded Checkout Component
+ *
+ * Provides a fully-functional checkout experience that can be
+ * embedded directly into any web application.
+ */
+declare class ZendFiEmbeddedCheckout {
+    private config;
+    private container;
+    private checkoutData;
+    private pollInterval;
+    private mounted;
+    constructor(config: EmbeddedCheckoutConfig);
+    private getDefaultApiUrl;
+    /**
+     * Mount the checkout to the DOM
+     */
+    mount(): Promise<void>;
+    /**
+     * Unmount and cleanup
+     */
+    unmount(): void;
+    /**
+     * Fetch checkout data from API
+     */
+    private fetchCheckoutData;
+    /**
+     * Poll for payment confirmation
+     */
+    private startPaymentPolling;
+    /**
+     * Handle successful payment
+     */
+    private handlePaymentSuccess;
+    /**
+     * Handle payment failure
+     */
+    private handlePaymentFailure;
+    /**
+     * Handle payment expiration
+     */
+    private handlePaymentExpired;
+    /**
+     * Render loading state
+     */
+    private renderLoading;
+    /**
+     * Render the main checkout UI
+     */
+    private render;
+    /**
+     * Render header section
+     */
+    private renderHeader;
+    /**
+     * Render payment information
+     */
+    private renderPaymentInfo;
+    /**
+     * Render custom amount input (Pay What You Want)
+     */
+    private renderCustomAmountInput;
+    /**
+     * Render payment methods
+     */
+    private renderPaymentMethods;
+    /**
+     * Render QR code payment method
+     */
+    private renderQRCodeMethod;
+    /**
+     * Render browser wallet method
+     */
+    private renderWalletMethod;
+    /**
+     * Render WalletConnect method
+     */
+    private renderWalletConnectMethod;
+    /**
+     * Render footer
+     */
+    private renderFooter;
+    /**
+     * Render success state
+     */
+    private renderSuccess;
+    /**
+     * Render error state
+     */
+    private renderError;
+    /**
+     * Attach event listeners to interactive elements
+     */
+    private attachEventListeners;
+    /**
+     * Handle wallet connection and payment
+     */
+    private handleWalletConnect;
+    /**
+     * Handle mobile wallet connection via Solana Pay deep link
+     */
+    private handleWalletConnectScan;
+    /**
+     * Generate QR code on canvas using QRious library
+     */
+    private generateQRCode;
+    /**
+     * Inject custom styles
+     */
+    private injectStyles;
+    /**
+     * Load external dependencies (QR code library, Solana web3.js)
+     */
+    private loadDependencies;
+    /**
+     * Load external script
+     */
+    private loadScript;
+    /**
+     * Get computed theme with defaults
+     */
+    private getComputedTheme;
+    /**
+     * Style helpers
+     */
+    private getCheckoutContainerStyles;
+    private getLoadingStyles;
+    private getSpinnerStyles;
+    private getSuccessStyles;
+    private getErrorStyles;
+}
+
 /**
  * ZendFi SDK Error Classes
  *
@@ -3419,4 +3624,4 @@ declare class PerformanceMonitor {
     clear(): void;
 }
 
-export { AgentAPI, AgentAnalytics, AgentApiKey, AgentPaymentRequest, AgentPaymentResponse, AgentSession, AnthropicAdapter, ApiError, ApproveEscrowRequest, AuthenticationError, AutonomyAPI, AutonomyStatus, type CachedKeypair, ConfigLoader, ConfirmPaymentIntentRequest, type ConnectedWallet, CreateAgentApiKeyRequest, CreateAgentSessionRequest, type CreateAndFundConfig, type CreateDeviceBoundSessionKeyRequest, type CreateDeviceBoundSessionKeyResponse, CreateEscrowRequest, CreateInstallmentPlanRequest, CreateInvoiceRequest, CreatePaymentIntentRequest, CreatePaymentLinkRequest, CreatePaymentRequest, CreateSessionKeyRequest, CreateSessionKeyResponse, CreateSubscriptionPlanRequest, CreateSubscriptionRequest, type CustomStorageAdapter, DevTools, DeviceBoundSessionKey, type DeviceBoundSessionKeyOptions, DeviceFingerprintGenerator, DisputeEscrowRequest, ERROR_CODES, EnableAutonomyRequest, EnableAutonomyResponse, type EncryptedSessionKey, type ErrorInterceptor, ErrorRecovery, Escrow, GeminiAdapter, InstallmentPlan, InterceptorManager, type Interceptors, Invoice, type LifecycleConfig, ListPaymentsRequest, LitCryptoSigner, type LitCryptoSignerConfig, type LitNetwork, type MockWallet, NetworkError, OpenAIAdapter, PINRateLimiter, type PINValidationResult, PINValidator, PPPFactor, PaginatedResponse, type ParsedIntent, Payment, PaymentError, PaymentIntent, PaymentIntentEvent, PaymentIntentParser, PaymentIntentsAPI, PaymentLink, type PaymentResult, PerformanceMonitor, type PollingOptions, PricingAPI, PricingSuggestion, PricingSuggestionRequest, QuickCaches, RateLimitError, RateLimiter, type RecoveryQR, RecoveryQRGenerator, RefundEscrowRequest, type RequestConfig, type RequestInterceptor, type ResponseData, type ResponseInterceptor, type RetryOptions, RetryStrategy, SPENDING_LIMIT_ACTION_CID, SecureStorage, SessionKeyCache, type SessionKeyCacheConfig, SessionKeyCrypto, SessionKeyLifecycle, SessionKeyListResponse, type SessionKeyPaymentRequest, SessionKeyStatus, SessionKeysAPI, type SignPaymentParams, type SignPaymentResult, SmartPaymentRequest, SmartPaymentResponse, SmartPaymentsAPI, SubmitSignedTransactionRequest, SubmitTransactionResponse, Subscription, SubscriptionPlan, type TestSessionKey, TopUpSessionKeyRequest, TopUpSessionKeyResponse, TransactionMonitor, TransactionPoller, type TransactionStatus, ValidationError, VerifyWebhookRequest, WalletConnector, WebhookError, WebhookPayload, ZendFiClient, ZendFiConfig, ZendFiError, type ZendFiErrorData, type ZendFiErrorType, ZendFiSessionKeyManager, createWalletHook, createZendFiError, decodeSignatureFromLit, encodeTransactionForLit, generateIdempotencyKey, isZendFiError, requiresLitSigning, setupQuickSessionKey, sleep, verifyExpressWebhook, verifyNextWebhook, verifyWebhookSignature, zendfi };
+export { AgentAPI, AgentAnalytics, AgentApiKey, AgentPaymentRequest, AgentPaymentResponse, AgentSession, AnthropicAdapter, ApiError, ApiKeyMode, ApproveEscrowRequest, AuthenticationError, AutonomyAPI, AutonomyStatus, type CachedKeypair, type CheckoutError, type CheckoutTheme, ConfigLoader, ConfirmPaymentIntentRequest, type ConnectedWallet, CreateAgentApiKeyRequest, CreateAgentSessionRequest, type CreateAndFundConfig, type CreateDeviceBoundSessionKeyRequest, type CreateDeviceBoundSessionKeyResponse, CreateEscrowRequest, CreateInstallmentPlanRequest, CreateInvoiceRequest, CreatePaymentIntentRequest, CreatePaymentLinkRequest, CreatePaymentRequest, CreateSessionKeyRequest, CreateSessionKeyResponse, CreateSubscriptionPlanRequest, CreateSubscriptionRequest, type CustomStorageAdapter, DevTools, DeviceBoundSessionKey, type DeviceBoundSessionKeyOptions, DeviceFingerprintGenerator, DisputeEscrowRequest, ERROR_CODES, type EmbeddedCheckoutConfig, EnableAutonomyRequest, EnableAutonomyResponse, type EncryptedSessionKey, type ErrorInterceptor, ErrorRecovery, Escrow, GeminiAdapter, InstallmentPlan, InterceptorManager, type Interceptors, Invoice, type LifecycleConfig, ListPaymentsRequest, LitCryptoSigner, type LitCryptoSignerConfig, type LitNetwork, type MockWallet, NetworkError, OpenAIAdapter, PINRateLimiter, type PINValidationResult, PINValidator, PPPFactor, PaginatedResponse, type ParsedIntent, Payment, PaymentError, PaymentIntent, PaymentIntentEvent, PaymentIntentParser, PaymentIntentsAPI, PaymentLink, type PaymentResult, type PaymentSuccessData, PerformanceMonitor, type PollingOptions, PricingAPI, PricingSuggestion, PricingSuggestionRequest, QuickCaches, RateLimitError, RateLimiter, type RecoveryQR, RecoveryQRGenerator, RefundEscrowRequest, type RequestConfig, type RequestInterceptor, type ResponseData, type ResponseInterceptor, type RetryOptions, RetryStrategy, SPENDING_LIMIT_ACTION_CID, SecureStorage, SessionKeyCache, type SessionKeyCacheConfig, SessionKeyCrypto, SessionKeyLifecycle, SessionKeyListResponse, type SessionKeyPaymentRequest, SessionKeyStatus, SessionKeysAPI, type SignPaymentParams, type SignPaymentResult, SmartPaymentRequest, SmartPaymentResponse, SmartPaymentsAPI, SubmitSignedTransactionRequest, SubmitTransactionResponse, Subscription, SubscriptionPlan, type TestSessionKey, TopUpSessionKeyRequest, TopUpSessionKeyResponse, TransactionMonitor, TransactionPoller, type TransactionStatus, ValidationError, VerifyWebhookRequest, WalletConnector, WebhookError, WebhookPayload, ZendFiClient, ZendFiConfig, ZendFiEmbeddedCheckout, ZendFiError, type ZendFiErrorData, type ZendFiErrorType, ZendFiSessionKeyManager, createWalletHook, createZendFiError, decodeSignatureFromLit, encodeTransactionForLit, generateIdempotencyKey, isZendFiError, requiresLitSigning, setupQuickSessionKey, sleep, verifyExpressWebhook, verifyNextWebhook, verifyWebhookSignature, zendfi };