@waffo/waffo-node 2.1.0 → 2.3.0

package/dist/index.d.ts

@@ -170,1175 +170,1283 @@ interface RequestOptions {
 }
 
 /**
- * Webhook event types sent by Waffo.
+ * Subscription-related type definitions.
+ *
+ * Note: Full type definitions should be generated from openapi.json.
+ * These are placeholder interfaces for the SDK structure.
  */
-declare enum WebhookEventType {
-    PAYMENT_NOTIFICATION = "PAYMENT_NOTIFICATION",
-    REFUND_NOTIFICATION = "REFUND_NOTIFICATION",
-    SUBSCRIPTION_STATUS_NOTIFICATION = "SUBSCRIPTION_STATUS_NOTIFICATION",
-    SUBSCRIPTION_PAYMENT_NOTIFICATION = "SUBSCRIPTION_PAYMENT_NOTIFICATION",
-    SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION"
-}
 /**
- * Result of webhook handling.
+ * Create subscription request parameters.
  */
-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;
+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;
 }
 /**
- * Base notification interface.
+ * Create subscription response data.
  */
-interface BaseNotification {
-    eventType: string;
+interface CreateSubscriptionData {
+    subscriptionRequest?: string;
+    merchantSubscriptionId?: string;
+    subscriptionId?: string;
+    subscriptionStatus?: SubscriptionStatus;
+    subscriptionAction?: string;
+    [key: string]: unknown;
 }
 /**
- * Payment notification from Waffo.
+ * Inquiry subscription request parameters.
  */
-interface PaymentNotification extends BaseNotification {
-    eventType: 'PAYMENT_NOTIFICATION';
-    acquiringOrderId?: string;
-    merchantOrderId?: string;
-    paymentRequestId?: string;
-    orderStatus?: string;
-    orderAmount?: string;
-    orderCurrency?: string;
-    finalDealAmount?: string;
+interface InquirySubscriptionParams {
+    subscriptionRequest?: string;
+    subscriptionId?: string;
+    merchantInfo?: SubscriptionMerchantInfo;
     [key: string]: unknown;
 }
 /**
- * Refund notification from Waffo.
+ * Inquiry subscription response data.
  */
-interface RefundNotification extends BaseNotification {
-    eventType: 'REFUND_NOTIFICATION';
-    acquiringRefundOrderId?: string;
-    refundRequestId?: string;
-    refundStatus?: string;
-    refundAmount?: string;
+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;
 }
 /**
- * Subscription status notification from Waffo.
+ * Cancel subscription request parameters.
  */
-interface SubscriptionStatusNotification extends BaseNotification {
-    eventType: 'SUBSCRIPTION_STATUS_NOTIFICATION';
+interface CancelSubscriptionParams {
     subscriptionId?: string;
-    subscriptionStatus?: string;
+    merchantId?: string;
+    requestedAt?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription payment notification from Waffo.
+ * Cancel subscription response data.
  */
-interface SubscriptionPaymentNotification extends BaseNotification {
-    eventType: 'SUBSCRIPTION_PAYMENT_NOTIFICATION';
+interface CancelSubscriptionData {
+    subscriptionRequest?: string;
+    merchantSubscriptionId?: string;
     subscriptionId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: string;
+    subscriptionStatus?: SubscriptionStatus;
     [key: string]: unknown;
 }
 /**
- * Subscription period changed notification from Waffo.
+ * Manage subscription request parameters.
  */
-interface SubscriptionPeriodChangedNotification extends BaseNotification {
-    eventType: 'SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION';
+interface ManageSubscriptionParams {
+    subscriptionId: string;
+    merchantId: string;
+    action: SubscriptionManageAction;
+    newAmount?: string;
+    newPeriodType?: PeriodType;
+    newPeriodValue?: number;
+    requestedAt?: string;
+    [key: string]: unknown;
+}
+/**
+ * Manage subscription response data.
+ */
+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: SubscriptionPaymentNotification) => 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.orderStatus);
- *   })
- *   .onRefund((notification) => {
- *     console.log('Refund:', notification.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 handler for subscription payment notifications.
+     * 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;
+    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;
 }
-
-/**
- * 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.
+ * Subscription change 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;
+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;
-    orderRequestedAt?: string;
-    orderExpiredAt?: string;
+    /**
+     * Merchant-side subscription management URL.
+     */
+    subscriptionManagementUrl?: string;
+    /**
+     * Reserved extend info (JSON format).
+     */
     extendInfo?: string;
-    metadata?: string;
-    [key: string]: unknown;
-}
-/**
- * Create order response data.
- */
-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;
-    [key: string]: unknown;
-}
-/**
- * Inquiry order response data.
- */
-interface InquiryOrderData {
-    paymentRequestId?: string;
-    merchantOrderId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: OrderStatus;
-    orderCurrency?: string;
-    orderAmount?: string;
-    finalDealAmount?: string;
     /**
-     * Refund expiry time (ISO 8601 format).
+     * Order expiry time (ISO 8601 format).
      */
-    refundExpiryAt?: string;
+    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;
 }
 /**
- * Cancel order request parameters.
+ * Subscription change response data.
  */
-interface CancelOrderParams {
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
-    merchantInfo?: MerchantInfo;
-    orderRequestedAt?: string;
+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;
     [key: string]: unknown;
 }
 /**
- * Cancel order response data.
+ * Subscription change inquiry request parameters.
  */
-interface CancelOrderData {
-    paymentRequestId?: string;
-    merchantOrderId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: OrderStatus;
+interface SubscriptionChangeInquiryParams {
+    /**
+     * Original subscription request ID that was changed.
+     */
+    originSubscriptionRequest: string;
+    /**
+     * New subscription request ID after the change.
+     */
+    subscriptionRequest: string;
     [key: string]: unknown;
 }
 /**
- * Refund order request parameters.
+ * Subscription change inquiry response data.
  */
-interface RefundOrderParams {
-    refundRequestId: string;
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
-    merchantRefundOrderId?: string;
-    merchantInfo?: MerchantInfo;
-    refundAmount: string;
-    refundReason?: string;
+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;
-    notifyUrl?: string;
-    userInfo?: RefundUserInfo;
+    /**
+     * 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 response data.
+ * Webhook event types sent by Waffo.
  */
-interface RefundOrderData {
-    refundRequestId?: string;
-    merchantRefundOrderId?: string;
-    acquiringOrderId?: string;
-    acquiringRefundOrderId?: string;
-    refundAmount?: string;
-    refundStatus?: RefundStatus$1;
-    remainingRefundAmount?: 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"
 }
 /**
- * Capture order request parameters.
+ * Result of webhook handling.
  */
-interface CaptureOrderParams {
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
-    merchantId: string;
-    captureAmount?: 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 response data.
+ * Base notification interface.
  */
-interface CaptureOrderData {
-    paymentRequestId?: string;
-    merchantOrderId?: string;
-    acquiringOrderId?: string;
-    orderStatus?: OrderStatus;
-    [key: string]: unknown;
+interface BaseNotification {
+    eventType: string;
 }
 /**
- * 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.
+ * Payment notification result payload (21 fields).
  */
-interface UserInfo {
-    userId: string;
-    userEmail: string;
-    userPhone?: string;
-    userFirstName?: string;
-    userLastName?: string;
-    userCreatedAt?: string;
-    userTerminal?: string;
-    userCountryCode?: string;
-    userBrowserIp?: string;
-    userAgent?: string;
+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;
     /**
-     * User receipt URL (max 256 characters).
+     * The associated subscription info.
      */
-    userReceiptUrl?: string;
-    [key: string]: unknown;
-}
-/**
- * Payment information.
- */
-interface PaymentInfo {
-    productName: string;
-    payMethodType?: string;
-    payMethodName?: string;
-    payMethodProperties?: 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;
 }
 /**
- * Merchant information.
+ * Refund notification result payload (17 fields).
  */
-interface MerchantInfo {
-    merchantId: string;
-    subMerchantId?: 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;
 }
 /**
- * Goods information.
+ * Subscription notification result payload (20 fields).
+ * Shared by SubscriptionStatusNotification and SubscriptionPeriodChangedNotification.
  */
-interface GoodsInfo {
-    goodsId?: string;
-    goodsName?: string;
-    goodsCategory?: string;
-    goodsUrl?: string;
-    appName?: string;
-    skuName?: string;
-    goodsUniquePrice?: string;
-    goodsQuantity?: number;
+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;
 }
 /**
- * Address information.
+ * Payment notification from Waffo.
  */
-interface AddressInfo {
-    address?: string;
-    city?: string;
-    region?: string;
-    postcode?: string;
-    addressCountryCode?: string;
+interface PaymentNotification extends BaseNotification {
+    eventType: 'PAYMENT_NOTIFICATION';
+    result?: PaymentNotificationResult;
     [key: string]: unknown;
 }
 /**
- * Card information.
+ * Refund notification from Waffo.
  */
-interface CardInfo {
-    cardNumber?: string;
-    cardExpiryYear?: number;
-    cardExpiryMonth?: number;
-    cardCvv?: string;
-    cardHolderName?: string;
-    threeDsDecision?: string;
+interface RefundNotification extends BaseNotification {
+    eventType: 'REFUND_NOTIFICATION';
+    result?: RefundNotificationResult;
     [key: string]: unknown;
 }
 /**
- * Risk data.
+ * Subscription status notification from Waffo.
  */
-interface RiskData {
-    userType?: string;
-    userCategory?: string;
-    userLegalName?: string;
-    userDisplayName?: string;
-    userRegistrationIp?: string;
-    userLastSeenIp?: string;
-    userIsNew?: string;
-    userIsFirstPurchase?: string;
+interface SubscriptionStatusNotification extends BaseNotification {
+    eventType: 'SUBSCRIPTION_STATUS_NOTIFICATION';
+    result?: SubscriptionNotificationResult;
     [key: string]: unknown;
 }
 /**
- * Refund user information.
+ * Subscription period changed notification from Waffo.
  */
-interface RefundUserInfo {
-    userType?: string;
-    userFirstName?: string;
-    userLastName?: string;
-    userEmail?: string;
-    userPhone?: 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>;
 /**
- * Order resource for managing payment orders.
+ * Webhook handler for processing Waffo webhook notifications.
  *
  * @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',
- *   },
- * });
+ * // Setup handler
+ * const handler = waffo.webhook()
+ *   .onPayment((notification) => {
+ *     console.log('Payment:', notification.result?.orderStatus);
+ *   })
+ *   .onRefund((notification) => {
+ *     console.log('Refund:', notification.result?.refundStatus);
+ *   });
  *
- * if (response.isSuccess()) {
- *   console.log('Order created:', response.getData());
- * }
+ * // 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);
+ * });
  * ```
  */
-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 WebhookHandler {
+    private readonly waffoPublicKey;
+    private readonly privateKey;
+    private readonly logger?;
+    private paymentHandler?;
+    private refundHandler?;
+    private subscriptionStatusHandler?;
+    private subscriptionPaymentHandler?;
+    private subscriptionPeriodChangedHandler?;
+    constructor(config: WaffoConfig);
     /**
-     * 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
+     * Registers a handler for payment notifications.
      */
-    create(params: CreateOrderParams, options?: RequestOptions): Promise<ApiResponse<CreateOrderData>>;
+    onPayment(handler: PaymentHandler): this;
     /**
-     * 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
+     * Registers a handler for refund notifications.
      */
-    inquiry(params: InquiryOrderParams, options?: RequestOptions): Promise<ApiResponse<InquiryOrderData>>;
+    onRefund(handler: RefundHandler): this;
     /**
-     * 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
+     * Registers a handler for subscription status notifications.
      */
-    cancel(params: CancelOrderParams, options?: RequestOptions): Promise<ApiResponse<CancelOrderData>>;
+    onSubscriptionStatus(handler: SubscriptionStatusHandler): this;
     /**
-     * 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
+     * Registers a fallback handler for SUBSCRIPTION_STATUS_NOTIFICATION events.
+     * Only called when onSubscriptionStatus handler is not registered.
      */
-    refund(params: RefundOrderParams, options?: RequestOptions): Promise<ApiResponse<RefundOrderData>>;
+    onSubscriptionPayment(handler: SubscriptionPaymentHandler): this;
     /**
-     * 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
+     * Registers a handler for subscription period changed notifications.
      */
-    capture(params: CaptureOrderParams, options?: RequestOptions): Promise<ApiResponse<CaptureOrderData>>;
+    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;
 }
 
 /**
- * Subscription-related type definitions.
+ * Generic API response wrapper.
  *
- * Note: Full type definitions should be generated from openapi.json.
- * These are placeholder interfaces for the SDK structure.
+ * 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();
+    /**
+     * 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;
+}
+
 /**
- * Create subscription request parameters.
+ * 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
  */
-interface CreateSubscriptionParams {
+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);
     /**
-     * Subscription request ID sent from Merchant (max 32 characters).
-     * Used for idempotent check.
+     * 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
      */
-    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;
+    post<T extends object, R>(path: string, request: T, options?: RequestOptions): Promise<ApiResponse<R>>;
     /**
-     * Order expiry time (ISO 8601 format, max 24 characters).
+     * Parses the API response body.
      */
-    orderExpiredAt?: string;
-    [key: string]: unknown;
+    private parseResponse;
+    /**
+     * Auto-injects merchantId into the request if configured.
+     */
+    private injectMerchantIdIfNeeded;
+    /**
+     * Checks if the error is a network-related error.
+     */
+    private isNetworkError;
 }
+
 /**
- * Create subscription response data.
+ * Base class for API resources.
  */
-interface CreateSubscriptionData {
-    subscriptionRequest?: string;
-    merchantSubscriptionId?: string;
-    subscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
-    subscriptionAction?: string;
-    [key: string]: unknown;
+declare abstract class BaseResource {
+    protected readonly httpClient: WaffoHttpClient;
+    protected readonly basePath: string;
+    constructor(httpClient: WaffoHttpClient, basePath: string);
+    /**
+     * Gets the full path for an endpoint.
+     *
+     * @param endpoint - The endpoint (e.g., "/create")
+     * @returns Full path (e.g., "/order/create")
+     */
+    protected getPath(endpoint: string): string;
 }
+
 /**
- * Inquiry subscription request parameters.
+ * Order-related type definitions.
+ *
+ * Note: Full type definitions should be generated from openapi.json.
+ * These are placeholder interfaces for the SDK structure.
  */
-interface InquirySubscriptionParams {
-    subscriptionRequest?: string;
-    subscriptionId?: string;
-    merchantInfo?: SubscriptionMerchantInfo;
-    [key: string]: unknown;
-}
+
 /**
- * Inquiry subscription response data.
+ * Create order request parameters.
  */
-interface InquirySubscriptionData {
-    subscriptionRequest?: string;
-    merchantSubscriptionId?: string;
-    subscriptionId?: string;
-    payMethodSubscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
-    subscriptionAction?: string;
-    currency?: string;
+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;
-    amount?: string;
-    productInfo?: ProductInfo;
+    successRedirectUrl?: string;
+    failedRedirectUrl?: string;
+    cancelRedirectUrl?: string;
+    orderRequestedAt?: string;
+    orderExpiredAt?: string;
+    extendInfo?: string;
+    metadata?: string;
     [key: string]: unknown;
 }
 /**
- * Cancel subscription request parameters.
+ * Create order response data.
  */
-interface CancelSubscriptionParams {
-    subscriptionRequest?: string;
-    subscriptionId?: string;
-    merchantInfo?: SubscriptionMerchantInfo;
-    cancelReason?: string;
-    requestedAt?: string;
+interface CreateOrderData {
+    paymentRequestId?: string;
+    merchantOrderId?: string;
+    acquiringOrderId?: string;
+    orderStatus?: OrderStatus;
+    orderAction?: string;
     [key: string]: unknown;
 }
 /**
- * Cancel subscription response data.
+ * Inquiry order request parameters.
  */
-interface CancelSubscriptionData {
-    subscriptionRequest?: string;
-    merchantSubscriptionId?: string;
-    subscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
+interface InquiryOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantInfo?: MerchantInfo;
     [key: string]: unknown;
 }
 /**
- * Manage subscription request parameters.
+ * Inquiry order response data.
  */
-interface ManageSubscriptionParams {
-    subscriptionId: string;
-    merchantId: string;
-    action: SubscriptionManageAction;
-    newAmount?: string;
-    newPeriodType?: PeriodType;
-    newPeriodValue?: number;
-    requestedAt: string;
+interface InquiryOrderData {
+    paymentRequestId?: string;
+    merchantOrderId?: string;
+    acquiringOrderId?: string;
+    orderStatus?: OrderStatus;
+    orderCurrency?: string;
+    orderAmount?: string;
+    finalDealAmount?: string;
+    /**
+     * Refund expiry time (ISO 8601 format).
+     */
+    refundExpiryAt?: string;
+    /**
+     * The associated subscription info.
+     */
+    subscriptionInfo?: SubscriptionInfo;
+    /**
+     * The address of the merchant page to redirect to when user cancels the payment.
+     */
+    cancelRedirectUrl?: string;
     [key: string]: unknown;
 }
 /**
- * Manage subscription response data.
+ * Cancel order request parameters.
  */
-interface ManageSubscriptionData {
-    subscriptionId?: string;
-    subscriptionStatus?: SubscriptionStatus;
+interface CancelOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantInfo?: MerchantInfo;
+    orderRequestedAt?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription status enum.
- * Based on openapi.json SubscriptionInquiryResponse.subscriptionStatus.
+ * Cancel order response data.
  */
-type SubscriptionStatus = 'AUTHORIZATION_REQUIRED' | 'IN_PROGRESS' | 'ACTIVE' | 'CLOSE' | 'MERCHANT_CANCELLED' | 'USER_CANCELLED' | 'CHANNEL_CANCELLED' | 'EXPIRED';
+interface CancelOrderData {
+    paymentRequestId?: string;
+    merchantOrderId?: string;
+    acquiringOrderId?: string;
+    orderStatus?: OrderStatus;
+    [key: string]: unknown;
+}
 /**
- * Subscription manage action enum.
+ * Refund order request parameters.
  */
-type SubscriptionManageAction = 'PAUSE' | 'RESUME' | 'UPDATE_AMOUNT' | 'UPDATE_PERIOD';
+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;
+}
 /**
- * Period type enum.
- * Values: DAILY, WEEKLY, MONTHLY
+ * Refund order response data.
  */
-type PeriodType = 'DAILY' | 'WEEKLY' | 'MONTHLY';
+interface RefundOrderData {
+    refundRequestId?: string;
+    merchantRefundOrderId?: string;
+    acquiringOrderId?: string;
+    acquiringRefundOrderId?: string;
+    refundAmount?: string;
+    refundStatus?: RefundStatus$1;
+    remainingRefundAmount?: string;
+    [key: string]: unknown;
+}
 /**
- * Product information for subscription.
- * Based on openapi.json ProductInfo schema.
+ * Capture order request parameters.
  */
-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;
-    /**
-     * When the subscription ends (ISO 8601 format).
-     */
-    endDateTime?: string;
-    /**
-     * When the next payment is due (ISO 8601 format).
-     */
-    nextPaymentDateTime?: string;
-    /**
-     * Current billing period number.
-     */
-    currentPeriod?: string;
+interface CaptureOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantId: string;
+    captureAmount?: string;
     [key: string]: unknown;
 }
 /**
- * User information for subscription.
+ * Capture order response data.
  */
-interface SubscriptionUserInfo {
+interface CaptureOrderData {
+    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;
+    /**
+     * User receipt URL (max 256 characters).
+     */
+    userReceiptUrl?: string;
     [key: string]: unknown;
 }
 /**
- * Payment information for subscription.
+ * Payment information.
  */
-interface SubscriptionPaymentInfo {
+interface PaymentInfo {
     productName: string;
     payMethodType?: string;
     payMethodName?: string;
+    payMethodProperties?: string;
     [key: string]: unknown;
 }
 /**
- * Merchant information for subscription.
+ * Merchant information.
  */
-interface SubscriptionMerchantInfo {
+interface MerchantInfo {
     merchantId: string;
     subMerchantId?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change status values.
+ * Goods information.
  */
-type SubscriptionChangeStatus = 'IN_PROGRESS' | 'AUTHORIZATION_REQUIRED' | 'SUCCESS' | 'CLOSED';
+interface GoodsInfo {
+    goodsId?: string;
+    goodsName?: string;
+    goodsCategory?: string;
+    goodsUrl?: string;
+    appName?: string;
+    skuName?: string;
+    goodsUniquePrice?: string;
+    goodsQuantity?: number;
+    [key: string]: unknown;
+}
 /**
- * Product information for subscription change operations.
- * Contains billing period settings for the new subscription plan.
+ * Address information.
  */
-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;
-    /**
-     * Trial period interval (max 12 characters).
-     */
-    trialPeriodInterval?: string;
+interface AddressInfo {
+    address?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    addressCountryCode?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change request parameters.
+ * Card 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 CardInfo {
+    cardNumber?: string;
+    cardExpiryYear?: number;
+    cardExpiryMonth?: number;
+    cardCvv?: string;
+    cardHolderName?: string;
+    threeDsDecision?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change response data.
+ * Risk data.
  */
-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 RiskData {
+    userType?: string;
+    userCategory?: string;
+    userLegalName?: string;
+    userDisplayName?: string;
+    userRegistrationIp?: string;
+    userLastSeenIp?: string;
+    userIsNew?: string;
+    userIsFirstPurchase?: string;
     [key: string]: unknown;
 }
 /**
- * Subscription change inquiry request parameters.
+ * Refund user information.
  */
-interface SubscriptionChangeInquiryParams {
-    /**
-     * Original subscription request ID that was changed.
-     */
-    originSubscriptionRequest: string;
-    /**
-     * New subscription request ID after the change.
-     */
-    subscriptionRequest: string;
+interface RefundUserInfo {
+    userType?: string;
+    userFirstName?: string;
+    userLastName?: string;
+    userEmail?: string;
+    userPhone?: string;
     [key: string]: unknown;
 }
+
 /**
- * Subscription change inquiry response data.
+ * 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());
+ * }
+ * ```
  */
-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[];
+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>>;
 }
 
 /**
@@ -1782,13 +1890,13 @@ declare class Waffo {
      * // Setup webhook handler
      * const handler = waffo.webhook()
      *   .onPayment((notification) => {
-     *     console.log('Payment:', notification.orderStatus);
+     *     console.log('Payment:', notification.result?.orderStatus);
      *   })
      *   .onRefund((notification) => {
-     *     console.log('Refund:', notification.refundStatus);
+     *     console.log('Refund:', notification.result?.refundStatus);
      *   })
      *   .onSubscriptionStatus((notification) => {
-     *     console.log('Subscription:', notification.subscriptionStatus);
+     *     console.log('Subscription:', notification.result?.subscriptionStatus);
      *   });
      *
      * // In Express.js route handler
@@ -2007,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 PeriodType, type ProductInfo, type RefundNotification, type RefundOrderData, type RefundOrderParams, RefundResource, type RefundStatus$1 as RefundStatus, type RefundUserInfo, type RequestOptions, type RiskData, RsaUtils, type SubscriptionManageAction, type SubscriptionMerchantInfo, type SubscriptionPaymentInfo, type SubscriptionPaymentNotification, 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 };