@seaverse/payment-sdk 0.6.1 → 0.7.0

package/dist/index.d.ts

@@ -412,21 +412,13 @@ interface SubscriptionParams {
     firstDays?: number;
     /** 每周期金额（USD） */
     periodAmount: number;
-    /** 计费周期（可选，"month" 或 "year"） */
-    billing_period?: BillingPeriod;
 }
 /**
  * 基础结账选项
  */
 interface BaseCheckoutOptions {
-    /** 商品 ID（推荐，自动查询价格） */
-    productId?: string;
-    /** 商品名称（仅当未提供 productId 时使用） */
-    productName?: string;
-    /** 价格 USD（仅当未提供 productId 时使用） */
-    price?: number;
-    /** 额外自定义数据 */
-    extra?: Record<string, unknown>;
+    /** 商品 ID（必填，自动查询价格） */
+    productId: string;
     /** 语言设置 */
     language?: string;
     /** 用户名（显示用） */
@@ -438,6 +430,8 @@ interface BaseCheckoutOptions {
  * 一次性购买选项
  */
 interface CheckoutOptions extends BaseCheckoutOptions {
+    /** 商品名称（可选，用于支付弹窗显示） */
+    productName?: string;
     /** 支付成功回调 */
     onSuccess?: (result: PaymentResult) => void;
     /** 支付失败/取消回调 */
@@ -449,13 +443,7 @@ interface CheckoutOptions extends BaseCheckoutOptions {
  * 订阅购买选项
  */
 interface SubscribeOptions extends CheckoutOptions {
-    /** 订阅周期 */
-    period: SubscriptionPeriod;
-    /** 每期金额 */
-    periodAmount: number;
-    /** 首次扣款延迟天数（0 = 立即扣款） */
-    firstDays?: number;
-    /** 计费周期（可选，"month" 或 "year"） */
+    /** 计费周期（可选，"month" 或 "year"，默认 "month"） */
     billing_period?: BillingPeriod;
 }
 /**
@@ -468,7 +456,7 @@ interface ShowPaymentOptions {
     language?: string;
     /** 用户名 */
     userName?: string;
-    /** 商品名 */
+    /** 商品名称（可选，用于显示） */
     productName?: string;
     /** 来源标识 */
     from?: string;
@@ -481,18 +469,12 @@ interface ShowPaymentOptions {
  * SDK 结账请求
  */
 interface SDKCheckoutRequest {
-    /** 商品 ID（推荐） */
-    product_id?: string;
-    /** 商品名称 */
-    product_name?: string;
-    /** 价格（USD） */
-    price?: number;
-    /** 购买类型：1-一次性，2-订阅 */
+    /** 商品 ID（必填）*/
+    product_id: string;
+    /** 购买类型：1-一次性，2-订阅（必填） */
     purchase_type: PurchaseType;
-    /** 订阅参数（purchase_type=2 时必填） */
-    subscription?: SubscriptionParams;
-    /** 额外数据 */
-    extra?: Record<string, unknown>;
+    /** 计费周期（可选，仅订阅时使用，默认 'month'）- 用于区分月付和年付 */
+    billing_period?: BillingPeriod;
     /** 支付完成后的重定向 URL（可选） */
     redirect_url?: string;
 }
@@ -775,10 +757,7 @@ declare class CheckoutAPI {
      * 创建一次性购买订单
      */
     createOneTimeCheckout(params: {
-        productId?: string;
-        productName?: string;
-        price?: number;
-        extra?: Record<string, unknown>;
+        productId: string;
         /** 支付完成后的重定向 URL */
         redirectUrl?: string;
     }): Promise<CheckoutResult>;
@@ -786,11 +765,8 @@ declare class CheckoutAPI {
      * 创建订阅订单
      */
     createSubscriptionCheckout(params: {
-        productId?: string;
-        productName?: string;
-        price?: number;
-        subscription: SubscriptionParams;
-        extra?: Record<string, unknown>;
+        productId: string;
+        billingPeriod?: BillingPeriod;
         /** 支付完成后的重定向 URL */
         redirectUrl?: string;
     }): Promise<CheckoutResult>;
@@ -1101,7 +1077,7 @@ declare const BIZ_CODE: {
 /**
  * SDK version
  */
-declare const VERSION = "0.6.1";
+declare const VERSION = "0.7.0";
 
 export { API_ENDPOINTS, BIZ_CODE, COMPONENT_LOAD_TIMEOUT, CheckoutAPI, DEFAULT_CHECKOUT_CONFIG, ENV_CONFIG, HTTP_STATUS, PAYMENT_ELEMENT_NAME, PaymentAPIError, PaymentCheckoutClient, PaymentClient, SeaArtPayLoader, VERSION, centsToDollars, createCheckoutPaymentError, delay, dollarsToCents, formatPrice, generateOrderReference, getCurrentUrl, getGlobalLoader, getSDKLocale, isBrowser, isCheckoutPaymentError, resetGlobalLoader, safeJsonParse, withTimeout };
 export type { ApiErrorResponse, ApiResponse, ApiSuccessResponse, BaseCheckoutOptions, BillingPeriod, CheckoutAPIConfig, CheckoutAPIResponse, CheckoutClientConfig, CheckoutClientStatus, CheckoutOptions, CheckoutPaymentError, CheckoutPaymentErrorCode, CheckoutResult, ComponentLoadStatus, CreditAccount, CreditAccountStatus, CreditDetailResponse, CreditDetailSuccessResponse, CreditPoolDetail, CreditPoolType, CreditTransaction, ListTransactionsRequest, LoaderConfig, PaymentClientOptions, PaymentEnvironment, PaymentReadyEventDetail, PaymentResult, PaymentSuccessEventDetail, PaymentUnsuccessEventDetail, PaymentUnsuccessResult, PurchaseType, SDKCheckoutRequest, SDKCheckoutResponse, SDKConfig, SDKLoadStatus, SeaArtPaymentElement, ShowPaymentOptions, SubscribeOptions, SubscriptionParams, SubscriptionPeriod, TransactionListResponse, TransactionStatus, TransactionType };

package/dist/index.js

@@ -495,10 +495,7 @@ class CheckoutAPI {
     async createOneTimeCheckout(params) {
         return this.createCheckout({
             product_id: params.productId,
-            product_name: params.productName,
-            price: params.price,
             purchase_type: 1,
-            extra: params.extra,
             redirect_url: params.redirectUrl,
         });
     }
@@ -508,11 +505,8 @@ class CheckoutAPI {
     async createSubscriptionCheckout(params) {
         return this.createCheckout({
             product_id: params.productId,
-            product_name: params.productName,
-            price: params.price,
             purchase_type: 2,
-            subscription: params.subscription,
-            extra: params.extra,
+            billing_period: params.billingPeriod,
             redirect_url: params.redirectUrl,
         });
     }
@@ -561,24 +555,9 @@ class CheckoutAPI {
      * 验证请求参数
      */
     validateRequest(request) {
-        // 必须提供 productId 或 (productName + price)
-        const hasProductId = !!request.product_id;
-        const hasManualProduct = !!request.product_name && request.price != null;
-        if (!hasProductId && !hasManualProduct) {
-            throw this.createError('INVALID_PARAMS', '必须提供 productId 或 (productName + price)');
-        }
-        // 订阅类型必须提供订阅参数
-        if (request.purchase_type === 2 && !request.subscription) {
-            throw this.createError('INVALID_PARAMS', '订阅类型必须提供 subscription 参数');
-        }
-        // 验证订阅参数
-        if (request.subscription) {
-            if (!request.subscription.period) {
-                throw this.createError('INVALID_PARAMS', '订阅参数缺少 period');
-            }
-            if (request.subscription.periodAmount == null) {
-                throw this.createError('INVALID_PARAMS', '订阅参数缺少 periodAmount');
-            }
+        // 必须提供 product_id
+        if (!request.product_id) {
+            throw this.createError('INVALID_PARAMS', '必须提供 product_id');
         }
     }
     /**
@@ -767,12 +746,13 @@ class PaymentCheckoutClient {
     async checkout(options) {
         await this.ensureReady();
         this.log('发起一次性购买:', options);
+        // 验证必需参数
+        if (!options.productId) {
+            throw this.createError('INVALID_PARAMS', '缺少必需参数: productId');
+        }
         // 调用结账 API
         const result = await this.checkoutAPI.createOneTimeCheckout({
             productId: options.productId,
-            productName: options.productName,
-            price: options.price,
-            extra: options.extra,
             redirectUrl: options.redirectUrl,
         });
         // 自动打开支付弹窗
@@ -804,18 +784,14 @@ class PaymentCheckoutClient {
     async subscribe(options) {
         await this.ensureReady();
         this.log('发起订阅购买:', options);
+        // 验证必需参数
+        if (!options.productId) {
+            throw this.createError('INVALID_PARAMS', '缺少必需参数: productId');
+        }
         // 调用结账 API
         const result = await this.checkoutAPI.createSubscriptionCheckout({
             productId: options.productId,
-            productName: options.productName,
-            price: options.price,
-            subscription: {
-                period: options.period,
-                periodAmount: options.periodAmount,
-                firstDays: options.firstDays ?? 0,
-                billing_period: options.billing_period,
-            },
-            extra: options.extra,
+            billingPeriod: options.billing_period,
             redirectUrl: options.redirectUrl,
         });
         // 自动打开支付弹窗
@@ -1167,7 +1143,7 @@ function getSDKLocale(locale) {
 /**
  * SDK version
  */
-const VERSION$2 = '0.6.1';
+const VERSION$2 = '0.7.0';
 
 var __defProp = Object.defineProperty;
 var __defProps = Object.defineProperties;