@waffo/waffo-node 2.2.0 → 2.3.0

package/dist/index.d.ts

@@ -170,1230 +170,1283 @@ interface RequestOptions {
 }
 
 /**
- * Webhook event types sent by Waffo.
- */
-declare enum WebhookEventType {
-    PAYMENT_NOTIFICATION = "PAYMENT_NOTIFICATION",
-    REFUND_NOTIFICATION = "REFUND_NOTIFICATION",
-    SUBSCRIPTION_STATUS_NOTIFICATION = "SUBSCRIPTION_STATUS_NOTIFICATION",
-    SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION"
-}
-/**
- * Result of webhook handling.
+ * Subscription-related type definitions.
+ *
+ * Note: Full type definitions should be generated from openapi.json.
+ * These are placeholder interfaces for the SDK structure.
  */
-interface WebhookResult {
-    /** Whether the webhook was processed successfully */
-    success: boolean;
-    /** Response body to send back to Waffo */
-    responseBody: string;
-    /** Signature for the response body */
-    responseSignature: string;
-    /** Error message if processing failed */
-    error?: string;
-}
 /**
- * Base notification interface.
+ * Create subscription request parameters.
  */
-interface BaseNotification {
-    eventType: string;
+interface CreateSubscriptionParams {
+    /**
+     * Subscription request ID sent from Merchant (max 32 characters).
+     * Used for idempotent check.
+     */
+    subscriptionRequest: string;
+    merchantSubscriptionId: string;
+    currency: string;
+    amount: string;
+    notifyUrl: string;
+    productInfo: ProductInfo;
+    userInfo: SubscriptionUserInfo;
+    paymentInfo: SubscriptionPaymentInfo;
+    merchantInfo?: SubscriptionMerchantInfo;
+    goodsInfo?: {
+        goodsId: string;
+        goodsName: string;
+        goodsCategory?: string;
+        goodsUrl?: string;
+        goodsQuantity?: number;
+        [key: string]: unknown;
+    };
+    successRedirectUrl?: string;
+    failedRedirectUrl?: string;
+    cancelRedirectUrl?: string;
+    subscriptionManagementUrl?: string;
+    requestedAt?: string;
+    extendInfo?: string;
+    /**
+     * Order expiry time (ISO 8601 format, max 24 characters).
+     */
+    orderExpiredAt?: string;
+    [key: string]: unknown;
 }
 /**
- * Payment notification result payload (21 fields).
+ * Create subscription response data.
  */
-interface PaymentNotificationResult {
-    paymentRequestId?: string;
-    merchantOrderId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: string;
-    orderAction?: string;
-    orderCurrency?: string;
-    orderAmount?: string;
-    userCurrency?: string;
-    finalDealAmount?: string;
-    orderDescription?: string;
-    merchantInfo?: Record<string, unknown>;
-    userInfo?: Record<string, unknown>;
-    goodsInfo?: Record<string, unknown>;
-    addressInfo?: Record<string, unknown>;
-    paymentInfo?: Record<string, unknown>;
-    orderRequestedAt?: string;
-    orderExpiredAt?: string;
-    orderUpdatedAt?: string;
-    orderCompletedAt?: string;
-    orderFailedReason?: Record<string, unknown>;
-    extendInfo?: string;
+interface CreateSubscriptionData {
+    subscriptionRequest?: string;
+    merchantSubscriptionId?: string;
+    subscriptionId?: string;
+    subscriptionStatus?: SubscriptionStatus;
+    subscriptionAction?: string;
     [key: string]: unknown;
 }
 /**
- * Refund notification result payload (17 fields).
+ * Inquiry subscription request parameters.
  */
-interface RefundNotificationResult {
-    refundRequestId?: string;
-    merchantRefundOrderId?: string;
-    acquiringOrderId?: string;
-    acquiringRefundOrderId?: string;
-    origPaymentRequestId?: string;
-    refundAmount?: string;
-    refundStatus?: string;
-    remainingRefundAmount?: string;
-    userCurrency?: string;
-    finalDealAmount?: string;
-    refundReason?: string;
-    refundRequestedAt?: string;
-    refundUpdatedAt?: string;
-    refundCompletedAt?: string;
-    refundFailedReason?: Record<string, unknown>;
-    userInfo?: Record<string, unknown>;
-    extendInfo?: string;
+interface InquirySubscriptionParams {
+    subscriptionRequest?: string;
+    subscriptionId?: string;
+    merchantInfo?: SubscriptionMerchantInfo;
     [key: string]: unknown;
 }
 /**
- * Subscription notification result payload (20 fields).
- * Shared by SubscriptionStatusNotification and SubscriptionPeriodChangedNotification.
+ * Inquiry subscription response data.
  */
-interface SubscriptionNotificationResult {
+interface InquirySubscriptionData {
     subscriptionRequest?: string;
     merchantSubscriptionId?: string;
     subscriptionId?: string;
-    subscriptionStatus?: string;
+    payMethodSubscriptionId?: string;
+    subscriptionStatus?: SubscriptionStatus;
     subscriptionAction?: string;
     currency?: string;
-    amount?: string;
     userCurrency?: string;
-    productInfo?: Record<string, unknown>;
-    merchantInfo?: Record<string, unknown>;
-    userInfo?: Record<string, unknown>;
-    goodsInfo?: Record<string, unknown>;
-    addressInfo?: Record<string, unknown>;
-    paymentInfo?: Record<string, unknown>;
-    requestedAt?: string;
-    updatedAt?: string;
-    failedReason?: Record<string, unknown>;
-    extendInfo?: string;
-    subscriptionManagementUrl?: string;
-    paymentDetails?: Record<string, unknown>[];
+    amount?: string;
+    productInfo?: ProductInfo;
     [key: string]: unknown;
 }
 /**
- * Payment notification from Waffo.
+ * Cancel subscription request parameters.
  */
-interface PaymentNotification extends BaseNotification {
-    eventType: 'PAYMENT_NOTIFICATION';
-    result?: PaymentNotificationResult;
+interface CancelSubscriptionParams {
+    subscriptionId?: string;
+    merchantId?: string;
+    requestedAt?: string;
     [key: string]: unknown;
 }
 /**
- * Refund notification from Waffo.
+ * Cancel subscription response data.
  */
-interface RefundNotification extends BaseNotification {
-    eventType: 'REFUND_NOTIFICATION';
-    result?: RefundNotificationResult;
+interface CancelSubscriptionData {
+    subscriptionRequest?: string;
+    merchantSubscriptionId?: string;
+    subscriptionId?: string;
+    subscriptionStatus?: SubscriptionStatus;
     [key: string]: unknown;
 }
 /**
- * Subscription status notification from Waffo.
+ * Manage subscription request parameters.
  */
-interface SubscriptionStatusNotification extends BaseNotification {
-    eventType: 'SUBSCRIPTION_STATUS_NOTIFICATION';
-    result?: SubscriptionNotificationResult;
+interface ManageSubscriptionParams {
+    subscriptionId: string;
+    merchantId: string;
+    action: SubscriptionManageAction;
+    newAmount?: string;
+    newPeriodType?: PeriodType;
+    newPeriodValue?: number;
+    requestedAt?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription period changed notification from Waffo.
+ * Manage subscription response data.
  */
-interface SubscriptionPeriodChangedNotification extends BaseNotification {
-    eventType: 'SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION';
-    result?: SubscriptionNotificationResult;
+interface ManageSubscriptionData {
+    subscriptionId?: string;
+    subscriptionStatus?: SubscriptionStatus;
     [key: string]: unknown;
 }
-type PaymentHandler = (notification: PaymentNotification) => void | Promise<void>;
-type RefundHandler = (notification: RefundNotification) => void | Promise<void>;
-type SubscriptionStatusHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
-type SubscriptionPaymentHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
-type SubscriptionPeriodChangedHandler = (notification: SubscriptionPeriodChangedNotification) => void | Promise<void>;
 /**
- * Webhook handler for processing Waffo webhook notifications.
- *
- * @example
- * ```typescript
- * // Setup handler
- * const handler = waffo.webhook()
- *   .onPayment((notification) => {
- *     console.log('Payment:', notification.result?.orderStatus);
- *   })
- *   .onRefund((notification) => {
- *     console.log('Refund:', notification.result?.refundStatus);
- *   });
- *
- * // Process webhook (e.g., in Express.js)
- * app.post('/webhook', async (req, res) => {
- *   const body = req.body.toString();
- *   const signature = req.headers['x-signature'];
- *   const result = await handler.handleWebhook(body, signature);
- *
- *   res.setHeader('X-SIGNATURE', result.responseSignature);
- *   res.status(200).send(result.responseBody);
- * });
- * ```
+ * Subscription status enum.
+ * Based on openapi.json SubscriptionInquiryResponse.subscriptionStatus.
  */
-declare class WebhookHandler {
-    private readonly waffoPublicKey;
-    private readonly privateKey;
-    private readonly logger?;
-    private paymentHandler?;
-    private refundHandler?;
-    private subscriptionStatusHandler?;
-    private subscriptionPaymentHandler?;
-    private subscriptionPeriodChangedHandler?;
-    constructor(config: WaffoConfig);
+type SubscriptionStatus = 'AUTHORIZATION_REQUIRED' | 'IN_PROGRESS' | 'ACTIVE' | 'CLOSE' | 'MERCHANT_CANCELLED' | 'USER_CANCELLED' | 'CHANNEL_CANCELLED' | 'EXPIRED';
+/**
+ * Subscription manage action enum.
+ */
+type SubscriptionManageAction = 'PAUSE' | 'RESUME' | 'UPDATE_AMOUNT' | 'UPDATE_PERIOD';
+/**
+ * Period type enum.
+ * Values: DAILY, WEEKLY, MONTHLY
+ */
+type PeriodType = 'DAILY' | 'WEEKLY' | 'MONTHLY';
+/**
+ * Product information for subscription.
+ * Based on openapi.json ProductInfo schema.
+ */
+interface ProductInfo {
     /**
-     * Registers a handler for payment notifications.
+     * Subscription product description (max 128 characters).
+     * Often appearing to user when asking user's confirmation.
      */
-    onPayment(handler: PaymentHandler): this;
+    description: string;
     /**
-     * Registers a handler for refund notifications.
+     * Subscription product period type: DAILY, WEEKLY, MONTHLY.
      */
-    onRefund(handler: RefundHandler): this;
+    periodType: PeriodType;
     /**
-     * Registers a handler for subscription status notifications.
+     * Period interval (max 12 characters).
+     * - DAILY: 1-365
+     * - WEEKLY: 1-4
+     * - MONTHLY: 1-12
      */
-    onSubscriptionStatus(handler: SubscriptionStatusHandler): this;
+    periodInterval: string;
     /**
-     * Registers a fallback handler for SUBSCRIPTION_STATUS_NOTIFICATION events.
-     * Only called when onSubscriptionStatus handler is not registered.
+     * Number of billing periods until subscription ends (max 24 characters).
+     * Empty means no defined end period.
      */
-    onSubscriptionPayment(handler: SubscriptionPaymentHandler): this;
+    numberOfPeriod?: string;
     /**
-     * Registers a handler for subscription period changed notifications.
+     * Trial period amount (max 24 characters).
      */
-    onSubscriptionPeriodChanged(handler: SubscriptionPeriodChangedHandler): this;
+    trialPeriodAmount?: string;
     /**
-     * Processes a webhook notification.
-     *
-     * @param body - The raw webhook body
-     * @param signature - The X-SIGNATURE header value
-     * @returns Result with response body and signature
+     * Number of trial periods (max 12 characters).
      */
-    handleWebhook(body: string, signature: string): Promise<WebhookResult>;
+    numberOfTrialPeriod?: string;
     /**
-     * Verifies a webhook signature.
-     *
-     * @param body - The raw webhook body
-     * @param signature - The X-SIGNATURE header value
-     * @returns true if signature is valid
+     * Trial period type: DAILY, WEEKLY, MONTHLY.
+     * If omitted, uses periodType value by default.
      */
-    verifySignature(body: string, signature: string): boolean;
+    trialPeriodType?: PeriodType;
     /**
-     * Builds a success response with signature.
+     * Trial period interval (max 12 characters).
+     * If omitted, uses periodInterval value by default.
      */
-    buildSuccessResponse(): {
-        body: string;
-        signature: string;
-    };
+    trialPeriodInterval?: string;
     /**
-     * Builds a failed response with signature.
+     * When the subscription starts (ISO 8601 format).
      */
-    buildFailedResponse(message: string): {
-        body: string;
-        signature: string;
-    };
-    private createSuccessResult;
-    private createFailedResult;
-}
-
-/**
- * Generic API response wrapper.
- *
- * All API responses are wrapped in this class for consistent handling.
- *
- * @example
- * ```typescript
- * const response = await waffo.order().create(params);
- *
- * if (response.isSuccess()) {
- *   const data = response.getData();
- *   console.log('Order ID:', data?.acquiringOrderId);
- * } else {
- *   console.error(`Error [${response.code}]: ${response.getMessage()}`);
- * }
- * ```
- */
-declare class ApiResponse<T> {
-    /** Response code. "0" indicates success, other values indicate errors. */
-    readonly code: string;
-    /** Response data (present when code is "0") */
-    readonly data?: T;
-    /** Error message (present when code is not "0") */
-    readonly message?: string;
-    private constructor();
+    startDateTime?: string;
     /**
-     * Creates a successful response.
-     *
-     * @param data - The response data
+     * When the subscription ends (ISO 8601 format).
      */
-    static success<T>(data?: T): ApiResponse<T>;
+    endDateTime?: string;
     /**
-     * Creates an error response.
-     *
-     * @param code - The error code
-     * @param message - The error message
+     * When the next payment is due (ISO 8601 format).
      */
-    static error<T>(code: string, message?: string): ApiResponse<T>;
+    nextPaymentDateTime?: string;
     /**
-     * Checks if the response indicates success.
-     *
-     * @returns true if the response code is "0"
+     * Current billing period number.
      */
-    isSuccess(): boolean;
+    currentPeriod?: string;
+    [key: string]: unknown;
+}
+/**
+ * User information for subscription.
+ */
+interface SubscriptionUserInfo {
+    userId: string;
+    userEmail: string;
+    userPhone?: string;
+    userFirstName?: string;
+    userLastName?: string;
+    userCountryCode?: string;
+    userBrowserIp?: string;
+    userAgent?: string;
+    [key: string]: unknown;
+}
+/**
+ * Payment information for subscription.
+ */
+interface SubscriptionPaymentInfo {
+    productName: string;
+    payMethodType?: string;
+    payMethodName?: string;
+    [key: string]: unknown;
+}
+/**
+ * Merchant information for subscription.
+ */
+interface SubscriptionMerchantInfo {
+    merchantId: string;
+    subMerchantId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Subscription information in payment order response and webhook notifications.
+ */
+interface SubscriptionInfo {
     /**
-     * Gets the response data.
-     *
-     * @returns The response data, or undefined if the response is an error
+     * Subscription request ID (max 32 characters).
+     * @deprecated Use merchantRequest instead for consistency with OpenAPI spec.
      */
-    getData(): T | undefined;
+    subscriptionRequest?: string;
     /**
-     * Gets the error message.
-     *
-     * @returns The error message, or undefined if the response is successful
+     * Merchant request ID (max 32 characters).
+     * Same as subscriptionRequest, aligned with OpenAPI specification.
      */
-    getMessage(): string | undefined;
+    merchantRequest?: string;
     /**
-     * Gets the response code.
-     *
-     * @returns The response code
+     * Waffo subscription ID (max 64 characters).
      */
-    getCode(): string;
+    subscriptionId?: string;
     /**
-     * Gets the response data or throws an error.
-     *
-     * @returns The response data
-     * @throws Error if the response is not successful or data is undefined
+     * Which period the subscription payment belongs to (max 12 characters).
      */
-    getDataOrThrow(): T;
+    period?: string;
+    [key: string]: unknown;
 }
-
 /**
- * HTTP client for making requests to the Waffo API.
- *
- * Handles:
- * - Request signing with merchant's private key
- * - Response signature verification with Waffo's public key
- * - MerchantId auto-injection
- * - Error handling and timeout management
+ * Subscription change status values.
  */
-declare class WaffoHttpClient {
-    private readonly baseUrl;
-    private readonly apiKey;
-    private readonly privateKey;
-    private readonly waffoPublicKey;
-    private readonly merchantId;
-    private readonly connectTimeout;
-    private readonly readTimeout;
-    private readonly logger?;
-    private readonly httpTransport;
-    constructor(config: WaffoConfig);
+type SubscriptionChangeStatus = 'IN_PROGRESS' | 'AUTHORIZATION_REQUIRED' | 'SUCCESS' | 'CLOSED';
+/**
+ * Product information for subscription change operations.
+ * Contains billing period settings for the new subscription plan.
+ */
+interface SubscriptionChangeProductInfo {
     /**
-     * Sends a POST request to the Waffo API.
-     *
-     * @param path - API endpoint path (e.g., "/order/create")
-     * @param request - Request body
-     * @param options - Per-request options
-     * @returns API response
-     * @throws WaffoUnknownStatusError for network errors or unknown status
+     * Product description (max 128 characters).
      */
-    post<T extends object, R>(path: string, request: T, options?: RequestOptions): Promise<ApiResponse<R>>;
+    description: string;
     /**
-     * Parses the API response body.
+     * Billing period type: DAILY, WEEKLY, MONTHLY.
      */
-    private parseResponse;
+    periodType: PeriodType;
     /**
-     * Auto-injects merchantId into the request if configured.
+     * Subscription amount for this product (max 12 characters).
      */
-    private injectMerchantIdIfNeeded;
+    amount: string;
     /**
-     * Checks if the error is a network-related error.
+     * Billing interval (max 12 characters).
      */
-    private isNetworkError;
-}
-
-/**
- * Base class for API resources.
- */
-declare abstract class BaseResource {
-    protected readonly httpClient: WaffoHttpClient;
-    protected readonly basePath: string;
-    constructor(httpClient: WaffoHttpClient, basePath: string);
+    periodInterval: string;
     /**
-     * Gets the full path for an endpoint.
-     *
-     * @param endpoint - The endpoint (e.g., "/create")
-     * @returns Full path (e.g., "/order/create")
+     * Total number of billing periods (max 24 characters, empty for unlimited).
      */
-    protected getPath(endpoint: string): string;
-}
-
-/**
- * Order-related type definitions.
- *
- * Note: Full type definitions should be generated from openapi.json.
- * These are placeholder interfaces for the SDK structure.
- */
-/**
- * Create order request parameters.
- */
-interface CreateOrderParams {
-    paymentRequestId: string;
-    merchantOrderId: string;
-    orderCurrency: string;
-    orderAmount: string;
-    orderDescription: string;
-    notifyUrl: string;
-    userInfo: UserInfo;
-    paymentInfo: PaymentInfo;
-    merchantInfo?: MerchantInfo;
-    goodsInfo?: GoodsInfo;
-    addressInfo?: AddressInfo;
-    cardInfo?: CardInfo;
-    riskData?: RiskData;
-    userCurrency?: string;
-    successRedirectUrl?: string;
-    failedRedirectUrl?: string;
-    cancelRedirectUrl?: string;
-    orderRequestedAt?: string;
-    orderExpiredAt?: string;
-    extendInfo?: string;
-    metadata?: string;
+    numberOfPeriod?: string;
+    /**
+     * Trial period amount (max 24 characters).
+     */
+    trialPeriodAmount?: string;
+    /**
+     * Number of trial periods (max 12 characters).
+     */
+    numberOfTrialPeriod?: string;
+    /**
+     * Trial period type: DAILY, WEEKLY, MONTHLY.
+     */
+    trialPeriodType?: PeriodType;
+    /**
+     * Trial period interval (max 12 characters).
+     */
+    trialPeriodInterval?: string;
     [key: string]: unknown;
 }
 /**
- * Create order response data.
+ * Subscription change request parameters.
  */
-interface CreateOrderData {
-    paymentRequestId?: string;
-    merchantOrderId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: OrderStatus;
-    orderAction?: string;
-    [key: string]: unknown;
-}
-/**
- * Inquiry order request parameters.
- */
-interface InquiryOrderParams {
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
-    merchantInfo?: MerchantInfo;
+interface SubscriptionChangeParams {
+    /**
+     * New unique request ID for this change (max 32 characters).
+     */
+    subscriptionRequest: string;
+    /**
+     * New merchant subscription plan ID (max 64 characters).
+     */
+    merchantSubscriptionId?: string;
+    /**
+     * Original subscription request ID to be changed (max 32 characters).
+     */
+    originSubscriptionRequest: string;
+    /**
+     * Remaining amount from the original subscription (max 24 characters).
+     */
+    remainingAmount: string;
+    /**
+     * Subscription currency code (ISO 4217).
+     */
+    currency: string;
+    /**
+     * User payment currency (when different from merchant currency).
+     */
+    userCurrency?: string;
+    /**
+     * Request time (ISO 8601 format). Auto-injected if not provided.
+     */
+    requestedAt?: string;
+    /**
+     * Redirect URL after successful subscription change.
+     */
+    successRedirectUrl?: string;
+    /**
+     * Redirect URL after failed subscription change.
+     */
+    failedRedirectUrl?: string;
+    /**
+     * Async notification URL for change notifications.
+     */
+    notifyUrl: string;
+    /**
+     * Redirect URL after user cancels.
+     */
+    cancelRedirectUrl?: string;
+    /**
+     * Merchant-side subscription management URL.
+     */
+    subscriptionManagementUrl?: string;
+    /**
+     * Reserved extend info (JSON format).
+     */
+    extendInfo?: string;
+    /**
+     * Order expiry time (ISO 8601 format).
+     */
+    orderExpiredAt?: string;
+    /**
+     * New subscription product information list.
+     */
+    productInfoList: SubscriptionChangeProductInfo[];
+    /**
+     * Merchant information.
+     */
+    merchantInfo?: SubscriptionMerchantInfo;
+    /**
+     * User information.
+     */
+    userInfo: SubscriptionUserInfo;
+    /**
+     * Goods information.
+     */
+    goodsInfo: {
+        goodsId: string;
+        goodsName: string;
+        goodsCategory?: string;
+        goodsUrl?: string;
+        appName?: string;
+        skuName?: string;
+        goodsUniquePrice?: string;
+        goodsQuantity?: number;
+        [key: string]: unknown;
+    };
+    /**
+     * Address information.
+     */
+    addressInfo?: {
+        address?: string;
+        city?: string;
+        region?: string;
+        postcode?: string;
+        addressCountryCode?: string;
+        [key: string]: unknown;
+    };
+    /**
+     * Payment method information.
+     */
+    paymentInfo: SubscriptionPaymentInfo;
+    /**
+     * Risk control auxiliary data.
+     */
+    riskData?: {
+        userType?: string;
+        userCategory?: string;
+        userLegalName?: string;
+        userDisplayName?: string;
+        userRegistrationIp?: string;
+        userLastSeenIp?: string;
+        userIsNew?: string;
+        userIsFirstPurchase?: string;
+        [key: string]: unknown;
+    };
     [key: string]: unknown;
 }
 /**
- * Inquiry order response data.
+ * Subscription change response data.
  */
-interface InquiryOrderData {
-    paymentRequestId?: string;
-    merchantOrderId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: OrderStatus;
-    orderCurrency?: string;
-    orderAmount?: string;
-    finalDealAmount?: string;
+interface SubscriptionChangeData {
     /**
-     * Refund expiry time (ISO 8601 format).
+     * Original subscription request ID that was changed.
      */
-    refundExpiryAt?: string;
+    originSubscriptionRequest?: string;
+    /**
+     * New subscription request ID after the change.
+     */
+    subscriptionRequest?: string;
+    /**
+     * Merchant's new subscription plan ID.
+     */
+    merchantSubscriptionId?: string;
+    /**
+     * Current status of the subscription change.
+     */
+    subscriptionChangeStatus?: SubscriptionChangeStatus;
+    /**
+     * Action guide for user to complete authorization.
+     * When subscriptionChangeStatus = AUTHORIZATION_REQUIRED, contains webUrl.
+     */
+    subscriptionAction?: string;
+    /**
+     * New Waffo subscription ID.
+     */
+    subscriptionId?: string;
     [key: string]: unknown;
 }
 /**
- * Cancel order request parameters.
+ * Subscription change inquiry request parameters.
  */
-interface CancelOrderParams {
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
-    merchantInfo?: MerchantInfo;
-    orderRequestedAt?: string;
+interface SubscriptionChangeInquiryParams {
+    /**
+     * Original subscription request ID that was changed.
+     */
+    originSubscriptionRequest: string;
+    /**
+     * New subscription request ID after the change.
+     */
+    subscriptionRequest: string;
     [key: string]: unknown;
 }
 /**
- * Cancel order response data.
+ * Subscription change inquiry response data.
  */
-interface CancelOrderData {
-    paymentRequestId?: string;
-    merchantOrderId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: OrderStatus;
+interface SubscriptionChangeInquiryData {
+    /**
+     * New subscription request ID after the change.
+     */
+    subscriptionRequest?: string;
+    /**
+     * Original subscription request ID that was changed.
+     */
+    originSubscriptionRequest?: string;
+    /**
+     * Merchant's new subscription plan ID.
+     */
+    merchantSubscriptionId?: string;
+    /**
+     * New Waffo subscription ID.
+     */
+    subscriptionId?: string;
+    /**
+     * Current status of the subscription change.
+     */
+    subscriptionChangeStatus?: SubscriptionChangeStatus;
+    /**
+     * Action guide for user authorization.
+     */
+    subscriptionAction?: string;
+    /**
+     * Remaining amount from the original subscription.
+     */
+    remainingAmount?: string;
+    /**
+     * Subscription currency (ISO 4217).
+     */
+    currency?: string;
+    /**
+     * User payment currency.
+     */
+    userCurrency?: string;
+    /**
+     * Request time.
+     */
+    requestedAt?: string;
+    /**
+     * Subscription management URL.
+     */
+    subscriptionManagementUrl?: string;
+    /**
+     * Extended info.
+     */
+    extendInfo?: string;
+    /**
+     * Order expiry time.
+     */
+    orderExpiredAt?: string;
+    /**
+     * Product information list.
+     */
+    productInfoList?: SubscriptionChangeProductInfo[];
+    /**
+     * Merchant information.
+     */
+    merchantInfo?: SubscriptionMerchantInfo;
+    /**
+     * User information.
+     */
+    userInfo?: SubscriptionUserInfo;
+    /**
+     * Goods information.
+     */
+    goodsInfo?: {
+        goodsId?: string;
+        goodsName?: string;
+        goodsCategory?: string;
+        goodsUrl?: string;
+        appName?: string;
+        skuName?: string;
+        goodsUniquePrice?: string;
+        goodsQuantity?: number;
+        [key: string]: unknown;
+    };
+    /**
+     * Address information.
+     */
+    addressInfo?: {
+        address?: string;
+        city?: string;
+        region?: string;
+        postcode?: string;
+        addressCountryCode?: string;
+        [key: string]: unknown;
+    };
+    /**
+     * Payment information.
+     */
+    paymentInfo?: SubscriptionPaymentInfo;
     [key: string]: unknown;
 }
+
 /**
- * Refund order request parameters.
+ * Webhook event types sent by Waffo.
  */
-interface RefundOrderParams {
-    refundRequestId: string;
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
-    merchantRefundOrderId?: string;
-    merchantInfo?: MerchantInfo;
-    refundAmount: string;
-    refundReason?: string;
-    requestedAt?: string;
-    notifyUrl?: string;
-    userInfo?: RefundUserInfo;
-    extendInfo?: string;
-    [key: string]: unknown;
+declare enum WebhookEventType {
+    PAYMENT_NOTIFICATION = "PAYMENT_NOTIFICATION",
+    REFUND_NOTIFICATION = "REFUND_NOTIFICATION",
+    SUBSCRIPTION_STATUS_NOTIFICATION = "SUBSCRIPTION_STATUS_NOTIFICATION",
+    SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION"
 }
 /**
- * Refund order response data.
+ * Result of webhook handling.
  */
-interface RefundOrderData {
-    refundRequestId?: string;
-    merchantRefundOrderId?: string;
-    acquiringOrderId?: string;
-    acquiringRefundOrderId?: string;
-    refundAmount?: string;
-    refundStatus?: RefundStatus$1;
-    remainingRefundAmount?: string;
-    [key: string]: unknown;
+interface WebhookResult {
+    /** Whether the webhook was processed successfully */
+    success: boolean;
+    /** Response body to send back to Waffo */
+    responseBody: string;
+    /** Signature for the response body */
+    responseSignature: string;
+    /** Error message if processing failed */
+    error?: string;
 }
 /**
- * Capture order request parameters.
+ * Base notification interface.
  */
-interface CaptureOrderParams {
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
-    merchantId: string;
-    captureAmount?: string;
-    [key: string]: unknown;
+interface BaseNotification {
+    eventType: string;
 }
 /**
- * Capture order response data.
+ * Payment notification result payload (21 fields).
  */
-interface CaptureOrderData {
+interface PaymentNotificationResult {
     paymentRequestId?: string;
     merchantOrderId?: string;
     acquiringOrderId?: string;
-    orderStatus?: OrderStatus;
-    [key: string]: unknown;
-}
-/**
- * Order status enum.
- */
-type OrderStatus = 'PAY_IN_PROGRESS' | 'AUTHORIZATION_REQUIRED' | 'AUTHED_WAITING_CAPTURE' | 'PAY_SUCCESS' | 'ORDER_CLOSE' | 'CAPTURE_IN_PROGRESS';
-/**
- * Refund status enum.
- */
-type RefundStatus$1 = 'REFUND_IN_PROGRESS' | 'ORDER_PARTIALLY_REFUNDED' | 'ORDER_FULLY_REFUNDED' | 'ORDER_REFUND_FAILED';
-/**
- * User information.
- */
-interface UserInfo {
-    userId: string;
-    userEmail: string;
-    userPhone?: string;
-    userFirstName?: string;
-    userLastName?: string;
-    userCreatedAt?: string;
-    userTerminal?: string;
-    userCountryCode?: string;
-    userBrowserIp?: string;
-    userAgent?: string;
+    orderStatus?: string;
+    orderAction?: string;
+    orderCurrency?: string;
+    orderAmount?: string;
+    userCurrency?: string;
+    finalDealAmount?: string;
+    orderDescription?: string;
+    merchantInfo?: Record<string, unknown>;
+    userInfo?: Record<string, unknown>;
+    goodsInfo?: Record<string, unknown>;
+    addressInfo?: Record<string, unknown>;
+    paymentInfo?: Record<string, unknown>;
+    orderRequestedAt?: string;
+    orderExpiredAt?: string;
+    orderUpdatedAt?: string;
+    orderCompletedAt?: string;
+    orderFailedReason?: Record<string, unknown>;
+    extendInfo?: string;
     /**
-     * User receipt URL (max 256 characters).
+     * The associated subscription info.
      */
-    userReceiptUrl?: string;
+    subscriptionInfo?: SubscriptionInfo;
+    /**
+     * Refund expiry time (ISO 8601 format).
+     */
+    refundExpiryAt?: string;
+    /**
+     * The address of the merchant page to redirect to when user cancels the payment.
+     */
+    cancelRedirectUrl?: string;
     [key: string]: unknown;
 }
 /**
- * Payment information.
+ * Refund notification result payload (17 fields).
  */
-interface PaymentInfo {
-    productName: string;
-    payMethodType?: string;
-    payMethodName?: string;
-    payMethodProperties?: string;
+interface RefundNotificationResult {
+    refundRequestId?: string;
+    merchantRefundOrderId?: string;
+    acquiringOrderId?: string;
+    acquiringRefundOrderId?: string;
+    origPaymentRequestId?: string;
+    refundAmount?: string;
+    refundStatus?: string;
+    remainingRefundAmount?: string;
+    userCurrency?: string;
+    finalDealAmount?: string;
+    refundReason?: string;
+    refundRequestedAt?: string;
+    refundUpdatedAt?: string;
+    refundCompletedAt?: string;
+    refundFailedReason?: Record<string, unknown>;
+    userInfo?: Record<string, unknown>;
+    extendInfo?: string;
+    /**
+     * Refund source. Possible values: MERCHANT, RDR, ETHOCA.
+     */
+    refundSource?: string;
     [key: string]: unknown;
 }
 /**
- * Merchant information.
+ * Subscription notification result payload (20 fields).
+ * Shared by SubscriptionStatusNotification and SubscriptionPeriodChangedNotification.
  */
-interface MerchantInfo {
-    merchantId: string;
-    subMerchantId?: string;
+interface SubscriptionNotificationResult {
+    subscriptionRequest?: string;
+    merchantSubscriptionId?: string;
+    subscriptionId?: string;
+    /**
+     * Payment method's subscription id.
+     */
+    payMethodSubscriptionId?: string;
+    subscriptionStatus?: string;
+    subscriptionAction?: string;
+    currency?: string;
+    amount?: string;
+    userCurrency?: string;
+    productInfo?: Record<string, unknown>;
+    merchantInfo?: Record<string, unknown>;
+    userInfo?: Record<string, unknown>;
+    goodsInfo?: Record<string, unknown>;
+    addressInfo?: Record<string, unknown>;
+    paymentInfo?: Record<string, unknown>;
+    requestedAt?: string;
+    updatedAt?: string;
+    failedReason?: Record<string, unknown>;
+    extendInfo?: string;
+    subscriptionManagementUrl?: string;
+    paymentDetails?: Record<string, unknown>[];
     [key: string]: unknown;
 }
 /**
- * Goods information.
+ * Payment notification from Waffo.
  */
-interface GoodsInfo {
-    goodsId?: string;
-    goodsName?: string;
-    goodsCategory?: string;
-    goodsUrl?: string;
-    appName?: string;
-    skuName?: string;
-    goodsUniquePrice?: string;
-    goodsQuantity?: number;
+interface PaymentNotification extends BaseNotification {
+    eventType: 'PAYMENT_NOTIFICATION';
+    result?: PaymentNotificationResult;
     [key: string]: unknown;
 }
 /**
- * Address information.
+ * Refund notification from Waffo.
  */
-interface AddressInfo {
-    address?: string;
-    city?: string;
-    region?: string;
-    postcode?: string;
-    addressCountryCode?: string;
+interface RefundNotification extends BaseNotification {
+    eventType: 'REFUND_NOTIFICATION';
+    result?: RefundNotificationResult;
     [key: string]: unknown;
 }
 /**
- * Card information.
+ * Subscription status notification from Waffo.
  */
-interface CardInfo {
-    cardNumber?: string;
-    cardExpiryYear?: number;
-    cardExpiryMonth?: number;
-    cardCvv?: string;
-    cardHolderName?: string;
-    threeDsDecision?: string;
+interface SubscriptionStatusNotification extends BaseNotification {
+    eventType: 'SUBSCRIPTION_STATUS_NOTIFICATION';
+    result?: SubscriptionNotificationResult;
     [key: string]: unknown;
 }
 /**
- * Risk data.
+ * Subscription period changed notification from Waffo.
  */
-interface RiskData {
-    userType?: string;
-    userCategory?: string;
-    userLegalName?: string;
-    userDisplayName?: string;
-    userRegistrationIp?: string;
-    userLastSeenIp?: string;
-    userIsNew?: string;
-    userIsFirstPurchase?: string;
+interface SubscriptionPeriodChangedNotification extends BaseNotification {
+    eventType: 'SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION';
+    result?: SubscriptionNotificationResult;
     [key: string]: unknown;
 }
+type PaymentHandler = (notification: PaymentNotification) => void | Promise<void>;
+type RefundHandler = (notification: RefundNotification) => void | Promise<void>;
+type SubscriptionStatusHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
+type SubscriptionPaymentHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
+type SubscriptionPeriodChangedHandler = (notification: SubscriptionPeriodChangedNotification) => void | Promise<void>;
 /**
- * Refund user information.
+ * Webhook handler for processing Waffo webhook notifications.
+ *
+ * @example
+ * ```typescript
+ * // Setup handler
+ * const handler = waffo.webhook()
+ *   .onPayment((notification) => {
+ *     console.log('Payment:', notification.result?.orderStatus);
+ *   })
+ *   .onRefund((notification) => {
+ *     console.log('Refund:', notification.result?.refundStatus);
+ *   });
+ *
+ * // Process webhook (e.g., in Express.js)
+ * app.post('/webhook', async (req, res) => {
+ *   const body = req.body.toString();
+ *   const signature = req.headers['x-signature'];
+ *   const result = await handler.handleWebhook(body, signature);
+ *
+ *   res.setHeader('X-SIGNATURE', result.responseSignature);
+ *   res.status(200).send(result.responseBody);
+ * });
+ * ```
  */
-interface RefundUserInfo {
-    userType?: string;
-    userFirstName?: string;
-    userLastName?: string;
-    userEmail?: string;
-    userPhone?: string;
-    [key: string]: unknown;
+declare class WebhookHandler {
+    private readonly waffoPublicKey;
+    private readonly privateKey;
+    private readonly logger?;
+    private paymentHandler?;
+    private refundHandler?;
+    private subscriptionStatusHandler?;
+    private subscriptionPaymentHandler?;
+    private subscriptionPeriodChangedHandler?;
+    constructor(config: WaffoConfig);
+    /**
+     * Registers a handler for payment notifications.
+     */
+    onPayment(handler: PaymentHandler): this;
+    /**
+     * Registers a handler for refund notifications.
+     */
+    onRefund(handler: RefundHandler): this;
+    /**
+     * Registers a handler for subscription status notifications.
+     */
+    onSubscriptionStatus(handler: SubscriptionStatusHandler): this;
+    /**
+     * Registers a fallback handler for SUBSCRIPTION_STATUS_NOTIFICATION events.
+     * Only called when onSubscriptionStatus handler is not registered.
+     */
+    onSubscriptionPayment(handler: SubscriptionPaymentHandler): this;
+    /**
+     * Registers a handler for subscription period changed notifications.
+     */
+    onSubscriptionPeriodChanged(handler: SubscriptionPeriodChangedHandler): this;
+    /**
+     * Processes a webhook notification.
+     *
+     * @param body - The raw webhook body
+     * @param signature - The X-SIGNATURE header value
+     * @returns Result with response body and signature
+     */
+    handleWebhook(body: string, signature: string): Promise<WebhookResult>;
+    /**
+     * Verifies a webhook signature.
+     *
+     * @param body - The raw webhook body
+     * @param signature - The X-SIGNATURE header value
+     * @returns true if signature is valid
+     */
+    verifySignature(body: string, signature: string): boolean;
+    /**
+     * Builds a success response with signature.
+     */
+    buildSuccessResponse(): {
+        body: string;
+        signature: string;
+    };
+    /**
+     * Builds a failed response with signature.
+     */
+    buildFailedResponse(message: string): {
+        body: string;
+        signature: string;
+    };
+    private createSuccessResult;
+    private createFailedResult;
 }
 
 /**
- * Order resource for managing payment orders.
+ * Generic API response wrapper.
+ *
+ * All API responses are wrapped in this class for consistent handling.
  *
  * @example
  * ```typescript
- * // Create an order
- * const response = await waffo.order().create({
- *   paymentRequestId: 'unique-request-id',
- *   merchantOrderId: 'order-123',
- *   orderCurrency: 'USD',
- *   orderAmount: '10.00',
- *   orderDescription: 'Test order',
- *   notifyUrl: 'https://example.com/webhook',
- *   userInfo: {
- *     userId: 'user-123',
- *     userEmail: 'user@example.com',
- *   },
- *   paymentInfo: {
- *     productName: 'Test Product',
- *   },
- * });
+ * const response = await waffo.order().create(params);
  *
  * if (response.isSuccess()) {
- *   console.log('Order created:', response.getData());
+ *   const data = response.getData();
+ *   console.log('Order ID:', data?.acquiringOrderId);
+ * } else {
+ *   console.error(`Error [${response.code}]: ${response.getMessage()}`);
  * }
  * ```
  */
-declare class OrderResource extends BaseResource {
-    private static readonly PATH_CREATE;
-    private static readonly PATH_INQUIRY;
-    private static readonly PATH_CANCEL;
-    private static readonly PATH_REFUND;
-    private static readonly PATH_CAPTURE;
+declare class ApiResponse<T> {
+    /** Response code. "0" indicates success, other values indicate errors. */
+    readonly code: string;
+    /** Response data (present when code is "0") */
+    readonly data?: T;
+    /** Error message (present when code is not "0") */
+    readonly message?: string;
+    private constructor();
+    /**
+     * Creates a successful response.
+     *
+     * @param data - The response data
+     */
+    static success<T>(data?: T): ApiResponse<T>;
+    /**
+     * Creates an error response.
+     *
+     * @param code - The error code
+     * @param message - The error message
+     */
+    static error<T>(code: string, message?: string): ApiResponse<T>;
+    /**
+     * Checks if the response indicates success.
+     *
+     * @returns true if the response code is "0"
+     */
+    isSuccess(): boolean;
+    /**
+     * Gets the response data.
+     *
+     * @returns The response data, or undefined if the response is an error
+     */
+    getData(): T | undefined;
+    /**
+     * Gets the error message.
+     *
+     * @returns The error message, or undefined if the response is successful
+     */
+    getMessage(): string | undefined;
+    /**
+     * Gets the response code.
+     *
+     * @returns The response code
+     */
+    getCode(): string;
+    /**
+     * Gets the response data or throws an error.
+     *
+     * @returns The response data
+     * @throws Error if the response is not successful or data is undefined
+     */
+    getDataOrThrow(): T;
+}
+
+/**
+ * HTTP client for making requests to the Waffo API.
+ *
+ * Handles:
+ * - Request signing with merchant's private key
+ * - Response signature verification with Waffo's public key
+ * - MerchantId auto-injection
+ * - Error handling and timeout management
+ */
+declare class WaffoHttpClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly privateKey;
+    private readonly waffoPublicKey;
+    private readonly merchantId;
+    private readonly connectTimeout;
+    private readonly readTimeout;
+    private readonly logger?;
+    private readonly httpTransport;
+    constructor(config: WaffoConfig);
     /**
-     * Creates a new payment order.
+     * Sends a POST request to the Waffo API.
      *
-     * @param params - Order creation parameters
-     * @param options - Optional request options
-     * @returns API response with order data
-     * @throws WaffoUnknownStatusError for network errors
+     * @param path - API endpoint path (e.g., "/order/create")
+     * @param request - Request body
+     * @param options - Per-request options
+     * @returns API response
+     * @throws WaffoUnknownStatusError for network errors or unknown status
      */
-    create(params: CreateOrderParams, options?: RequestOptions): Promise<ApiResponse<CreateOrderData>>;
+    post<T extends object, R>(path: string, request: T, options?: RequestOptions): Promise<ApiResponse<R>>;
     /**
-     * Queries an existing order.
-     *
-     * @param params - Order inquiry parameters
-     * @param options - Optional request options
-     * @returns API response with order data
-     * @throws WaffoUnknownStatusError for network errors
+     * Parses the API response body.
      */
-    inquiry(params: InquiryOrderParams, options?: RequestOptions): Promise<ApiResponse<InquiryOrderData>>;
+    private parseResponse;
     /**
-     * Cancels an existing order.
-     *
-     * @param params - Order cancellation parameters
-     * @param options - Optional request options
-     * @returns API response with cancellation result
-     * @throws WaffoUnknownStatusError for network errors
+     * Auto-injects merchantId into the request if configured.
      */
-    cancel(params: CancelOrderParams, options?: RequestOptions): Promise<ApiResponse<CancelOrderData>>;
+    private injectMerchantIdIfNeeded;
     /**
-     * Refunds an existing order.
-     *
-     * @param params - Order refund parameters
-     * @param options - Optional request options
-     * @returns API response with refund result
-     * @throws WaffoUnknownStatusError for network errors
+     * Checks if the error is a network-related error.
      */
-    refund(params: RefundOrderParams, options?: RequestOptions): Promise<ApiResponse<RefundOrderData>>;
+    private isNetworkError;
+}
+
+/**
+ * Base class for API resources.
+ */
+declare abstract class BaseResource {
+    protected readonly httpClient: WaffoHttpClient;
+    protected readonly basePath: string;
+    constructor(httpClient: WaffoHttpClient, basePath: string);
     /**
-     * Captures an authorized order.
+     * Gets the full path for an endpoint.
      *
-     * @param params - Order capture parameters
-     * @param options - Optional request options
-     * @returns API response with capture result
-     * @throws WaffoUnknownStatusError for network errors
+     * @param endpoint - The endpoint (e.g., "/create")
+     * @returns Full path (e.g., "/order/create")
      */
-    capture(params: CaptureOrderParams, options?: RequestOptions): Promise<ApiResponse<CaptureOrderData>>;
+    protected getPath(endpoint: string): string;
 }
 
 /**
- * Subscription-related type definitions.
+ * Order-related type definitions.
  *
  * Note: Full type definitions should be generated from openapi.json.
  * These are placeholder interfaces for the SDK structure.
  */
+
 /**
- * Create subscription request parameters.
+ * Create order request parameters.
  */
-interface CreateSubscriptionParams {
-    /**
-     * Subscription request ID sent from Merchant (max 32 characters).
-     * Used for idempotent check.
-     */
-    subscriptionRequest: string;
-    merchantSubscriptionId: string;
-    currency: string;
-    amount: string;
+interface CreateOrderParams {
+    paymentRequestId: string;
+    merchantOrderId: string;
+    orderCurrency: string;
+    orderAmount: string;
+    orderDescription: string;
     notifyUrl: string;
-    productInfo: ProductInfo;
-    userInfo: SubscriptionUserInfo;
-    paymentInfo: SubscriptionPaymentInfo;
-    merchantInfo?: SubscriptionMerchantInfo;
-    goodsInfo?: {
-        goodsId: string;
-        goodsName: string;
-        goodsCategory?: string;
-        goodsUrl?: string;
-        goodsQuantity?: number;
-        [key: string]: unknown;
-    };
+    userInfo: UserInfo;
+    paymentInfo: PaymentInfo;
+    merchantInfo?: MerchantInfo;
+    goodsInfo?: GoodsInfo;
+    addressInfo?: AddressInfo;
+    cardInfo?: CardInfo;
+    riskData?: RiskData;
+    userCurrency?: string;
     successRedirectUrl?: string;
     failedRedirectUrl?: string;
     cancelRedirectUrl?: string;
-    subscriptionManagementUrl?: string;
-    requestedAt?: string;
-    extendInfo?: string;
-    /**
-     * Order expiry time (ISO 8601 format, max 24 characters).
-     */
+    orderRequestedAt?: string;
     orderExpiredAt?: string;
+    extendInfo?: string;
+    metadata?: string;
     [key: string]: unknown;
 }
 /**
- * Create subscription response data.
- */
-interface CreateSubscriptionData {
-    subscriptionRequest?: string;
-    merchantSubscriptionId?: string;
-    subscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
-    subscriptionAction?: string;
-    [key: string]: unknown;
-}
-/**
- * Inquiry subscription request parameters.
- */
-interface InquirySubscriptionParams {
-    subscriptionRequest?: string;
-    subscriptionId?: string;
-    merchantInfo?: SubscriptionMerchantInfo;
-    [key: string]: unknown;
-}
-/**
- * Inquiry subscription response data.
- */
-interface InquirySubscriptionData {
-    subscriptionRequest?: string;
-    merchantSubscriptionId?: string;
-    subscriptionId?: string;
-    payMethodSubscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
-    subscriptionAction?: string;
-    currency?: string;
-    userCurrency?: string;
-    amount?: string;
-    productInfo?: ProductInfo;
-    [key: string]: unknown;
-}
-/**
- * Cancel subscription request parameters.
- */
-interface CancelSubscriptionParams {
-    subscriptionId?: string;
-    merchantId?: string;
-    requestedAt?: string;
-    [key: string]: unknown;
-}
-/**
- * Cancel subscription response data.
- */
-interface CancelSubscriptionData {
-    subscriptionRequest?: string;
-    merchantSubscriptionId?: string;
-    subscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
-    [key: string]: unknown;
-}
-/**
- * Manage subscription request parameters.
+ * Create order response data.
  */
-interface ManageSubscriptionParams {
-    subscriptionId: string;
-    merchantId: string;
-    action: SubscriptionManageAction;
-    newAmount?: string;
-    newPeriodType?: PeriodType;
-    newPeriodValue?: number;
-    requestedAt: string;
+interface CreateOrderData {
+    paymentRequestId?: string;
+    merchantOrderId?: string;
+    acquiringOrderId?: string;
+    orderStatus?: OrderStatus;
+    orderAction?: string;
     [key: string]: unknown;
 }
 /**
- * Manage subscription response data.
+ * Inquiry order request parameters.
  */
-interface ManageSubscriptionData {
-    subscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
+interface InquiryOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantInfo?: MerchantInfo;
     [key: string]: unknown;
 }
 /**
- * Subscription status enum.
- * Based on openapi.json SubscriptionInquiryResponse.subscriptionStatus.
- */
-type SubscriptionStatus = 'AUTHORIZATION_REQUIRED' | 'IN_PROGRESS' | 'ACTIVE' | 'CLOSE' | 'MERCHANT_CANCELLED' | 'USER_CANCELLED' | 'CHANNEL_CANCELLED' | 'EXPIRED';
-/**
- * Subscription manage action enum.
- */
-type SubscriptionManageAction = 'PAUSE' | 'RESUME' | 'UPDATE_AMOUNT' | 'UPDATE_PERIOD';
-/**
- * Period type enum.
- * Values: DAILY, WEEKLY, MONTHLY
- */
-type PeriodType = 'DAILY' | 'WEEKLY' | 'MONTHLY';
-/**
- * Product information for subscription.
- * Based on openapi.json ProductInfo schema.
+ * Inquiry order response data.
  */
-interface ProductInfo {
-    /**
-     * Subscription product description (max 128 characters).
-     * Often appearing to user when asking user's confirmation.
-     */
-    description: string;
-    /**
-     * Subscription product period type: DAILY, WEEKLY, MONTHLY.
-     */
-    periodType: PeriodType;
-    /**
-     * Period interval (max 12 characters).
-     * - DAILY: 1-365
-     * - WEEKLY: 1-4
-     * - MONTHLY: 1-12
-     */
-    periodInterval: string;
-    /**
-     * Number of billing periods until subscription ends (max 24 characters).
-     * Empty means no defined end period.
-     */
-    numberOfPeriod?: string;
-    /**
-     * Trial period amount (max 24 characters).
-     */
-    trialPeriodAmount?: string;
-    /**
-     * Number of trial periods (max 12 characters).
-     */
-    numberOfTrialPeriod?: string;
-    /**
-     * Trial period type: DAILY, WEEKLY, MONTHLY.
-     * If omitted, uses periodType value by default.
-     */
-    trialPeriodType?: PeriodType;
-    /**
-     * Trial period interval (max 12 characters).
-     * If omitted, uses periodInterval value by default.
-     */
-    trialPeriodInterval?: string;
-    /**
-     * When the subscription starts (ISO 8601 format).
-     */
-    startDateTime?: string;
+interface InquiryOrderData {
+    paymentRequestId?: string;
+    merchantOrderId?: string;
+    acquiringOrderId?: string;
+    orderStatus?: OrderStatus;
+    orderCurrency?: string;
+    orderAmount?: string;
+    finalDealAmount?: string;
     /**
-     * When the subscription ends (ISO 8601 format).
+     * Refund expiry time (ISO 8601 format).
      */
-    endDateTime?: string;
+    refundExpiryAt?: string;
     /**
-     * When the next payment is due (ISO 8601 format).
+     * The associated subscription info.
      */
-    nextPaymentDateTime?: string;
+    subscriptionInfo?: SubscriptionInfo;
     /**
-     * Current billing period number.
+     * The address of the merchant page to redirect to when user cancels the payment.
      */
-    currentPeriod?: string;
+    cancelRedirectUrl?: string;
     [key: string]: unknown;
 }
 /**
- * User information for subscription.
+ * Cancel order request parameters.
  */
-interface SubscriptionUserInfo {
-    userId: string;
-    userEmail: string;
-    userPhone?: string;
-    userFirstName?: string;
-    userLastName?: string;
-    userCountryCode?: string;
-    userBrowserIp?: string;
-    userAgent?: string;
+interface CancelOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantInfo?: MerchantInfo;
+    orderRequestedAt?: string;
     [key: string]: unknown;
 }
 /**
- * Payment information for subscription.
+ * Cancel order response data.
  */
-interface SubscriptionPaymentInfo {
-    productName: string;
-    payMethodType?: string;
-    payMethodName?: string;
+interface CancelOrderData {
+    paymentRequestId?: string;
+    merchantOrderId?: string;
+    acquiringOrderId?: string;
+    orderStatus?: OrderStatus;
     [key: string]: unknown;
 }
 /**
- * Merchant information for subscription.
+ * Refund order request parameters.
  */
-interface SubscriptionMerchantInfo {
+interface RefundOrderParams {
+    refundRequestId: string;
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantRefundOrderId?: string;
+    merchantInfo?: MerchantInfo;
+    refundAmount: string;
+    refundReason?: string;
+    requestedAt?: string;
+    notifyUrl?: string;
+    userInfo?: RefundUserInfo;
+    extendInfo?: string;
+    [key: string]: unknown;
+}
+/**
+ * Refund order response data.
+ */
+interface RefundOrderData {
+    refundRequestId?: string;
+    merchantRefundOrderId?: string;
+    acquiringOrderId?: string;
+    acquiringRefundOrderId?: string;
+    refundAmount?: string;
+    refundStatus?: RefundStatus$1;
+    remainingRefundAmount?: string;
+    [key: string]: unknown;
+}
+/**
+ * Capture order request parameters.
+ */
+interface CaptureOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
     merchantId: string;
-    subMerchantId?: string;
+    captureAmount?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change status values.
+ * Capture order response data.
  */
-type SubscriptionChangeStatus = 'IN_PROGRESS' | 'AUTHORIZATION_REQUIRED' | 'SUCCESS' | 'CLOSED';
+interface CaptureOrderData {
+    paymentRequestId?: string;
+    merchantOrderId?: string;
+    acquiringOrderId?: string;
+    orderStatus?: OrderStatus;
+    [key: string]: unknown;
+}
 /**
- * Product information for subscription change operations.
- * Contains billing period settings for the new subscription plan.
+ * Order status enum.
  */
-interface SubscriptionChangeProductInfo {
-    /**
-     * Product description (max 128 characters).
-     */
-    description: string;
-    /**
-     * Billing period type: DAILY, WEEKLY, MONTHLY.
-     */
-    periodType: PeriodType;
-    /**
-     * Subscription amount for this product (max 12 characters).
-     */
-    amount: string;
-    /**
-     * Billing interval (max 12 characters).
-     */
-    periodInterval: string;
-    /**
-     * Total number of billing periods (max 24 characters, empty for unlimited).
-     */
-    numberOfPeriod?: string;
-    /**
-     * Trial period amount (max 24 characters).
-     */
-    trialPeriodAmount?: string;
-    /**
-     * Number of trial periods (max 12 characters).
-     */
-    numberOfTrialPeriod?: string;
-    /**
-     * Trial period type: DAILY, WEEKLY, MONTHLY.
-     */
-    trialPeriodType?: PeriodType;
+type OrderStatus = 'PAY_IN_PROGRESS' | 'AUTHORIZATION_REQUIRED' | 'AUTHED_WAITING_CAPTURE' | 'PAY_SUCCESS' | 'ORDER_CLOSE' | 'CAPTURE_IN_PROGRESS';
+/**
+ * Refund status enum.
+ */
+type RefundStatus$1 = 'REFUND_IN_PROGRESS' | 'ORDER_PARTIALLY_REFUNDED' | 'ORDER_FULLY_REFUNDED' | 'ORDER_REFUND_FAILED';
+/**
+ * User information.
+ */
+interface UserInfo {
+    userId: string;
+    userEmail: string;
+    userPhone?: string;
+    userFirstName?: string;
+    userLastName?: string;
+    userCreatedAt?: string;
+    userTerminal?: string;
+    userCountryCode?: string;
+    userBrowserIp?: string;
+    userAgent?: string;
     /**
-     * Trial period interval (max 12 characters).
+     * User receipt URL (max 256 characters).
      */
-    trialPeriodInterval?: string;
+    userReceiptUrl?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change request parameters.
+ * Payment information.
  */
-interface SubscriptionChangeParams {
-    /**
-     * New unique request ID for this change (max 32 characters).
-     */
-    subscriptionRequest: string;
-    /**
-     * New merchant subscription plan ID (max 64 characters).
-     */
-    merchantSubscriptionId?: string;
-    /**
-     * Original subscription request ID to be changed (max 32 characters).
-     */
-    originSubscriptionRequest: string;
-    /**
-     * Remaining amount from the original subscription (max 24 characters).
-     */
-    remainingAmount: string;
-    /**
-     * Subscription currency code (ISO 4217).
-     */
-    currency: string;
-    /**
-     * User payment currency (when different from merchant currency).
-     */
-    userCurrency?: string;
-    /**
-     * Request time (ISO 8601 format).
-     */
-    requestedAt: string;
-    /**
-     * Redirect URL after successful subscription change.
-     */
-    successRedirectUrl?: string;
-    /**
-     * Redirect URL after failed subscription change.
-     */
-    failedRedirectUrl?: string;
-    /**
-     * Async notification URL for change notifications.
-     */
-    notifyUrl: string;
-    /**
-     * Redirect URL after user cancels.
-     */
-    cancelRedirectUrl?: string;
-    /**
-     * Merchant-side subscription management URL.
-     */
-    subscriptionManagementUrl?: string;
-    /**
-     * Reserved extend info (JSON format).
-     */
-    extendInfo?: string;
-    /**
-     * Order expiry time (ISO 8601 format).
-     */
-    orderExpiredAt?: string;
-    /**
-     * New subscription product information list.
-     */
-    productInfoList: SubscriptionChangeProductInfo[];
-    /**
-     * Merchant information.
-     */
-    merchantInfo?: SubscriptionMerchantInfo;
-    /**
-     * User information.
-     */
-    userInfo: SubscriptionUserInfo;
-    /**
-     * Goods information.
-     */
-    goodsInfo: {
-        goodsId: string;
-        goodsName: string;
-        goodsCategory?: string;
-        goodsUrl?: string;
-        appName?: string;
-        skuName?: string;
-        goodsUniquePrice?: string;
-        goodsQuantity?: number;
-        [key: string]: unknown;
-    };
-    /**
-     * Address information.
-     */
-    addressInfo?: {
-        address?: string;
-        city?: string;
-        region?: string;
-        postcode?: string;
-        addressCountryCode?: string;
-        [key: string]: unknown;
-    };
-    /**
-     * Payment method information.
-     */
-    paymentInfo: SubscriptionPaymentInfo;
-    /**
-     * Risk control auxiliary data.
-     */
-    riskData?: {
-        userType?: string;
-        userCategory?: string;
-        userLegalName?: string;
-        userDisplayName?: string;
-        userRegistrationIp?: string;
-        userLastSeenIp?: string;
-        userIsNew?: string;
-        userIsFirstPurchase?: string;
-        [key: string]: unknown;
-    };
+interface PaymentInfo {
+    productName: string;
+    payMethodType?: string;
+    payMethodName?: string;
+    payMethodProperties?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change response data.
+ * Merchant information.
  */
-interface SubscriptionChangeData {
-    /**
-     * Original subscription request ID that was changed.
-     */
-    originSubscriptionRequest?: string;
-    /**
-     * New subscription request ID after the change.
-     */
-    subscriptionRequest?: string;
-    /**
-     * Merchant's new subscription plan ID.
-     */
-    merchantSubscriptionId?: string;
-    /**
-     * Current status of the subscription change.
-     */
-    subscriptionChangeStatus?: SubscriptionChangeStatus;
-    /**
-     * Action guide for user to complete authorization.
-     * When subscriptionChangeStatus = AUTHORIZATION_REQUIRED, contains webUrl.
-     */
-    subscriptionAction?: string;
-    /**
-     * New Waffo subscription ID.
-     */
-    subscriptionId?: string;
+interface MerchantInfo {
+    merchantId: string;
+    subMerchantId?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change inquiry request parameters.
+ * Goods information.
  */
-interface SubscriptionChangeInquiryParams {
-    /**
-     * Original subscription request ID that was changed.
-     */
-    originSubscriptionRequest: string;
-    /**
-     * New subscription request ID after the change.
-     */
-    subscriptionRequest: string;
+interface GoodsInfo {
+    goodsId?: string;
+    goodsName?: string;
+    goodsCategory?: string;
+    goodsUrl?: string;
+    appName?: string;
+    skuName?: string;
+    goodsUniquePrice?: string;
+    goodsQuantity?: number;
     [key: string]: unknown;
 }
 /**
- * Subscription change inquiry response data.
+ * Address information.
  */
-interface SubscriptionChangeInquiryData {
-    /**
-     * New subscription request ID after the change.
-     */
-    subscriptionRequest?: string;
-    /**
-     * Original subscription request ID that was changed.
-     */
-    originSubscriptionRequest?: string;
-    /**
-     * Merchant's new subscription plan ID.
-     */
-    merchantSubscriptionId?: string;
-    /**
-     * New Waffo subscription ID.
-     */
-    subscriptionId?: string;
-    /**
-     * Current status of the subscription change.
-     */
-    subscriptionChangeStatus?: SubscriptionChangeStatus;
-    /**
-     * Action guide for user authorization.
-     */
-    subscriptionAction?: string;
-    /**
-     * Remaining amount from the original subscription.
-     */
-    remainingAmount?: string;
-    /**
-     * Subscription currency (ISO 4217).
-     */
-    currency?: string;
-    /**
-     * User payment currency.
-     */
-    userCurrency?: string;
-    /**
-     * Request time.
-     */
-    requestedAt?: string;
-    /**
-     * Subscription management URL.
-     */
-    subscriptionManagementUrl?: string;
-    /**
-     * Extended info.
-     */
-    extendInfo?: string;
-    /**
-     * Order expiry time.
-     */
-    orderExpiredAt?: string;
-    /**
-     * Product information list.
-     */
-    productInfoList?: SubscriptionChangeProductInfo[];
+interface AddressInfo {
+    address?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    addressCountryCode?: string;
+    [key: string]: unknown;
+}
+/**
+ * Card information.
+ */
+interface CardInfo {
+    cardNumber?: string;
+    cardExpiryYear?: number;
+    cardExpiryMonth?: number;
+    cardCvv?: string;
+    cardHolderName?: string;
+    threeDsDecision?: string;
+    [key: string]: unknown;
+}
+/**
+ * Risk data.
+ */
+interface RiskData {
+    userType?: string;
+    userCategory?: string;
+    userLegalName?: string;
+    userDisplayName?: string;
+    userRegistrationIp?: string;
+    userLastSeenIp?: string;
+    userIsNew?: string;
+    userIsFirstPurchase?: string;
+    [key: string]: unknown;
+}
+/**
+ * Refund user information.
+ */
+interface RefundUserInfo {
+    userType?: string;
+    userFirstName?: string;
+    userLastName?: string;
+    userEmail?: string;
+    userPhone?: string;
+    [key: string]: unknown;
+}
+
+/**
+ * Order resource for managing payment orders.
+ *
+ * @example
+ * ```typescript
+ * // Create an order
+ * const response = await waffo.order().create({
+ *   paymentRequestId: 'unique-request-id',
+ *   merchantOrderId: 'order-123',
+ *   orderCurrency: 'USD',
+ *   orderAmount: '10.00',
+ *   orderDescription: 'Test order',
+ *   notifyUrl: 'https://example.com/webhook',
+ *   userInfo: {
+ *     userId: 'user-123',
+ *     userEmail: 'user@example.com',
+ *   },
+ *   paymentInfo: {
+ *     productName: 'Test Product',
+ *   },
+ * });
+ *
+ * if (response.isSuccess()) {
+ *   console.log('Order created:', response.getData());
+ * }
+ * ```
+ */
+declare class OrderResource extends BaseResource {
+    private static readonly PATH_CREATE;
+    private static readonly PATH_INQUIRY;
+    private static readonly PATH_CANCEL;
+    private static readonly PATH_REFUND;
+    private static readonly PATH_CAPTURE;
     /**
-     * Merchant information.
+     * Creates a new payment order.
+     *
+     * @param params - Order creation parameters
+     * @param options - Optional request options
+     * @returns API response with order data
+     * @throws WaffoUnknownStatusError for network errors
      */
-    merchantInfo?: SubscriptionMerchantInfo;
+    create(params: CreateOrderParams, options?: RequestOptions): Promise<ApiResponse<CreateOrderData>>;
     /**
-     * User information.
+     * Queries an existing order.
+     *
+     * @param params - Order inquiry parameters
+     * @param options - Optional request options
+     * @returns API response with order data
+     * @throws WaffoUnknownStatusError for network errors
      */
-    userInfo?: SubscriptionUserInfo;
+    inquiry(params: InquiryOrderParams, options?: RequestOptions): Promise<ApiResponse<InquiryOrderData>>;
     /**
-     * Goods information.
+     * Cancels an existing order.
+     *
+     * @param params - Order cancellation parameters
+     * @param options - Optional request options
+     * @returns API response with cancellation result
+     * @throws WaffoUnknownStatusError for network errors
      */
-    goodsInfo?: {
-        goodsId?: string;
-        goodsName?: string;
-        goodsCategory?: string;
-        goodsUrl?: string;
-        appName?: string;
-        skuName?: string;
-        goodsUniquePrice?: string;
-        goodsQuantity?: number;
-        [key: string]: unknown;
-    };
+    cancel(params: CancelOrderParams, options?: RequestOptions): Promise<ApiResponse<CancelOrderData>>;
     /**
-     * Address information.
+     * Refunds an existing order.
+     *
+     * @param params - Order refund parameters
+     * @param options - Optional request options
+     * @returns API response with refund result
+     * @throws WaffoUnknownStatusError for network errors
      */
-    addressInfo?: {
-        address?: string;
-        city?: string;
-        region?: string;
-        postcode?: string;
-        addressCountryCode?: string;
-        [key: string]: unknown;
-    };
+    refund(params: RefundOrderParams, options?: RequestOptions): Promise<ApiResponse<RefundOrderData>>;
     /**
-     * Payment information.
+     * Captures an authorized order.
+     *
+     * @param params - Order capture parameters
+     * @param options - Optional request options
+     * @returns API response with capture result
+     * @throws WaffoUnknownStatusError for network errors
      */
-    paymentInfo?: SubscriptionPaymentInfo;
-    [key: string]: unknown;
+    capture(params: CaptureOrderParams, options?: RequestOptions): Promise<ApiResponse<CaptureOrderData>>;
 }
 
 /**
@@ -2062,4 +2115,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 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 PayMethodInfo, type PaymentInfo, type PaymentNotification, type PaymentNotificationResult, type PeriodType, type ProductInfo, type RefundNotification, type RefundNotificationResult, type RefundOrderData, type RefundOrderParams, RefundResource, type RefundStatus$1 as RefundStatus, type RefundUserInfo, type RequestOptions, type RiskData, RsaUtils, type SubscriptionManageAction, type SubscriptionMerchantInfo, type SubscriptionNotificationResult, type SubscriptionPaymentInfo, type SubscriptionPeriodChangedNotification, SubscriptionResource, type SubscriptionStatus, type SubscriptionStatusNotification, type SubscriptionUserInfo, type UserInfo, Waffo, type WaffoConfig, WaffoConfigDefaults, WaffoError, WaffoErrorCode, WaffoHttpClient, type WaffoLogger, WaffoUnknownStatusError, WebhookEventType, WebhookHandler, type WebhookResult };
+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 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 PayMethodInfo, type PaymentInfo, type PaymentNotification, type PaymentNotificationResult, type PeriodType, type ProductInfo, type RefundNotification, type RefundNotificationResult, type RefundOrderData, type RefundOrderParams, RefundResource, type RefundStatus$1 as RefundStatus, type RefundUserInfo, type RequestOptions, type RiskData, RsaUtils, type SubscriptionInfo, type SubscriptionManageAction, type SubscriptionMerchantInfo, type SubscriptionNotificationResult, type SubscriptionPaymentInfo, type SubscriptionPeriodChangedNotification, SubscriptionResource, type SubscriptionStatus, type SubscriptionStatusNotification, type SubscriptionUserInfo, type UserInfo, Waffo, type WaffoConfig, WaffoConfigDefaults, WaffoError, WaffoErrorCode, WaffoHttpClient, type WaffoLogger, WaffoUnknownStatusError, WebhookEventType, WebhookHandler, type WebhookResult };