@seaverse/payment-sdk 0.7.0 → 0.8.0

package/README.en.md

@@ -0,0 +1,842 @@
+# @seaverse/payment-sdk
+
+SeaVerse Payment SDK - All-in-one payment solution providing credit management, payment modals, subscription management, and order tracking.
+
+> **Latest Version**: v0.8.0 | **Documentation**: English
+
+## 📦 Installation
+
+```bash
+npm install @seaverse/payment-sdk
+# or
+pnpm add @seaverse/payment-sdk
+```
+
+## 🚀 Quick Start
+
+### 1. Credit Package Purchase Modal (Recommended)
+
+Simplest integration - complete payment flow in 3 lines of code:
+
+```typescript
+import { CreditPackageModal } from '@seaverse/payment-sdk';
+
+// Create modal
+const modal = new CreditPackageModal({
+  sdkConfig: {
+    environment: 'development',     // Environment: 'development' | 'production'
+    countryCode: 'SG',              // Country code
+    accountToken: 'user-token',     // User auth token (optional)
+  },
+  onPaymentSuccess: (orderId, transactionId) => {
+    console.log('Payment successful!', { orderId, transactionId });
+  },
+});
+
+// Open modal
+modal.open();
+```
+
+**Features**:
+- ✅ Auto-display preset credit packages (120/240/520/1200 credits)
+- ✅ Auto-initialize payment SDK
+- ✅ Auto-create orders
+- ✅ Show purchase success modal (with animations)
+- ✅ Auto-refresh credit balance
+
+### 2. Generic Package Modal (Custom Packages)
+
+For special promotions, ice breaker packs, first charge bonuses:
+
+```typescript
+import { GenericPackageModal, type GenericPackage } from '@seaverse/payment-sdk';
+
+// Define custom packages
+const packages: GenericPackage[] = [
+  {
+    id: 'pkg_value',
+    name: 'Ice Breaker Pack',
+    price: '0.49',
+    currency: 'USD',
+    credits: '120',
+    bonus_percentage: 20,
+    day_limit: 1,  // Daily purchase limit
+    package_type: 'iceBreaker',
+  },
+  {
+    id: 'pkg_pro',
+    name: 'Emergency Pack',
+    price: '0.99',
+    currency: 'USD',
+    credits: '240',
+    day_limit: 3,  // Daily purchase limit
+    package_type: 'emergency',
+  },
+];
+
+// Create modal
+const modal = new GenericPackageModal({
+  packages: packages,
+  sdkConfig: {
+    environment: 'development',
+    countryCode: 'SG',
+    accountToken: 'user-token',
+  },
+  onPaymentSuccess: (orderId, transactionId, pkg) => {
+    console.log(`${pkg.name} purchased successfully!`, orderId);
+  },
+  onPaymentFailed: (error, pkg) => {
+    if (error.message.includes('limit')) {
+      alert(`${pkg.name} purchase limit reached`);
+    }
+  },
+});
+
+modal.open();
+```
+
+## 📖 Core Features
+
+### ⭐️ Recommended Features (For New Users)
+
+| Feature | Component | Use Case | Documentation |
+|---------|-----------|----------|---------------|
+| **Credit Package Purchase** | `CreditPackageModal` | Standard credit purchase (simplest) | [👉 View](#creditpackagemodal---standard-credit-purchase) |
+| **Custom Package Purchase** | `GenericPackageModal` | Promotions, special packages | [👉 View](#genericpackagemodal---custom-package-purchase) |
+| **Purchase Success Modal** | `PurchaseSuccessModal` | Auto-integrated, no manual call needed | [👉 View](#purchasesuccessmodal---purchase-success-modal) |
+
+### 🔧 Advanced Features (For Advanced Users)
+
+| Feature | API | Use Case |
+|---------|-----|----------|
+| **Credit Query** | `PaymentClient` | Query user credit balance, transaction history |
+| **Subscription Management** | `getCurrentSubscription`, `changeSubscription` | Subscription status query, upgrade/downgrade |
+| **Order Management** | `checkOrderStatus`, `pollOrderStatus` | Order status query, polling |
+| **SeaartPayment SDK** | `SeaartPaymentSDK` | Fully customized payment flow |
+
+---
+
+## 📚 Detailed Documentation
+
+### CreditPackageModal - Standard Credit Purchase
+
+**Use Cases**:
+- ✅ Standard credit package purchase (120/240/520/1200 credits)
+- ✅ Display creative power types (text-to-image, image-to-image, etc.)
+- ✅ Simplest integration method
+
+#### Basic Usage
+
+```typescript
+import { CreditPackageModal } from '@seaverse/payment-sdk';
+
+const modal = new CreditPackageModal({
+  // Language setting (optional, default 'en')
+  language: 'en',  // 'en' | 'zh-CN'
+
+  // SDK configuration (required)
+  sdkConfig: {
+    environment: 'development',  // 'development' | 'production'
+    countryCode: 'SG',           // ISO 3166-1 country code
+    accountToken: 'user-token',  // User auth token (optional)
+    businessType: 1,             // 1=one-time purchase, 2=subscription (optional, default 1)
+  },
+
+  // Callbacks
+  onPaymentSuccess: (orderId: string, transactionId: string) => {
+    console.log('Payment successful!', { orderId, transactionId });
+    // Refresh user credits, update UI, etc.
+  },
+
+  onPaymentFailed: (error: Error) => {
+    console.error('Payment failed:', error.message);
+    // Show error message
+  },
+
+  onClose: () => {
+    console.log('Modal closed');
+  },
+});
+
+// Open modal
+modal.open();
+
+// Close modal (optional)
+modal.close();
+
+// Check modal state
+console.log('Is modal open:', modal.isOpen());
+```
+
+#### Preset Credit Packages
+
+SDK includes the following credit packages:
+
+| Package | Credits | Price | Description |
+|---------|---------|-------|-------------|
+| Starter | 120 | $0.49 | Entry package |
+| Value | 240 | $0.99 | Value package |
+| Pro | 520 | $1.99 | Professional package |
+| Ultra | 1200 | $4.99 | Premium package |
+
+#### Environment Configuration
+
+SDK automatically configures the following parameters based on `environment`:
+
+**Development Environment**:
+```typescript
+{
+  scriptUrl: 'https://seaart-publish.sc-api-release.saconsole.com/payment-component/client.js',
+  clientId: 'XF49NOfyZ54O16GujB0ptio2',
+  orderApiUrl: 'https://payment.sg.seaverse.dev',
+  walletApiUrl: 'https://wallet.sg.seaverse.dev',
+}
+```
+
+**Production Environment**:
+```typescript
+{
+  scriptUrl: 'https://payment-static.seaverse.com/sdk/seaart-payment-component.js',
+  clientId: 'prod_client_id',
+  orderApiUrl: 'https://payment.seaverse.com',
+  walletApiUrl: 'https://wallet.seaverse.com',
+}
+```
+
+#### Advanced Configuration (Optional)
+
+To override environment configuration:
+
+```typescript
+const modal = new CreditPackageModal({
+  sdkConfig: {
+    environment: 'production',
+    countryCode: 'US',
+
+    // Override default configuration
+    scriptUrl: 'https://custom-cdn.com/payment.js',
+    clientId: 'custom-client-id',
+    orderApiUrl: 'https://custom-api.com',
+  },
+});
+```
+
+---
+
+### GenericPackageModal - Custom Package Purchase
+
+**Use Cases**:
+- ✅ Special promotion packages (ice breaker, emergency, first charge)
+- ✅ Limited-time promotional activities
+- ✅ Custom package data and styles
+
+#### Basic Usage
+
+```typescript
+import { GenericPackageModal, type GenericPackage } from '@seaverse/payment-sdk';
+
+// Define package data
+const packages: GenericPackage[] = [
+  {
+    id: 'pkg_ice_breaker',
+    name: 'Ice Breaker Pack',
+    price: '0.49',
+    currency: 'USD',
+    credits: '120',
+    base_credits: '100',
+    bonus_credits: '20',
+    bonus_percentage: 20,
+    day_limit: 1,
+    package_type: 'iceBreaker',
+  },
+];
+
+// Create modal
+const modal = new GenericPackageModal({
+  language: 'en',
+  packages: packages,
+
+  sdkConfig: {
+    environment: 'development',
+    countryCode: 'SG',
+    accountToken: 'user-token',
+  },
+
+  onPaymentSuccess: (orderId, transactionId, pkg) => {
+    console.log(`${pkg.name} purchased successfully!`, { orderId, transactionId });
+  },
+
+  onPaymentFailed: (error, pkg) => {
+    console.error(`${pkg.name} purchase failed:`, error.message);
+  },
+});
+
+modal.open();
+```
+
+#### GenericPackage Interface
+
+```typescript
+interface GenericPackage {
+  // Basic information (required)
+  id: string;              // Unique package ID
+  name: string;            // Package name
+  price: string;           // Price (string for decimal precision)
+  currency: string;        // Currency code (e.g., 'USD')
+  credits: string;         // Total credits
+
+  // Bonus information (optional)
+  base_credits?: string;       // Base credits
+  bonus_credits?: string;      // Bonus credits
+  bonus_percentage?: number;   // Bonus percentage (e.g., 20 for +20%)
+
+  // Purchase limits (optional, display only, validated by backend)
+  day_limit?: number;          // Daily purchase limit (0 = unlimited)
+  lifetime_limit?: number;     // Lifetime purchase limit (0 = unlimited)
+
+  // Category (optional)
+  package_type?: 'iceBreaker' | 'emergency' | 'firstCharge' | 'custom';
+}
+```
+
+#### Predefined Package Examples
+
+SDK provides the following predefined packages for reference:
+
+```typescript
+import {
+  EXAMPLE_ICE_BREAKER,    // Ice breaker pack
+  EXAMPLE_EMERGENCY,      // Emergency pack
+  EXAMPLE_FIRST_CHARGE,   // First charge pack
+  EXAMPLE_PACKAGES,       // All example packages array
+} from '@seaverse/payment-sdk';
+
+// Use predefined packages
+const modal = new GenericPackageModal({
+  packages: [EXAMPLE_ICE_BREAKER, EXAMPLE_EMERGENCY],
+  sdkConfig: { /* ... */ },
+});
+```
+
+**Predefined Package Details**:
+
+| Package | Price | Credits | Limit | Description |
+|---------|-------|---------|-------|-------------|
+| `EXAMPLE_ICE_BREAKER` | $0.49 | 120 | 1/day | Ice breaker - super value first purchase |
+| `EXAMPLE_EMERGENCY` | $0.99 | 240 | 3/day | Emergency - daily conversion driver |
+| `EXAMPLE_FIRST_CHARGE` | $1.99 | 620 | 1/lifetime | First charge - boost user LTV |
+
+---
+
+### PurchaseSuccessModal - Purchase Success Modal
+
+**✨ Auto-integrated** - No manual call needed, automatically displays after successful payment in `CreditPackageModal` and `GenericPackageModal`.
+
+#### Features
+
+- ✅ Email confirmation card style design
+- ✅ Beautiful animations (fade in/out, scale, staggered animations)
+- ✅ Display purchase details (package name, credits, payment amount)
+- ✅ Support ESC key, click overlay, close button to dismiss
+- ✅ Auto-prevent body scrolling
+- ✅ Support English and Chinese
+
+#### Auto-trigger Flow
+
+```
+User clicks purchase button
+  ↓
+Payment successful
+  ↓
+CreditPackageModal/GenericPackageModal closes
+  ↓
+PurchaseSuccessModal auto-displays (with animations)
+  ↓
+User closes success modal
+  ↓
+Auto-refresh credit balance
+  ↓
+Trigger onPaymentSuccess callback
+```
+
+#### Manual Usage (Optional)
+
+For manual invocation in other scenarios:
+
+```typescript
+import { PurchaseSuccessModal } from '@seaverse/payment-sdk';
+
+const successModal = new PurchaseSuccessModal({
+  data: {
+    packName: 'Ice Breaker Pack',
+    credits: 120,
+    amount: '0.49',
+    currency: '$',
+    orderId: 'order_123',
+    transactionId: 'txn_456',
+  },
+  language: 'en',
+  onClose: () => {
+    console.log('Success modal closed');
+  },
+});
+
+successModal.open();
+```
+
+---
+
+## 🔍 Advanced Features
+
+### Credit Query (PaymentClient)
+
+Query user credit balance and transaction history:
+
+```typescript
+import { PaymentClient } from '@seaverse/payment-sdk';
+
+const client = new PaymentClient({
+  appId: 'seaverse',
+  token: 'your-bearer-token',
+  baseURL: 'https://payment.sg.seaverse.dev',  // Optional
+});
+
+// Query credit details (4-pool structure)
+const detail = await client.getCreditDetail();
+console.log('Total balance:', detail.total_balance);
+
+detail.pools.forEach(pool => {
+  console.log(`${pool.type} pool: ${pool.balance} credits`);
+});
+
+// Query transaction history
+const transactions = await client.listTransactions({
+  page: 1,
+  page_size: 20,
+  start_time: '2024-01-01T00:00:00Z',
+  end_time: '2024-12-31T23:59:59Z',
+});
+
+transactions.transactions.forEach(txn => {
+  console.log(`${txn.type}: ${txn.amount} credits`);
+});
+```
+
+#### 4-Pool Credit System
+
+| Pool Type | Description | Expiration |
+|-----------|-------------|------------|
+| `daily` | Daily credits | Next day 00:00 UTC |
+| `event` | Event credits | Event deadline |
+| `monthly` | Monthly credits | 30 days after grant |
+| `permanent` | Permanent credits | Never expires |
+
+**Consumption Priority**: Daily → Event → Monthly → Permanent
+
+---
+
+### Subscription Management
+
+Query and manage user subscriptions:
+
+```typescript
+import {
+  getCurrentSubscription,
+  getActiveSubscription,
+  changeSubscription,
+  restartSubscription,
+} from '@seaverse/payment-sdk';
+
+const apiUrl = 'https://payment.sg.seaverse.dev';
+const token = 'user-token';
+
+// Query current subscription status
+const current = await getCurrentSubscription(apiUrl, token);
+console.log('Subscription status:', current.subscription_status);
+
+// Query active subscription details
+const active = await getActiveSubscription(apiUrl, token);
+console.log('Current plan:', active.product_name);
+
+// Upgrade/downgrade subscription
+const changeResult = await changeSubscription(apiUrl, token, {
+  productId: 'pro_plan',
+  billingPeriod: 'year',
+  redirectUrl: window.location.href,
+});
+
+// Restart cancelled subscription
+const restartResult = await restartSubscription(apiUrl, token, {
+  subscriptionId: 'sub_123',
+});
+```
+
+---
+
+### Order Management
+
+Check order status and poll payment results:
+
+```typescript
+import { checkOrderStatus, pollOrderStatus } from '@seaverse/payment-sdk';
+
+const apiUrl = 'https://payment.sg.seaverse.dev';
+const token = 'user-token';
+
+// Single order status check
+const status = await checkOrderStatus('transaction_id', apiUrl, token);
+console.log('Order status:', status.order_status);
+
+// Poll order status until final state
+const finalStatus = await pollOrderStatus('transaction_id', apiUrl, token, {
+  interval: 2000,      // Polling interval (ms)
+  maxAttempts: 30,     // Max attempts
+  onPoll: (status, attempt) => {
+    console.log(`Attempt ${attempt}: ${status}`);
+  },
+});
+
+console.log('Final status:', finalStatus.order_status);
+```
+
+---
+
+### SeaartPayment SDK (Fully Customized)
+
+For advanced scenarios requiring complete payment flow control:
+
+```typescript
+import { SeaartPaymentSDK } from '@seaverse/payment-sdk';
+
+// 1. Initialize SDK (on app startup)
+const sdk = SeaartPaymentSDK.getInstance();
+await sdk.init({
+  scriptUrl: 'https://your-cdn.com/seaart-payment.js',
+  clientId: 'your-client-id',
+  language: 'en',
+  cssUrl: 'https://your-cdn.com/seaart-payment.css',  // Optional
+});
+
+// 2. Get payment methods
+const methods = await sdk.getPaymentMethods({
+  country_code: 'US',
+  business_type: 2,  // 1=one-time, 2=subscription
+});
+
+// 3. Create order payment instance
+const orderPayment = sdk.createOrderPayment({
+  orderId: 'order-123',
+  accountToken: 'user-token',
+});
+
+// 4a. Redirect payment (Link Payment)
+const linkMethod = methods.find(m => m.payment_type === 1);
+const linkPayment = orderPayment.createLinkPayment(linkMethod, {
+  callback_url: `${window.location.origin}/payment-callback`,
+});
+await linkPayment.redirectToPayment();
+
+// 4b. Embedded payment (Dropin Payment)
+const dropinMethod = methods.find(m => m.payment_type === 2);
+const dropinPayment = orderPayment.createDropinPayment(dropinMethod, {
+  containerId: '#payment-container',
+  onCompleted: (payload) => {
+    console.log('Payment successful:', payload);
+  },
+  onFailed: (payload) => {
+    console.error('Payment failed:', payload);
+  },
+});
+await dropinPayment.render();
+
+// 5. Handle payment callback (on callback page)
+const result = await sdk.handleCallback(
+  { type: 'subscription' },
+  'https://payment-api.com',
+  'auth-token'
+);
+if (result.success) {
+  console.log('Payment verified:', result.data);
+}
+```
+
+---
+
+## ⚙️ Configuration Options
+
+### Environment Configuration
+
+| Environment | Value | Description |
+|-------------|-------|-------------|
+| Development | `'development'` | Development and testing |
+| Production | `'production'` | Production environment |
+
+### SDK Configuration (sdkConfig)
+
+```typescript
+interface PaymentSDKConfig {
+  // Required parameters
+  environment: 'development' | 'production';  // Environment
+  countryCode: string;                        // Country code (ISO 3166-1)
+
+  // Optional parameters
+  accountToken?: string;      // User auth token
+  businessType?: 1 | 2;       // 1=one-time purchase, 2=subscription (default 1)
+
+  // Advanced options (override environment config)
+  scriptUrl?: string;         // Custom script URL
+  clientId?: string;          // Custom client ID
+  orderApiUrl?: string;       // Custom order API URL
+  cssUrl?: string;            // Custom CSS URL
+  scriptTimeout?: number;     // Script load timeout (default 10000ms)
+  paymentMethodType?: string; // Payment method type filter (default 'dropin')
+}
+```
+
+---
+
+## 🎨 UI Feedback Tools
+
+SDK provides unified UI feedback tools to replace native browser `alert()`:
+
+```typescript
+import {
+  showErrorMessage,
+  showSuccessMessage,
+  showInfoMessage,
+  showLoadingIndicator,
+  hideLoadingIndicator,
+} from '@seaverse/payment-sdk';
+
+// Error message (red gradient background)
+showErrorMessage('Payment failed, please retry', 3000);
+
+// Success message (green gradient background)
+showSuccessMessage('Payment successful!', 3000);
+
+// Info message (blue gradient background)
+showInfoMessage('Processing your request...', 3000);
+
+// Loading indicator
+const loader = showLoadingIndicator('Initializing payment system...');
+// ... async operation
+hideLoadingIndicator(loader);
+```
+
+**Features**:
+- ✅ Beautiful gradient backgrounds + icons
+- ✅ Auto fade in/out animations
+- ✅ Auto-remove (configurable duration)
+- ✅ Prevent duplicate displays
+- ✅ XSS protection
+
+---
+
+## 🛡️ Error Handling
+
+### Business Error Codes (BIZ_CODE)
+
+| Code | Constant | Description |
+|------|----------|-------------|
+| `0` | `SUCCESS` | Operation successful |
+| `400` | `BAD_REQUEST` | Request parameter error |
+| `401` | `UNAUTHORIZED` | Unauthorized |
+| `500` | `SERVER_ERROR` | Server error |
+| `4001` | `DAILY_LIMIT_EXCEEDED` | Daily limit exceeded |
+| `4002` | `PRODUCT_NOT_FOUND` | Product not found |
+| `4004` | `INSUFFICIENT_BALANCE` | Insufficient balance |
+| `4005` | `ORDER_NOT_FOUND` | Order not found |
+
+### Error Handling Example
+
+```typescript
+const modal = new GenericPackageModal({
+  packages: packages,
+  sdkConfig: { /* ... */ },
+
+  onPaymentFailed: (error, pkg) => {
+    // Handle limit errors
+    if (error.message.includes('Daily limit')) {
+      showErrorMessage(`Daily purchase limit reached for ${pkg.name}`);
+    } else if (error.message.includes('Lifetime limit')) {
+      showErrorMessage('This package can only be purchased once');
+    } else {
+      showErrorMessage(`Payment failed: ${error.message}`);
+    }
+  },
+});
+```
+
+---
+
+## 🧪 Test Card (Development)
+
+Test payment functionality in development environment:
+
+| Field | Value |
+|-------|-------|
+| Card Number | `4212345678910006` |
+| Expiry | `03/30` |
+| CVC | `737` |
+| 3DS Password | `password` |
+
+---
+
+## 📊 API Comparison
+
+### CreditPackageModal vs GenericPackageModal
+
+| Feature | CreditPackageModal | GenericPackageModal |
+|---------|-------------------|---------------------|
+| **Package Data** | Built-in presets | External config (flexible) |
+| **Package Types** | Standard credit packages | Any type (ice breaker/emergency/first charge/custom) |
+| **Purchase Limits** | None | Support daily/lifetime limits |
+| **Bonus Display** | None | Support bonus percentage |
+| **Configuration Complexity** | ⭐️ Simple | ⭐️⭐️ Moderate |
+| **Use Case** | Standard credit purchase | Special promotions, limited-time events |
+
+**Selection Guide**:
+- 🎯 **Standard Credit Purchase** → Use `CreditPackageModal` (recommended for beginners)
+- 🎁 **Special Promotions** → Use `GenericPackageModal`
+
+---
+
+## 🔄 Migration Guide
+
+### From v0.8.x to v0.9.x
+
+**Main Changes**: Introduced environment configuration, simplified parameters
+
+```typescript
+// ✅ New version (v0.8.x)
+const modal = new GenericPackageModal({
+  packages: packages,
+  sdkConfig: {
+    environment: 'development',  // Just specify environment
+    countryCode: 'SG',           // Flattened parameter
+    businessType: 1,             // Optional, default 1
+  },
+});
+```
+
+**Parameter Changes**:
+- ✅ Added: `environment` - auto-configure all URLs
+- ✅ Simplified: `countryCode` - flattened from `paymentMethodsParams.country_code`
+- ✅ Simplified: `businessType` - flattened from `paymentMethodsParams.business_type`
+
+---
+
+## 🌐 Framework Integration
+
+### Vue 3
+
+```vue
+<script setup lang="ts">
+import { ref } from 'vue';
+import { CreditPackageModal } from '@seaverse/payment-sdk';
+
+const showModal = () => {
+  const modal = new CreditPackageModal({
+    sdkConfig: {
+      environment: import.meta.env.DEV ? 'development' : 'production',
+      countryCode: 'SG',
+      accountToken: userToken.value,
+    },
+    onPaymentSuccess: (orderId, transactionId) => {
+      console.log('Payment successful', { orderId, transactionId });
+      // Refresh user data
+    },
+  });
+  modal.open();
+};
+</script>
+
+<template>
+  <button @click="showModal">Purchase Credits</button>
+</template>
+```
+
+### React
+
+```tsx
+import { CreditPackageModal } from '@seaverse/payment-sdk';
+
+function PurchaseButton() {
+  const handlePurchase = () => {
+    const modal = new CreditPackageModal({
+      sdkConfig: {
+        environment: process.env.NODE_ENV === 'development' ? 'development' : 'production',
+        countryCode: 'SG',
+        accountToken: getUserToken(),
+      },
+      onPaymentSuccess: (orderId, transactionId) => {
+        console.log('Payment successful', { orderId, transactionId });
+        // Refresh user data
+      },
+    });
+    modal.open();
+  };
+
+  return <button onClick={handlePurchase}>Purchase Credits</button>;
+}
+```
+
+---
+
+## 📝 TypeScript Support
+
+SDK includes complete TypeScript type definitions:
+
+```typescript
+import type {
+  // Modal related
+  CreditPackageModalOptions,
+  GenericPackageModalOptions,
+  GenericPackage,
+  PurchaseSuccessData,
+
+  // Configuration related
+  PaymentSDKConfig,
+  Environment,
+  EnvironmentConfig,
+
+  // Credit related
+  CreditDetailResponse,
+  CreditTransaction,
+  CreditPoolType,
+
+  // Subscription related
+  CurrentSubscription,
+  ActiveSubscription,
+
+  // Order related
+  OrderStatus,
+  OrderStatusResponse,
+} from '@seaverse/payment-sdk';
+```
+
+---
+
+## 🔗 Related Links
+
+- 📦 [NPM Package](https://www.npmjs.com/package/@seaverse/payment-sdk)
+- 🐙 [GitHub Repository](https://github.com/SeaVerseAI/sv-sdk)
+- 📖 [API Documentation](https://github.com/SeaVerseAI/sv-sdk/tree/main/packages/payment-sdk)
+- 🐛 [Issue Tracker](https://github.com/SeaVerseAI/sv-sdk/issues)
+
+---
+
+## 📄 License
+
+MIT License
+
+---
+
+## 🤝 Contributing
+
+Issues and Pull Requests are welcome!
+
+---
+
+**Last Updated**: 2026-01-31
+**SDK Version**: v0.8.0