@waffo/waffo-node 3.0.1 → 3.2.0

package/README.md

@@ -1,6 +1,6 @@
 # Waffo Node.js SDK
 
-<!-- Synced with waffo-sdk/README.md @ commit 0e59bbc -->
+<!-- Synced with waffo-sdk/README.md @ commit 9405bd4 -->
 
 **English** | [中文](README_CN.md)
 
@@ -58,6 +58,7 @@ Official Node.js/TypeScript SDK for [Waffo Payment Platform](https://www.waffo.c
 - [Support](#support)
 - [License](#license)
 - [Development & Testing](#development-testing)
+- [Open Business Values and Custom Events](#open-business-values-and-custom-events)
 
 ## Requirements
 
@@ -527,6 +528,41 @@ if (response.isSuccess()) {
 }
 ```
 
+<!-- sdk-sync:start:Update%20Subscription -->
+#### Update Subscription
+
+Update the billing amounts of an active subscription without re-authorization. Provide `subscriptionRequest` or `subscriptionId`. To charge a seat add-on immediately, include `topupInfo`; the updated billing amounts take effect from the next billing period.
+
+```typescript
+const response = await waffo.subscription().update({
+  subscriptionId: 'subscription_id',
+  amount: '129.00',  // New per-period amount from the next billing period
+  productInfo: {
+    trialPeriodAmount: '0',
+    scheduledAmounts: [
+      { period: '2', amount: '99.00' },   // Per-period override
+      { period: '3', amount: '129.00' },
+    ],
+  },
+  topupInfo: {
+    topupRequest: 'mimo-topup-001', // Idempotency key for this top-up
+    topupAmount: '30.00',           // Amount charged immediately
+    description: 'Seat add-on 3 seats',
+    orderExpiredAt: '2030-01-01T00:00:00Z',
+  },
+});
+
+if (response.isSuccess()) {
+  const data = response.getData();
+  console.log('Previous Amount:', data.previousAmount);
+  console.log('New Amount:', data.newAmount);
+  console.log('Next Effective Period:', data.nextEffectivePeriod);
+  console.log('Top-up Order:', data.topupInfo?.acquiringOrderId);
+  console.log('Top-up Status:', data.topupInfo?.topupStatus);
+}
+```
+<!-- sdk-sync:end:Update%20Subscription -->
+
 ### Subscription Change (Upgrade/Downgrade)
 
 Change an existing subscription to a new plan (upgrade or downgrade).
@@ -963,6 +999,7 @@ These two notification types share the same payload structure:
 }
 ```
 
+<!-- sdk-sync:start:Payment%20Method%20Types -->
 ## Payment Method Types
 
 ### payMethodType Reference
@@ -978,31 +1015,32 @@ These two notification types share the same payload structure:
 
 ### Usage Examples
 
-```typescript
-// Specify type only, let user choose on checkout page
-paymentInfo: {
-  payMethodType: 'CREDITCARD',
-}
+Specify a type and let the user choose on the checkout page:
 
-// Specify exact payment method
-paymentInfo: {
-  payMethodType: 'CREDITCARD',
-  payMethodName: 'CC_VISA',
-}
+```json
+{"paymentInfo": {"payMethodType": "CREDITCARD"}}
+```
 
-// Combine multiple types
-paymentInfo: {
-  payMethodType: 'CREDITCARD,DEBITCARD',
-}
+Specify an exact payment method:
 
-// E-wallet with specific channel
-paymentInfo: {
-  payMethodType: 'EWALLET',
-  payMethodName: 'GCASH',
-}
+```json
+{"paymentInfo": {"payMethodType": "CREDITCARD", "payMethodName": "CC_VISA"}}
+```
+
+Combine multiple types:
+
+```json
+{"paymentInfo": {"payMethodType": "CREDITCARD,DEBITCARD"}}
+```
+
+Select an e-wallet channel:
+
+```json
+{"paymentInfo": {"payMethodType": "EWALLET", "payMethodName": "GCASH"}}
 ```
 
 > **Note**: For available `ProductName`, `PayMethodType`, `PayMethodName` values, merchants can log in to [Waffo Portal](https://dashboard.waffo.com) to view contracted payment methods (Home → Service → Pay-in).
+<!-- sdk-sync:end:Payment%20Method%20Types -->
 
 ## Advanced Configuration
 
@@ -1171,6 +1209,60 @@ const signature = RsaUtils.sign(data, privateKey);
 const isValid = RsaUtils.verify(data, signature, publicKey);
 ```
 
+<!-- sdk-sync:start:Open%20Business%20Values%20and%20Custom%20Events -->
+## Open Business Values and Custom Events
+
+Business fields accept arbitrary strings and preserve their original value, including new statuses, currencies, products, periods and actions. The known constants are convenience values. A parsed response or a successful API code does not establish payment success; compare the relevant business status explicitly.
+
+### Read protocol values without changing existing calls
+
+These offline examples show the real SDK model/accessor APIs. `FUTURE_STATUS` is synthetic and does not declare server support. Parsing or API code success does not establish business success.
+
+```typescript
+// Existing aliases/getData stay compatible; getData can contain future strings.
+// getOpenData/OpenBusinessValues opt into open strings: handle a default branch.
+// create/change preserve required fields; concrete eventType types stay fixed.
+import { ApiResponse, type InquirySubscriptionData } from '@waffo/waffo-node';
+
+const source = JSON.parse('{"subscriptionStatus":"ACTIVE","paymentDetails":[{"orderStatus":"INIT"}]}');
+const response = ApiResponse.success<InquirySubscriptionData>(source);
+const data = response.getOpenData();
+console.log(data?.subscriptionStatus, data?.paymentDetails?.[0]?.orderStatus);
+if (data?.subscriptionStatus === 'FUTURE_STATUS') {
+  console.warn('Unsupported business status:', data.subscriptionStatus);
+}
+```
+
+`WebhookEventType` and concrete built-in notification types remain the known event catalogue. Unknown events return a signed failure unless your application registers that exact name. Register before serving callbacks; custom registrations are per instance, case-sensitive, and a later registration replaces the same name. Built-in names use their dedicated methods. Blank names and invalid callbacks/configuration fail at registration with `S0006`; PHP rejects non-callable arguments with its native `TypeError`.
+
+Java, Python and PHP custom callbacks must complete synchronously; PHP Promise/generator callbacks are unsupported. Python rejects async functions at registration and returns failure for an unexpected awaitable result. Node.js explicitly supports Promise callbacks.
+
+The examples below take the **raw, unmodified UTF-8 body file** as their first argument and `WAFFO_WEBHOOK_SIGNATURE` as the request signature. Set `WAFFO_API_KEY`, `WAFFO_PRIVATE_KEY`, `WAFFO_PUBLIC_KEY` and Java/Python's `WAFFO_MERCHANT_ID` using your authorized configuration. They print the signed response header/body; in your HTTP adapter send those bytes with HTTP 200 and the `X-SIGNATURE` header. `EXAMPLE_CUSTOM_NOTIFICATION` is an offline example name: replace it and implement your business action against the event's real contract. Reject/throw/return an error if processing fails; Node.js awaits the callback, and Go converts callback errors or panics into failure responses.
+
+```typescript
+import { readFileSync } from 'node:fs';
+import { WebhookHandler, Environment } from '@waffo/waffo-node';
+
+async function main() {
+  const handler = new WebhookHandler({
+    apiKey: process.env.WAFFO_API_KEY!,
+    privateKey: process.env.WAFFO_PRIVATE_KEY!,
+    waffoPublicKey: process.env.WAFFO_PUBLIC_KEY!,
+    environment: Environment.SANDBOX,
+  }).onEvent('EXAMPLE_CUSTOM_NOTIFICATION', async notification => {
+    // Validate the event's documented fields and perform your business action here.
+    console.error('Handled custom event:', notification.eventType);
+  });
+  const body = readFileSync(process.argv[2], 'utf8');
+  const result = await handler.handleWebhook(body, process.env.WAFFO_WEBHOOK_SIGNATURE ?? '');
+  if (!result.success) console.error(result.error);
+  console.log('X-SIGNATURE: ' + result.responseSignature);
+  console.log(result.responseBody);
+}
+main().catch(error => { console.error(error); process.exitCode = 1; });
+```
+<!-- sdk-sync:end:Open%20Business%20Values%20and%20Custom%20Events -->
+
 ## Handling New API Fields (ExtraParams)
 
 When Waffo API adds new fields that are not yet defined in the SDK, you can use the ExtraParams feature to access these fields without waiting for an SDK update.

package/dist/index.d.mts

@@ -371,6 +371,20 @@ interface SubscriptionUpdateProductInfo {
     scheduledAmounts?: SubscriptionScheduledAmount[];
     [key: string]: unknown;
 }
+/**
+ * Seat add-on top-up information for a subscription update.
+ */
+interface SubscriptionUpdateTopupInfo {
+    /** Idempotency key for this top-up. */
+    topupRequest?: string;
+    /** Top-up amount charged for the current period. */
+    topupAmount?: string;
+    /** Description shown on cashier and billing. */
+    description?: string;
+    /** Cashier session expiry time in ISO 8601 format. */
+    orderExpiredAt?: string;
+    [key: string]: unknown;
+}
 /**
  * Update subscription request parameters.
  */
@@ -392,6 +406,26 @@ interface UpdateSubscriptionParams {
      * Product information containing trial or scheduled amount updates.
      */
     productInfo?: SubscriptionUpdateProductInfo;
+    /**
+     * Seat add-on top-up information.
+     */
+    topupInfo?: SubscriptionUpdateTopupInfo;
+    [key: string]: unknown;
+}
+/**
+ * Seat add-on top-up result returned by subscription update.
+ */
+interface SubscriptionUpdateTopupData {
+    /** Waffo acquiring order ID for the top-up charge. */
+    acquiringOrderId?: string;
+    /** Idempotency key echoed from the request. */
+    topupRequest?: string;
+    /** Top-up amount charged for the current period. */
+    topupAmount?: string;
+    /** Top-up charge order status. */
+    topupStatus?: string;
+    /** Structured order action used to redirect the user to cashier. */
+    topupAction?: string;
     [key: string]: unknown;
 }
 /**
@@ -434,6 +468,10 @@ interface UpdateSubscriptionData {
      * The next period number when the new amount takes effect.
      */
     nextEffectivePeriod?: string;
+    /**
+     * Seat add-on top-up result when the request carries topupInfo.
+     */
+    topupInfo?: SubscriptionUpdateTopupData;
     [key: string]: unknown;
 }
 /**
@@ -1569,6 +1607,7 @@ declare class WebhookHandler {
     private subscriptionPaymentHandler?;
     private subscriptionPeriodChangedHandler?;
     private subscriptionChangeHandler?;
+    private readonly customEventHandlers;
     constructor(config: WaffoConfig);
     /**
      * Registers a handler for payment notifications.
@@ -1595,6 +1634,8 @@ declare class WebhookHandler {
      * Registers a handler for subscription change notifications.
      */
     onSubscriptionChange(handler: SubscriptionChangeHandler): this;
+    /** Registers an exact custom event name before receiving webhooks. Later registration replaces the same name. */
+    onEvent(eventType: string, handler: (notification: BaseNotification & Record<string, unknown>) => void | Promise<void>): this;
     /**
      * Processes a webhook notification.
      *
@@ -1629,6 +1670,11 @@ declare class WebhookHandler {
     private createFailedResult;
 }
 
+/** Optional view for JSON business data that preserves future protocol strings. */
+type OpenBusinessValues<T> = T extends string ? string : T extends object ? {
+    [K in keyof T]: K extends 'eventType' ? T[K] : OpenBusinessValues<T[K]>;
+} : T;
+
 /**
  * Generic API response wrapper.
  *
@@ -1679,6 +1725,8 @@ declare class ApiResponse<T> {
      * @returns The response data, or undefined if the response is an error
      */
     getData(): T | undefined;
+    /** Returns the same JSON data with business string literals opened to future values. */
+    getOpenData(): OpenBusinessValues<T> | undefined;
     /**
      * Gets the error message.
      *
@@ -1700,6 +1748,7 @@ declare class ApiResponse<T> {
     getDataOrThrow(): T;
 }
 
+type MerchantIdPath = 'merchantInfo.merchantId' | 'merchantId' | null;
 /**
  * HTTP client for making requests to the Waffo API.
  *
@@ -1726,10 +1775,11 @@ declare class WaffoHttpClient {
      * @param path - API endpoint path (e.g., "/order/create")
      * @param request - Request body
      * @param options - Per-request options
+     * @param merchantIdPath - Contract path for merchantId, null for no injection, or omitted for legacy inference
      * @returns API response
      * @throws WaffoUnknownStatusError for network errors or unknown status
      */
-    post<T extends object, R>(path: string, request: T, options?: RequestOptions): Promise<ApiResponse<R>>;
+    post<T extends object, R>(path: string, request: T, options?: RequestOptions, merchantIdPath?: MerchantIdPath): Promise<ApiResponse<R>>;
     /**
      * Parses the API response body.
      */
@@ -1889,6 +1939,7 @@ declare class SubscriptionResource extends BaseResource {
      * @returns API response with subscription data
      * @throws WaffoUnknownStatusError for network errors
      */
+    create(params: OpenBusinessValues<CreateSubscriptionParams>, options?: RequestOptions): Promise<ApiResponse<CreateSubscriptionData>>;
     create(params: CreateSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<CreateSubscriptionData>>;
     /**
      * Queries an existing subscription.
@@ -1970,6 +2021,7 @@ declare class SubscriptionResource extends BaseResource {
      * }
      * ```
      */
+    change(params: OpenBusinessValues<SubscriptionChangeParams>, options?: RequestOptions): Promise<ApiResponse<SubscriptionChangeData>>;
     change(params: SubscriptionChangeParams, options?: RequestOptions): Promise<ApiResponse<SubscriptionChangeData>>;
     /**
      * Queries the status of a subscription change.
@@ -2618,4 +2670,4 @@ declare const RsaUtils: {
     generateKeyPair: typeof generateKeyPair;
 };
 
-export { type AddressInfo, ApiResponse, type BaseNotification, type CancelOrderData, type CancelOrderParams, type CancelSubscriptionData, type CancelSubscriptionParams, type CaptureOrderData, type CaptureOrderParams, type CardInfo, type CreateOrderData, type CreateOrderParams, type CreateSubscriptionData, type CreateSubscriptionParams, Environment, EnvironmentBaseUrl, type FixedMaintenanceRule, type GoodsInfo, type HttpRequest, type HttpResponse, type HttpTransport, type InquiryMerchantConfigData, type InquiryMerchantConfigParams, type InquiryOrderData, type InquiryOrderParams, type InquiryPayMethodConfigData, type InquiryPayMethodConfigParams, type InquiryRefundData, type InquiryRefundParams, type InquirySubscriptionData, type InquirySubscriptionParams, type ManageSubscriptionData, type ManageSubscriptionParams, MerchantConfigResource, type MerchantInfo, OrderResource, type OrderStatus, PayMethodConfigResource, type PayMethodDetail, type PayMethodInfo, type PaymentInfo, type PaymentNotification, type PaymentNotificationResult, type PeriodType, type ProductInfo, type PromotionInfo, type RefundNotification, type RefundNotificationResult, type RefundOrderData, type RefundOrderParams, RefundResource, type RefundStatus$1 as RefundStatus, type RefundUserInfo, type RequestOptions, type RiskData, RsaUtils, type SubscriptionChangeData, type SubscriptionChangeInquiryData, type SubscriptionChangeInquiryParams, type SubscriptionChangeParams, type SubscriptionChangeProductInfo, type SubscriptionChangeStatus, type SubscriptionInfo, type SubscriptionManageAction, type SubscriptionMerchantInfo, type SubscriptionNotificationResult, type SubscriptionPaymentDetail, type SubscriptionPaymentInfo, type SubscriptionPeriodChangedNotification, type SubscriptionPromotionInfo, SubscriptionResource, type SubscriptionScheduledAmount, type SubscriptionStatus, type SubscriptionStatusNotification, type SubscriptionUpdateProductInfo, type SubscriptionUserInfo, type UpdateSubscriptionData, type UpdateSubscriptionParams, type UserInfo, Waffo, type WaffoConfig, WaffoConfigDefaults, WaffoError, WaffoErrorCode, WaffoHttpClient, type WaffoLogger, WaffoUnknownStatusError, type WalletInquiryData, type WalletInquiryParams, WalletResource, WebhookEventType, WebhookHandler, type WebhookResult, type X402Info };
+export { type AddressInfo, ApiResponse, type BaseNotification, type CancelOrderData, type CancelOrderParams, type CancelSubscriptionData, type CancelSubscriptionParams, type CaptureOrderData, type CaptureOrderParams, type CardInfo, type CreateOrderData, type CreateOrderParams, type CreateSubscriptionData, type CreateSubscriptionParams, Environment, EnvironmentBaseUrl, type FixedMaintenanceRule, type GoodsInfo, type HttpRequest, type HttpResponse, type HttpTransport, type InquiryMerchantConfigData, type InquiryMerchantConfigParams, type InquiryOrderData, type InquiryOrderParams, type InquiryPayMethodConfigData, type InquiryPayMethodConfigParams, type InquiryRefundData, type InquiryRefundParams, type InquirySubscriptionData, type InquirySubscriptionParams, type ManageSubscriptionData, type ManageSubscriptionParams, MerchantConfigResource, type MerchantInfo, type OpenBusinessValues, OrderResource, type OrderStatus, PayMethodConfigResource, type PayMethodDetail, type PayMethodInfo, type PaymentInfo, type PaymentNotification, type PaymentNotificationResult, type PeriodType, type ProductInfo, type PromotionInfo, type RefundNotification, type RefundNotificationResult, type RefundOrderData, type RefundOrderParams, RefundResource, type RefundStatus$1 as RefundStatus, type RefundUserInfo, type RequestOptions, type RiskData, RsaUtils, type SubscriptionChangeData, type SubscriptionChangeInquiryData, type SubscriptionChangeInquiryParams, type SubscriptionChangeParams, type SubscriptionChangeProductInfo, type SubscriptionChangeStatus, type SubscriptionInfo, type SubscriptionManageAction, type SubscriptionMerchantInfo, type SubscriptionNotificationResult, type SubscriptionPaymentDetail, type SubscriptionPaymentInfo, type SubscriptionPeriodChangedNotification, type SubscriptionPromotionInfo, SubscriptionResource, type SubscriptionScheduledAmount, type SubscriptionStatus, type SubscriptionStatusNotification, type SubscriptionUpdateProductInfo, type SubscriptionUpdateTopupData, type SubscriptionUpdateTopupInfo, type SubscriptionUserInfo, type UpdateSubscriptionData, type UpdateSubscriptionParams, type UserInfo, Waffo, type WaffoConfig, WaffoConfigDefaults, WaffoError, WaffoErrorCode, WaffoHttpClient, type WaffoLogger, WaffoUnknownStatusError, type WalletInquiryData, type WalletInquiryParams, WalletResource, WebhookEventType, WebhookHandler, type WebhookResult, type X402Info };

package/dist/index.d.ts

@@ -371,6 +371,20 @@ interface SubscriptionUpdateProductInfo {
     scheduledAmounts?: SubscriptionScheduledAmount[];
     [key: string]: unknown;
 }
+/**
+ * Seat add-on top-up information for a subscription update.
+ */
+interface SubscriptionUpdateTopupInfo {
+    /** Idempotency key for this top-up. */
+    topupRequest?: string;
+    /** Top-up amount charged for the current period. */
+    topupAmount?: string;
+    /** Description shown on cashier and billing. */
+    description?: string;
+    /** Cashier session expiry time in ISO 8601 format. */
+    orderExpiredAt?: string;
+    [key: string]: unknown;
+}
 /**
  * Update subscription request parameters.
  */
@@ -392,6 +406,26 @@ interface UpdateSubscriptionParams {
      * Product information containing trial or scheduled amount updates.
      */
     productInfo?: SubscriptionUpdateProductInfo;
+    /**
+     * Seat add-on top-up information.
+     */
+    topupInfo?: SubscriptionUpdateTopupInfo;
+    [key: string]: unknown;
+}
+/**
+ * Seat add-on top-up result returned by subscription update.
+ */
+interface SubscriptionUpdateTopupData {
+    /** Waffo acquiring order ID for the top-up charge. */
+    acquiringOrderId?: string;
+    /** Idempotency key echoed from the request. */
+    topupRequest?: string;
+    /** Top-up amount charged for the current period. */
+    topupAmount?: string;
+    /** Top-up charge order status. */
+    topupStatus?: string;
+    /** Structured order action used to redirect the user to cashier. */
+    topupAction?: string;
     [key: string]: unknown;
 }
 /**
@@ -434,6 +468,10 @@ interface UpdateSubscriptionData {
      * The next period number when the new amount takes effect.
      */
     nextEffectivePeriod?: string;
+    /**
+     * Seat add-on top-up result when the request carries topupInfo.
+     */
+    topupInfo?: SubscriptionUpdateTopupData;
     [key: string]: unknown;
 }
 /**
@@ -1569,6 +1607,7 @@ declare class WebhookHandler {
     private subscriptionPaymentHandler?;
     private subscriptionPeriodChangedHandler?;
     private subscriptionChangeHandler?;
+    private readonly customEventHandlers;
     constructor(config: WaffoConfig);
     /**
      * Registers a handler for payment notifications.
@@ -1595,6 +1634,8 @@ declare class WebhookHandler {
      * Registers a handler for subscription change notifications.
      */
     onSubscriptionChange(handler: SubscriptionChangeHandler): this;
+    /** Registers an exact custom event name before receiving webhooks. Later registration replaces the same name. */
+    onEvent(eventType: string, handler: (notification: BaseNotification & Record<string, unknown>) => void | Promise<void>): this;
     /**
      * Processes a webhook notification.
      *
@@ -1629,6 +1670,11 @@ declare class WebhookHandler {
     private createFailedResult;
 }
 
+/** Optional view for JSON business data that preserves future protocol strings. */
+type OpenBusinessValues<T> = T extends string ? string : T extends object ? {
+    [K in keyof T]: K extends 'eventType' ? T[K] : OpenBusinessValues<T[K]>;
+} : T;
+
 /**
  * Generic API response wrapper.
  *
@@ -1679,6 +1725,8 @@ declare class ApiResponse<T> {
      * @returns The response data, or undefined if the response is an error
      */
     getData(): T | undefined;
+    /** Returns the same JSON data with business string literals opened to future values. */
+    getOpenData(): OpenBusinessValues<T> | undefined;
     /**
      * Gets the error message.
      *
@@ -1700,6 +1748,7 @@ declare class ApiResponse<T> {
     getDataOrThrow(): T;
 }
 
+type MerchantIdPath = 'merchantInfo.merchantId' | 'merchantId' | null;
 /**
  * HTTP client for making requests to the Waffo API.
  *
@@ -1726,10 +1775,11 @@ declare class WaffoHttpClient {
      * @param path - API endpoint path (e.g., "/order/create")
      * @param request - Request body
      * @param options - Per-request options
+     * @param merchantIdPath - Contract path for merchantId, null for no injection, or omitted for legacy inference
      * @returns API response
      * @throws WaffoUnknownStatusError for network errors or unknown status
      */
-    post<T extends object, R>(path: string, request: T, options?: RequestOptions): Promise<ApiResponse<R>>;
+    post<T extends object, R>(path: string, request: T, options?: RequestOptions, merchantIdPath?: MerchantIdPath): Promise<ApiResponse<R>>;
     /**
      * Parses the API response body.
      */
@@ -1889,6 +1939,7 @@ declare class SubscriptionResource extends BaseResource {
      * @returns API response with subscription data
      * @throws WaffoUnknownStatusError for network errors
      */
+    create(params: OpenBusinessValues<CreateSubscriptionParams>, options?: RequestOptions): Promise<ApiResponse<CreateSubscriptionData>>;
     create(params: CreateSubscriptionParams, options?: RequestOptions): Promise<ApiResponse<CreateSubscriptionData>>;
     /**
      * Queries an existing subscription.
@@ -1970,6 +2021,7 @@ declare class SubscriptionResource extends BaseResource {
      * }
      * ```
      */
+    change(params: OpenBusinessValues<SubscriptionChangeParams>, options?: RequestOptions): Promise<ApiResponse<SubscriptionChangeData>>;
     change(params: SubscriptionChangeParams, options?: RequestOptions): Promise<ApiResponse<SubscriptionChangeData>>;
     /**
      * Queries the status of a subscription change.
@@ -2618,4 +2670,4 @@ declare const RsaUtils: {
     generateKeyPair: typeof generateKeyPair;
 };
 
-export { type AddressInfo, ApiResponse, type BaseNotification, type CancelOrderData, type CancelOrderParams, type CancelSubscriptionData, type CancelSubscriptionParams, type CaptureOrderData, type CaptureOrderParams, type CardInfo, type CreateOrderData, type CreateOrderParams, type CreateSubscriptionData, type CreateSubscriptionParams, Environment, EnvironmentBaseUrl, type FixedMaintenanceRule, type GoodsInfo, type HttpRequest, type HttpResponse, type HttpTransport, type InquiryMerchantConfigData, type InquiryMerchantConfigParams, type InquiryOrderData, type InquiryOrderParams, type InquiryPayMethodConfigData, type InquiryPayMethodConfigParams, type InquiryRefundData, type InquiryRefundParams, type InquirySubscriptionData, type InquirySubscriptionParams, type ManageSubscriptionData, type ManageSubscriptionParams, MerchantConfigResource, type MerchantInfo, OrderResource, type OrderStatus, PayMethodConfigResource, type PayMethodDetail, type PayMethodInfo, type PaymentInfo, type PaymentNotification, type PaymentNotificationResult, type PeriodType, type ProductInfo, type PromotionInfo, type RefundNotification, type RefundNotificationResult, type RefundOrderData, type RefundOrderParams, RefundResource, type RefundStatus$1 as RefundStatus, type RefundUserInfo, type RequestOptions, type RiskData, RsaUtils, type SubscriptionChangeData, type SubscriptionChangeInquiryData, type SubscriptionChangeInquiryParams, type SubscriptionChangeParams, type SubscriptionChangeProductInfo, type SubscriptionChangeStatus, type SubscriptionInfo, type SubscriptionManageAction, type SubscriptionMerchantInfo, type SubscriptionNotificationResult, type SubscriptionPaymentDetail, type SubscriptionPaymentInfo, type SubscriptionPeriodChangedNotification, type SubscriptionPromotionInfo, SubscriptionResource, type SubscriptionScheduledAmount, type SubscriptionStatus, type SubscriptionStatusNotification, type SubscriptionUpdateProductInfo, type SubscriptionUserInfo, type UpdateSubscriptionData, type UpdateSubscriptionParams, type UserInfo, Waffo, type WaffoConfig, WaffoConfigDefaults, WaffoError, WaffoErrorCode, WaffoHttpClient, type WaffoLogger, WaffoUnknownStatusError, type WalletInquiryData, type WalletInquiryParams, WalletResource, WebhookEventType, WebhookHandler, type WebhookResult, type X402Info };
+export { type AddressInfo, ApiResponse, type BaseNotification, type CancelOrderData, type CancelOrderParams, type CancelSubscriptionData, type CancelSubscriptionParams, type CaptureOrderData, type CaptureOrderParams, type CardInfo, type CreateOrderData, type CreateOrderParams, type CreateSubscriptionData, type CreateSubscriptionParams, Environment, EnvironmentBaseUrl, type FixedMaintenanceRule, type GoodsInfo, type HttpRequest, type HttpResponse, type HttpTransport, type InquiryMerchantConfigData, type InquiryMerchantConfigParams, type InquiryOrderData, type InquiryOrderParams, type InquiryPayMethodConfigData, type InquiryPayMethodConfigParams, type InquiryRefundData, type InquiryRefundParams, type InquirySubscriptionData, type InquirySubscriptionParams, type ManageSubscriptionData, type ManageSubscriptionParams, MerchantConfigResource, type MerchantInfo, type OpenBusinessValues, OrderResource, type OrderStatus, PayMethodConfigResource, type PayMethodDetail, type PayMethodInfo, type PaymentInfo, type PaymentNotification, type PaymentNotificationResult, type PeriodType, type ProductInfo, type PromotionInfo, type RefundNotification, type RefundNotificationResult, type RefundOrderData, type RefundOrderParams, RefundResource, type RefundStatus$1 as RefundStatus, type RefundUserInfo, type RequestOptions, type RiskData, RsaUtils, type SubscriptionChangeData, type SubscriptionChangeInquiryData, type SubscriptionChangeInquiryParams, type SubscriptionChangeParams, type SubscriptionChangeProductInfo, type SubscriptionChangeStatus, type SubscriptionInfo, type SubscriptionManageAction, type SubscriptionMerchantInfo, type SubscriptionNotificationResult, type SubscriptionPaymentDetail, type SubscriptionPaymentInfo, type SubscriptionPeriodChangedNotification, type SubscriptionPromotionInfo, SubscriptionResource, type SubscriptionScheduledAmount, type SubscriptionStatus, type SubscriptionStatusNotification, type SubscriptionUpdateProductInfo, type SubscriptionUpdateTopupData, type SubscriptionUpdateTopupInfo, type SubscriptionUserInfo, type UpdateSubscriptionData, type UpdateSubscriptionParams, type UserInfo, Waffo, type WaffoConfig, WaffoConfigDefaults, WaffoError, WaffoErrorCode, WaffoHttpClient, type WaffoLogger, WaffoUnknownStatusError, type WalletInquiryData, type WalletInquiryParams, WalletResource, WebhookEventType, WebhookHandler, type WebhookResult, type X402Info };