@waffo/waffo-node 2.0.2

package/dist/index.d.mts

@@ -0,0 +1,4639 @@
+/**
+ * @fileoverview Logger Type Definitions
+ * @module types/logger
+ *
+ * Logger interface for SDK debugging. Compatible with `console` and most
+ * logging libraries (winston, pino, bunyan, etc.).
+ *
+ * When provided to the SDK, logs detailed information about:
+ * - HTTP requests/responses
+ * - Signature generation/verification
+ * - Errors and stack traces
+ *
+ * @see {@link WaffoConfig.logger} for configuring the logger
+ *
+ * @example
+ * // Use console for simple debugging
+ * const waffo = new Waffo({
+ *   apiKey: 'key',
+ *   privateKey: 'key',
+ *   logger: console,
+ * });
+ *
+ * @example
+ * // Use a custom logger
+ * const waffo = new Waffo({
+ *   apiKey: 'key',
+ *   privateKey: 'key',
+ *   logger: {
+ *     debug: (msg, ...args) => myLogger.debug(msg, args),
+ *     info: (msg, ...args) => myLogger.info(msg, args),
+ *     warn: (msg, ...args) => myLogger.warn(msg, args),
+ *     error: (msg, ...args) => myLogger.error(msg, args),
+ *   },
+ * });
+ */
+/**
+ * Logger interface for SDK debugging.
+ *
+ * Compatible with `console` and popular logging libraries.
+ *
+ * **Log Levels:**
+ * - `debug` - Detailed debugging (request/response details)
+ * - `info` - Informational messages (operation status)
+ * - `warn` - Warnings (signature issues, retries)
+ * - `error` - Errors (network failures, parsing errors)
+ *
+ * @interface Logger
+ *
+ * @example
+ * // Simply use console
+ * const config: WaffoConfig = {
+ *   apiKey: 'key',
+ *   privateKey: 'key',
+ *   logger: console,
+ * };
+ */
+interface Logger {
+    /** Log detailed debugging information */
+    debug: (message: string, ...args: unknown[]) => void;
+    /** Log general informational messages */
+    info: (message: string, ...args: unknown[]) => void;
+    /** Log warning messages */
+    warn: (message: string, ...args: unknown[]) => void;
+    /** Log error messages */
+    error: (message: string, ...args: unknown[]) => void;
+}
+
+/**
+ * @fileoverview SDK Configuration Type Definitions
+ * @module types/config
+ *
+ * Configuration types for the Waffo SDK:
+ * - Environment settings (SANDBOX/PRODUCTION)
+ * - SDK initialization configuration
+ * - HTTP request options
+ *
+ * @see {@link Waffo} for SDK initialization
+ * @see {@link HttpClient} for making API requests
+ *
+ * @example
+ * import { Environment, WaffoConfig } from 'waffo-sdk';
+ *
+ * const config: WaffoConfig = {
+ *   apiKey: 'your-api-key',
+ *   privateKey: 'your-private-key',
+ *   environment: Environment.SANDBOX,
+ * };
+ */
+
+/**
+ * SDK runtime environment.
+ *
+ * - **SANDBOX**: Development and testing (no real transactions)
+ * - **PRODUCTION**: Live transactions with real payments
+ *
+ * @enum {string}
+ * @readonly
+ *
+ * @example
+ * import { Environment } from 'waffo-sdk';
+ *
+ * // Use sandbox for testing
+ * const waffo = new Waffo({
+ *   apiKey: 'test-key',
+ *   privateKey: 'test-private-key',
+ *   environment: Environment.SANDBOX,
+ * });
+ *
+ * // Use production for live payments
+ * const waffoProd = new Waffo({
+ *   apiKey: process.env.WAFFO_API_KEY,
+ *   privateKey: process.env.WAFFO_PRIVATE_KEY,
+ *   environment: Environment.PRODUCTION,
+ * });
+ */
+declare enum Environment {
+    /** Sandbox testing environment */
+    SANDBOX = "sandbox",
+    /** Production environment for live transactions */
+    PRODUCTION = "production"
+}
+/**
+ * Maps environments to their API base URLs.
+ *
+ * | Environment | Base URL |
+ * |-------------|----------|
+ * | SANDBOX | https://api-sandbox.waffo.com/api/v1 |
+ * | PRODUCTION | https://api.waffo.com/api/v1 |
+ *
+ * @constant
+ * @type {Record<Environment, string>}
+ */
+declare const EnvironmentUrls: Record<Environment, string>;
+/**
+ * Maps environments to Waffo's RSA public keys.
+ *
+ * Used to verify API response signatures. Keys are Base64 encoded X509/SPKI DER format.
+ * These are embedded in the SDK and updated when Waffo rotates their keys.
+ *
+ * @constant
+ * @type {Record<Environment, string>}
+ * @remarks To use a custom public key, provide it via the `waffoPublicKey` config option.
+ */
+declare const EnvironmentPublicKeys: Record<Environment, string>;
+/**
+ * Configuration for initializing the Waffo SDK.
+ *
+ * **Required:**
+ * - `apiKey` - Your API key from Waffo
+ * - `privateKey` - Your merchant private key for signing requests
+ *
+ * **Optional:**
+ * - `waffoPublicKey` - Override the built-in Waffo public key
+ * - `environment` - API environment (defaults to PRODUCTION)
+ * - `timeout` - Request timeout in milliseconds (defaults to 30000)
+ * - `logger` - Logger instance for debugging
+ *
+ * @interface WaffoConfig
+ *
+ * @example
+ * const config: WaffoConfig = {
+ *   apiKey: process.env.WAFFO_API_KEY!,
+ *   privateKey: process.env.WAFFO_PRIVATE_KEY!,
+ *   environment: Environment.PRODUCTION,
+ *   timeout: 60000,
+ *   logger: console,
+ * };
+ *
+ * @see {@link Waffo} for SDK initialization
+ * @see {@link Environment} for available environments
+ */
+interface WaffoConfig {
+    /** API key assigned by Waffo (required) */
+    apiKey: string;
+    /** Merchant private key, Base64 encoded PKCS8 DER format (required) */
+    privateKey: string;
+    /** Waffo's public key for response verification (defaults to built-in) */
+    waffoPublicKey?: string;
+    /** SDK runtime environment (defaults to PRODUCTION) */
+    environment?: Environment;
+    /** HTTP request timeout in milliseconds (defaults to 30000) */
+    timeout?: number;
+    /** Logger instance for debugging */
+    logger?: Logger;
+}
+/**
+ * Options for individual HTTP requests.
+ *
+ * Used when calling {@link HttpClient.post} directly.
+ *
+ * @interface RequestOptions
+ * @template B - Request body type (defaults to `Record<string, unknown>`)
+ *
+ * @example
+ * const options: RequestOptions<CreateOrderParams> = {
+ *   body: { paymentRequestId: '123', ... },
+ *   headers: { 'X-Custom-Header': 'value' },
+ * };
+ *
+ * @see {@link HttpClient.post} for making HTTP requests
+ */
+interface RequestOptions<B extends object = Record<string, unknown>> {
+    /** Request body (will be JSON serialized and signed) */
+    body?: B;
+    /** Additional HTTP headers to include */
+    headers?: Record<string, string>;
+}
+
+/**
+ * @fileoverview Common Network Type Definitions
+ * @module types/network
+ *
+ * Common network-related types shared across HTTP client and webhook handling:
+ * - HTTP status codes
+ * - Signature header interface
+ */
+/**
+ * Standard HTTP status codes used in API responses.
+ *
+ * @enum {number}
+ * @readonly
+ *
+ * @example
+ * if (result.statusCode === HttpStatusCode.OK) {
+ *   console.log('Request successful');
+ * } else if (result.statusCode === HttpStatusCode.REQUEST_TIMEOUT) {
+ *   console.log('Request timed out');
+ * }
+ */
+declare enum HttpStatusCode {
+    OK = 200,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    PAYMENT_REQUIRED = 402,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    REQUEST_TIMEOUT = 408,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504
+}
+/**
+ * Common header structure containing RSA-SHA256 signature.
+ *
+ * Used in API responses and webhook requests/responses.
+ *
+ * @interface SignatureHeader
+ */
+interface SignatureHeader {
+    /** RSA-SHA256 signature (Base64 encoded) */
+    "X-SIGNATURE": string;
+    /** MIME type (typically "application/json") */
+    "Content-Type": string;
+}
+
+/**
+ * @fileoverview HTTP Client Type Definitions
+ * @module types/httpClient
+ *
+ * Types for the HTTP client:
+ * - SDK API response wrapper
+ * - Waffo API response format definitions
+ *
+ * @see {@link HttpClient} for making API requests
+ *
+ * @example
+ * import { ApiResponse, HttpStatusCode } from 'waffo-sdk';
+ *
+ * const result: ApiResponse<CreateOrderData> = await waffo.order.create(params);
+ * if (result.success && result.statusCode === HttpStatusCode.OK) {
+ *   console.log('Order created:', result.data);
+ * }
+ */
+
+/**
+ * Standard response format for all SDK API calls.
+ *
+ * @interface ApiResponse
+ * @template T - Type of response data on success
+ *
+ * @example
+ * const result: ApiResponse<CreateOrderData> = await waffo.order.create(params);
+ *
+ * if (result.success) {
+ *   console.log('Order ID:', result.data.acquiringOrderId);
+ * } else {
+ *   console.error('Error:', result.error);
+ *   console.log('HTTP Status:', result.statusCode);
+ * }
+ */
+interface ApiResponse<T = unknown> {
+    /** Whether the API request was successful */
+    success: boolean;
+    /** HTTP status code of the response */
+    statusCode: HttpStatusCode;
+    /** Business data (only on success) */
+    data?: T;
+    /** Error message (only on failure) */
+    error?: string;
+}
+/**
+ * HTTP response header from Waffo API.
+ * @type WaffoResponseHeader
+ */
+type WaffoResponseHeader = SignatureHeader;
+/**
+ * Standard response body from all Waffo API endpoints.
+ *
+ * - code "0" = success
+ * - other codes (A0xxx, B0xxx, C0xxx, S0xxx) = errors
+ *
+ * @interface WaffoResponseBody
+ * @template T - Type of business data in `data` field
+ */
+interface WaffoResponseBody<T = unknown> {
+    /** Response code: "0" for success, error codes otherwise */
+    code: string;
+    /** Human-readable result message */
+    msg: string;
+    /** Business data payload (on success) */
+    data?: T;
+}
+/**
+ * Complete response structure from Waffo API.
+ *
+ * @interface WaffoApiResponse
+ * @template T - Type of business data
+ */
+interface WaffoApiResponse<T = unknown> {
+    /** Response headers with signature */
+    header: WaffoResponseHeader;
+    /** Response body with code, message, and data */
+    body: WaffoResponseBody<T>;
+}
+
+/**
+ * @fileoverview Payment Related Enumeration Definitions
+ * @module types/payment
+ *
+ * Payment-related enumerations shared across Order, Subscription, and Config resources:
+ * - **{@link ProductName}** - Payment product types for acquiring API
+ * - **{@link SubscriptionProductName}** - Product types for subscription API
+ *
+ * @see {@link PaymentInfo} for payment configuration
+ * @see {@link CreateOrderParams} for order creation
+ *
+ * @example
+ * import { ProductName } from 'waffo-sdk';
+ *
+ * const paymentInfo = {
+ *   productName: ProductName.ONE_TIME_PAYMENT,
+ *   payMethodName: 'DANA',
+ * };
+ */
+/**
+ * Payment product type for acquiring API.
+ *
+ * @enum {string}
+ * @readonly
+ *
+ * @example
+ * paymentInfo: {
+ *   productName: ProductName.ONE_TIME_PAYMENT,
+ *   payMethodName: 'DANA',
+ * }
+ */
+declare enum ProductName {
+    /** Standard payment with redirect flow */
+    ONE_TIME_PAYMENT = "ONE_TIME_PAYMENT",
+    /** Payment within mini program environment */
+    MINI_PROGRAM_PAYMENT = "MINI_PROGRAM_PAYMENT",
+    /** Card payment (requires PCI-DSS compliance) */
+    DIRECT_PAYMENT = "DIRECT_PAYMENT"
+}
+/**
+ * Payment product type for subscription API.
+ *
+ * @enum {string}
+ * @readonly
+ *
+ * @example
+ * paymentInfo: {
+ *   productName: SubscriptionProductName.SUBSCRIPTION,
+ *   payMethodName: 'ALIPAY_HK',
+ * }
+ */
+declare enum SubscriptionProductName {
+    /** Web-based subscription signing */
+    SUBSCRIPTION = "SUBSCRIPTION",
+    /** Subscription within mini program */
+    MINI_PROGRAM_SUBSCRIPTION = "MINI_PROGRAM_SUBSCRIPTION"
+}
+
+/**
+ * @fileoverview Common/Shared Type Definitions
+ * @module types/common
+ *
+ * Shared enums and types used across multiple resource modules.
+ * This file helps avoid circular dependencies between type modules.
+ */
+/**
+ * Risk User Type Enum
+ *
+ * @description
+ * User type for risk assessment data.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum RiskUserType {
+    INDIVIDUAL = "Individual",
+    AGENT = "Agent",
+    INSTITUTION = "Institution",
+    INTERNAL = "Internal"
+}
+/**
+ * Refund User Type Enum
+ *
+ * @description
+ * User type for refund processing.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum RefundUserType {
+    INDIVIDUAL = "INDIVIDUAL",
+    BUSINESS = "BUSINESS"
+}
+
+/**
+ * @fileoverview Order Resource Type Definitions
+ * @module types/order
+ *
+ * Type definitions for the Order resource (based on Waffo API JSON Schema).
+ *
+ * **Categories:**
+ * - **Enums:** Order status, action types, payment modes
+ * - **Request Interfaces:** Parameters for create, inquiry, cancel, refund, capture
+ * - **Response Interfaces:** API response data structures
+ * - **Webhook Interfaces:** Payment notification structures
+ *
+ * @see {@link OrderResource} for API methods
+ * @see {@link CreateOrderParams} for order creation
+ *
+ * @example
+ * import {
+ *   CreateOrderParams,
+ *   OrderStatus,
+ *   ProductName,
+ *   UserTerminalType,
+ * } from 'waffo-sdk';
+ *
+ * const params: CreateOrderParams = {
+ *   paymentRequestId: 'req-123',
+ *   merchantOrderId: 'order-456',
+ *   orderCurrency: 'USD',
+ *   orderAmount: '10.00',
+ *   // ...
+ * };
+ */
+
+/**
+ * User Terminal Type Enum
+ *
+ * @description
+ * Identifies the terminal environment where the user initiates payment.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum UserTerminalType {
+    WEB = "WEB",
+    APP = "APP",
+    IN_WALLET_APP = "IN_WALLET_APP",
+    IN_MINI_PROGRAM = "IN_MINI_PROGRAM"
+}
+/**
+ * Order Status Enum
+ *
+ * @description
+ * Identifies the current status of an order in the payment process.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum OrderStatus {
+    PAY_IN_PROGRESS = "PAY_IN_PROGRESS",
+    AUTHORIZATION_REQUIRED = "AUTHORIZATION_REQUIRED",
+    AUTHED_WAITING_CAPTURE = "AUTHED_WAITING_CAPTURE",
+    PAY_SUCCESS = "PAY_SUCCESS",
+    ORDER_CLOSE = "ORDER_CLOSE",
+    CAPTURE_IN_PROGRESS = "CAPTURE_IN_PROGRESS"
+}
+/**
+ * Order Action Type Enum
+ *
+ * @description
+ * Indicates the redirect method for user to complete payment authorization.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum OrderActionType {
+    WEB = "WEB",
+    DEEPLINK = "DEEPLINK"
+}
+/**
+ * Pay Method User Account Type Enum
+ *
+ * @description
+ * User account type at the designated pay method.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum PayMethodUserAccountType {
+    EMAIL = "EMAIL",
+    PHONE_NO = "PHONE_NO",
+    ACCOUNT_ID = "ACCOUNT_ID"
+}
+/**
+ * Capture Mode Enum
+ *
+ * @description
+ * Capture mode for order payment.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum CaptureMode {
+    MANUAL_CAPTURE = "manualCapture"
+}
+/**
+ * Merchant Initiated Mode Enum
+ *
+ * @description
+ * MIT mode for merchant initiated transactions.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum MerchantInitiatedMode {
+    SCHEDULED = "scheduled",
+    UNSCHEDULED = "unscheduled"
+}
+/**
+ * 3DS Decision Enum
+ *
+ * @description
+ * Merchant 3DS decision for card payments.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum ThreeDsDecision {
+    FORCE = "3DS_FORCE",
+    ATTEMPT = "3DS_ATTEMPT",
+    NO_3DS = "NO_3DS"
+}
+/**
+ * Merchant Information Interface (Request Parameters)
+ *
+ * @description
+ * Used to identify the merchant initiating the request.
+ *
+ * @interface MerchantInfo
+ */
+interface MerchantInfo {
+    merchantId: string;
+    subMerchantId?: string;
+}
+/**
+ * User Information Interface (Request Parameters)
+ *
+ * @description
+ * Basic information of the paying user, used for risk control and user identification.
+ *
+ * @interface UserInfo
+ */
+interface UserInfo {
+    userId: string;
+    userEmail: string;
+    userPhone?: string;
+    userCountryCode?: string;
+    userTerminal: UserTerminalType | string;
+    userFirstName?: string;
+    userLastName?: string;
+    userCreatedAt?: string;
+    userBrowserIp?: string;
+    userAgent?: string;
+}
+/**
+ * Goods Information Interface (Request Parameters)
+ *
+ * @description
+ * Product or service information associated with the order.
+ *
+ * @interface GoodsInfo
+ */
+interface GoodsInfo {
+    goodsId?: string;
+    goodsName: string;
+    goodsCategory?: string;
+    goodsUrl?: string;
+    appName?: string;
+    skuName?: string;
+    goodsUniquePrice?: string;
+    goodsQuantity?: number | string;
+}
+/**
+ * Address Information Interface (Request Parameters)
+ *
+ * @description
+ * Shipping address information for the order, used for risk control and logistics.
+ *
+ * @interface AddressInfo
+ */
+interface AddressInfo {
+    address?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    addressCountryCode?: string;
+}
+/**
+ * Payment Method Properties Interface (Request Parameters)
+ *
+ * @description
+ * Additional properties required for specific payment methods.
+ *
+ * @interface PayMethodProperties
+ */
+interface PayMethodProperties {
+    cpf?: string;
+    cardPrefix?: string;
+    cardPrefixPurpose?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Cashier Appearance Interface (Request Parameters)
+ *
+ * @description
+ * Cashier UI appearance variables.
+ *
+ * @interface CashierAppearance
+ */
+interface CashierAppearance {
+    variables?: {
+        colorPrimary?: string;
+        colorBackground?: string;
+        colorText?: string;
+        [key: string]: string | undefined;
+    };
+}
+/**
+ * Card Information Interface (Request Parameters)
+ *
+ * @description
+ * Card information for direct card payment, only applicable for PCI-DSS certified merchants.
+ *
+ * @interface CardInfo
+ * @warning This interface involves sensitive card data, ensure PCI-DSS compliance
+ */
+interface CardInfo {
+    cardNumber: string;
+    cardExpiryYear: string;
+    cardExpiryMonth: string;
+    cardCvv: string;
+    cardHolderName: string;
+    threeDsDecision?: ThreeDsDecision | string;
+}
+/**
+ * Payment Information Interface (Request Parameters)
+ *
+ * @description
+ * Specify payment product, method, and mode.
+ *
+ * @interface PaymentInfo
+ */
+interface PaymentInfo {
+    productName: ProductName | string;
+    /**
+     * Payment type (max 256 characters)
+     * Example values: "EWALLET", "CREDITCARD", "BANKTRANSFER", "ONLINE_BANKING", "DIGITAL_BANKING", "OTC", "DEBITCARD"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodType?: string;
+    /**
+     * Specific payment method (max 24 characters)
+     * Example E-wallets: "OVO", "DANA", "GOPAY", "SHOPEEPAY", "GCASH", "ALIPAY_HK"
+     * Example Credit Cards: "CC_VISA", "CC_MASTERCARD"
+     * Example Bank Transfer: "VA_BCA", "VA_BNI"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodName?: string;
+    payMethodCountry?: string;
+    payMethodProperties?: PayMethodProperties | string;
+    payMethodUserAccountType?: PayMethodUserAccountType | string;
+    payMethodUserAccountNo?: string;
+    cashierLanguage?: string;
+    cashierAppearance?: CashierAppearance;
+    userPaymentAccessToken?: string;
+    captureMode?: CaptureMode | string;
+    merchantInitiatedMode?: MerchantInitiatedMode | string;
+}
+/**
+ * Risk Data Interface (Request Parameters)
+ *
+ * @description
+ * Auxiliary data for risk assessment.
+ *
+ * @interface RiskData
+ */
+interface RiskData {
+    userType?: RiskUserType;
+    userCategory?: string;
+    userLegalName?: string;
+    userDisplayName?: string;
+    userRegistrationIp?: string;
+    userLastSeenIp?: string;
+    userIsNew?: string;
+    userIsFirstPurchase?: string;
+}
+/**
+ * User Bank Information Interface (Request Parameters)
+ *
+ * @description
+ * Bank account information for bank transfer and similar payment method refunds.
+ *
+ * @interface UserBankInfo
+ */
+interface UserBankInfo {
+    bankAccountNo: string;
+    bankCode: string;
+    bankCity?: string;
+    bankBranch?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Refund User Information Interface (Request Parameters)
+ *
+ * @description
+ * User information required for refunds with specific payment methods.
+ *
+ * @interface RefundUserInfo
+ */
+interface RefundUserInfo {
+    userType?: RefundUserType;
+    userFirstName?: string;
+    userLastName?: string;
+    userEmail?: string;
+    userBankInfo?: UserBankInfo | string;
+    userPhone?: string;
+    userIDType?: string;
+    userIDNumber?: string;
+    userIDIssueDate?: string;
+    userIDExpiryDate?: string;
+}
+/**
+ * Create Order Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.order.create()`.
+ *
+ * @interface CreateOrderParams
+ */
+interface CreateOrderParams {
+    paymentRequestId: string;
+    merchantOrderId: string;
+    orderCurrency: string;
+    orderAmount: string;
+    orderDescription: string;
+    userCurrency?: string;
+    merchantInfo: MerchantInfo;
+    userInfo: UserInfo;
+    goodsInfo: GoodsInfo;
+    addressInfo?: AddressInfo;
+    paymentInfo: PaymentInfo;
+    cardInfo?: CardInfo;
+    PaymentTokenData?: string;
+    orderRequestedAt?: string;
+    orderExpiredAt?: string;
+    successRedirectUrl?: string;
+    failedRedirectUrl?: string;
+    cancelRedirectUrl?: string;
+    notifyUrl: string;
+    riskData?: RiskData;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Inquiry Order Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.order.inquiry()`.
+ *
+ * @interface InquiryOrderParams
+ */
+interface InquiryOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+}
+/**
+ * Cancel Order Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.order.cancel()`.
+ *
+ * @interface CancelOrderParams
+ */
+interface CancelOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantId: string;
+    orderRequestedAt?: string;
+}
+/**
+ * Order Refund Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.order.refund()`.
+ *
+ * @interface RefundOrderParams
+ */
+interface RefundOrderParams {
+    refundRequestId: string;
+    acquiringOrderId: string;
+    merchantRefundOrderId?: string;
+    merchantId: string;
+    requestedAt?: string;
+    refundAmount: string;
+    refundReason: string;
+    refundNotifyUrl?: string;
+    userInfo?: RefundUserInfo;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Capture Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.order.capture()`.
+ *
+ * @interface CaptureOrderParams
+ */
+interface CaptureOrderParams {
+    paymentRequestId?: string;
+    acquiringOrderId?: string;
+    merchantId: string;
+    captureRequestedAt?: string;
+    captureAmount: string;
+}
+/**
+ * Order Action Data Interface (Response)
+ *
+ * @description
+ * Payment data for merchant's custom checkout page.
+ *
+ * @interface OrderActionData
+ */
+interface OrderActionData {
+    paymentExpiryTime?: string;
+    paymentQr?: string;
+    paymentCode?: string;
+    paymentBarCode?: string;
+    paymentCurrency?: string;
+    paymentAmount?: string;
+    userFeeAmount?: string;
+    userFeeCurrency?: string;
+    exchangeRate?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Order Action Interface (Response)
+ *
+ * @description
+ * Returned when order status is AUTHORIZATION_REQUIRED.
+ *
+ * @interface OrderAction
+ */
+interface OrderAction {
+    actionType: OrderActionType | string;
+    webUrl?: string;
+    deeplinkUrl?: string;
+    actionData?: OrderActionData;
+}
+/**
+ * Merchant Information Interface (Response)
+ *
+ * @description
+ * Merchant information associated with the order.
+ *
+ * @interface MerchantInfoResponse
+ */
+interface MerchantInfoResponse {
+    merchantId: string;
+    subMerchantId?: string;
+}
+/**
+ * User Information Interface (Response)
+ *
+ * @description
+ * User information associated with the order.
+ *
+ * @interface UserInfoResponse
+ */
+interface UserInfoResponse {
+    userId: string;
+    userEmail: string;
+    userPhone?: string;
+    userCountryCode?: string;
+    userTerminal: UserTerminalType | string;
+    userFirstName?: string;
+    userLastName?: string;
+    userCreatedAt?: string;
+    userBrowserIp?: string;
+    userAgent?: string;
+}
+/**
+ * Goods Information Interface (Response)
+ *
+ * @description
+ * Product information associated with the order.
+ *
+ * @interface GoodsInfoResponse
+ */
+interface GoodsInfoResponse {
+    goodsId?: string;
+    goodsName: string;
+    goodsCategory?: string;
+    goodsUrl?: string;
+    appName?: string;
+    skuName?: string;
+    goodsUniquePrice?: string;
+    goodsQuantity?: number | string;
+}
+/**
+ * Address Information Interface (Response)
+ *
+ * @description
+ * Address information associated with the order.
+ *
+ * @interface AddressInfoResponse
+ */
+interface AddressInfoResponse {
+    address?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    addressCountryCode?: string;
+}
+/**
+ * Payment Method Response Data Interface (Response)
+ *
+ * @description
+ * Specific data returned by payment channel.
+ *
+ * @interface PayMethodResponse
+ */
+interface PayMethodResponse {
+    payMethodRefId?: string;
+    exchangeRate?: string;
+    userOpenId?: string;
+    maskCardData?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Payment Information Interface (Response)
+ *
+ * @description
+ * Payment method details for the order.
+ *
+ * @interface PaymentInfoResponse
+ */
+interface PaymentInfoResponse {
+    productName: ProductName | string;
+    /**
+     * Payment type (max 256 characters)
+     * Example values: "EWALLET", "CREDITCARD", "BANKTRANSFER", "ONLINE_BANKING", "DIGITAL_BANKING", "OTC", "DEBITCARD"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodType: string;
+    /**
+     * Specific payment method (max 24 characters)
+     * Example E-wallets: "OVO", "DANA", "GOPAY", "SHOPEEPAY", "GCASH", "ALIPAY_HK"
+     * Example Credit Cards: "CC_VISA", "CC_MASTERCARD"
+     * Example Bank Transfer: "VA_BCA", "VA_BNI"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodName: string;
+    payMethodCountry?: string;
+    payMethodProperties?: PayMethodProperties | string;
+    payMethodResponse?: PayMethodResponse | string;
+    payMethodUserAccountType?: PayMethodUserAccountType | string;
+    payMethodUserAccountNo?: string;
+    cashierLanguage?: string;
+    payOption?: string;
+    userPaymentAccessToken?: string;
+    captureMode?: CaptureMode | string;
+    merchantInitiatedMode?: MerchantInitiatedMode | string;
+}
+/**
+ * Order Failed Reason Interface (Response)
+ *
+ * @description
+ * Error details when order fails.
+ *
+ * @interface OrderFailedReason
+ */
+interface OrderFailedReason {
+    orderFailedCode: string;
+    orderFailedDescription: string;
+}
+/**
+ * Create Order Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.order.create()`.
+ *
+ * @interface CreateOrderData
+ */
+interface CreateOrderData {
+    paymentRequestId: string;
+    merchantOrderId: string;
+    acquiringOrderId: string;
+    orderStatus: OrderStatus | string;
+    orderAction?: OrderAction;
+}
+/**
+ * Order Inquiry Response Data Interface
+ *
+ * @description
+ * Complete order details returned by `waffo.order.inquiry()`.
+ *
+ * @interface InquiryOrderData
+ */
+interface InquiryOrderData {
+    paymentRequestId: string;
+    merchantOrderId: string;
+    acquiringOrderId: string;
+    orderStatus: OrderStatus | string;
+    orderAction?: OrderAction;
+    orderCurrency: string;
+    orderAmount: string;
+    userCurrency?: string;
+    finalDealAmount: string;
+    orderDescription: string;
+    merchantInfo: MerchantInfoResponse;
+    userInfo: UserInfoResponse;
+    goodsInfo?: GoodsInfoResponse;
+    addressInfo?: AddressInfoResponse;
+    paymentInfo: PaymentInfoResponse;
+    orderRequestedAt: string;
+    orderExpiredAt?: string;
+    orderUpdatedAt: string;
+    orderCompletedAt: string;
+    orderFailedReason?: OrderFailedReason | string;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Cancel Order Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.order.cancel()`.
+ *
+ * @interface CancelOrderData
+ */
+interface CancelOrderData {
+    paymentRequestId: string;
+    merchantOrderId: string;
+    acquiringOrderId: string;
+    orderStatus: OrderStatus.ORDER_CLOSE | string;
+}
+/**
+ * Capture Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.order.capture()`.
+ *
+ * @interface CaptureOrderData
+ */
+interface CaptureOrderData {
+    paymentRequestId: string;
+    merchantOrderId: string;
+    acquiringOrderId: string;
+    orderStatus: OrderStatus | string;
+}
+/**
+ * Payment Notification Result Interface
+ *
+ * @description
+ * Payload for PAYMENT_NOTIFICATION webhook (one-time/direct payment).
+ *
+ * @interface PaymentNotificationResult
+ */
+interface PaymentNotificationResult {
+    paymentRequestId: string;
+    merchantOrderId: string;
+    acquiringOrderId: string;
+    orderStatus: OrderStatus | string;
+    orderAction?: OrderAction;
+    orderCurrency: string;
+    orderAmount: string;
+    userCurrency?: string;
+    finalDealAmount: string;
+    orderDescription: string;
+    merchantInfo: MerchantInfoResponse;
+    userInfo: UserInfoResponse;
+    goodsInfo?: GoodsInfoResponse;
+    addressInfo?: AddressInfoResponse;
+    paymentInfo: PaymentInfoResponse;
+    orderRequestedAt: string;
+    orderExpiredAt?: string;
+    orderUpdatedAt: string;
+    orderCompletedAt: string;
+    orderFailedReason?: OrderFailedReason | string;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Payment Notification Interface
+ *
+ * @description
+ * Webhook notification for payment order status changes.
+ *
+ * @interface PaymentNotification
+ */
+interface PaymentNotification {
+    eventType: WebhookEventType.PAYMENT_NOTIFICATION;
+    result: PaymentNotificationResult;
+}
+/**
+ * Payment Webhook Request Interface
+ *
+ * @description
+ * Full structure of payment notification webhook request from Waffo.
+ *
+ * @interface PaymentWebhookRequest
+ */
+interface PaymentWebhookRequest {
+    header: WebhookRequestHeader;
+    body: PaymentNotification;
+}
+
+/**
+ * @fileoverview Refund Resource Type Definitions
+ * @module types/refund
+ *
+ * Type definitions for the Refund resource (based on Waffo API JSON Schema).
+ *
+ * **Categories:**
+ * - **Enums:** Refund status states
+ * - **Request Interfaces:** Parameters for refund inquiry
+ * - **Response Interfaces:** Refund data structures
+ * - **Webhook Interfaces:** Refund notification structures
+ *
+ * @see {@link RefundResource} for API methods
+ * @see {@link RefundInquiryParams} for inquiry parameters
+ *
+ * @example
+ * import { RefundStatus, RefundInquiryParams } from 'waffo-sdk';
+ *
+ * const params: RefundInquiryParams = {
+ *   refundRequestId: 'refund-123',
+ * };
+ */
+
+/**
+ * Refund Status Enum
+ *
+ * @description
+ * Identifies the current status of a refund request in the processing flow.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum RefundStatus {
+    REFUND_IN_PROGRESS = "REFUND_IN_PROGRESS",
+    ORDER_PARTIALLY_REFUNDED = "ORDER_PARTIALLY_REFUNDED",
+    ORDER_FULLY_REFUNDED = "ORDER_FULLY_REFUNDED",
+    ORDER_REFUND_FAILED = "ORDER_REFUND_FAILED"
+}
+/**
+ * Refund Inquiry Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.refund.inquiry()`.
+ *
+ * @interface RefundInquiryParams
+ */
+interface RefundInquiryParams {
+    refundRequestId?: string;
+    acquiringRefundOrderId?: string;
+}
+/**
+ * Refund Failed Reason Interface (Response)
+ *
+ * @description
+ * Error details when refund fails.
+ *
+ * @interface RefundFailedReason
+ */
+interface RefundFailedReason {
+    refundFailedCode: string;
+    refundFailedDescription: string;
+}
+/**
+ * Refund User Bank Information Interface (Response)
+ *
+ * @description
+ * Bank account information returned for bank transfer refunds.
+ *
+ * @interface RefundUserBankInfo
+ */
+interface RefundUserBankInfo {
+    bankAccountNo: string;
+    bankCode: string;
+    bankCity?: string;
+    bankBranch?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Refund User Information Interface (Response)
+ *
+ * @description
+ * User information returned for specific payment method refunds.
+ *
+ * @interface RefundUserInfoResponse
+ */
+interface RefundUserInfoResponse {
+    userType?: RefundUserType;
+    userFirstName?: string;
+    userLastName?: string;
+    userEmail?: string;
+    userBankInfo?: RefundUserBankInfo | string;
+    userPhone?: string;
+    userIDType?: string;
+    userIDNumber?: string;
+    userIDIssueDate?: string;
+    userIDExpiryDate?: string;
+}
+/**
+ * Create Refund Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.order.refund()`.
+ *
+ * @interface CreateRefundData
+ */
+interface CreateRefundData {
+    refundRequestId: string;
+    merchantRefundOrderId?: string;
+    acquiringOrderId: string;
+    acquiringRefundOrderId: string;
+    refundAmount: string;
+    refundStatus: RefundStatus | string;
+    remainingRefundAmount: string;
+}
+/**
+ * Refund Inquiry Response Data Interface
+ *
+ * @description
+ * Complete refund details returned by `waffo.refund.inquiry()`.
+ *
+ * @interface InquiryRefundData
+ */
+interface InquiryRefundData {
+    refundRequestId: string;
+    merchantRefundOrderId?: string;
+    acquiringOrderId: string;
+    acquiringRefundOrderId: string;
+    origPaymentRequestId: string;
+    refundAmount: string;
+    refundStatus: RefundStatus | string;
+    remainingRefundAmount: string;
+    userCurrency?: string;
+    finalDealAmount: string;
+    refundReason: string;
+    refundRequestedAt: string;
+    refundUpdatedAt: string;
+    refundCompletedAt: string;
+    refundFailedReason?: RefundFailedReason | string;
+    userInfo?: RefundUserInfoResponse;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Refund Notification Result Interface
+ *
+ * @description
+ * Payload for REFUND_NOTIFICATION webhook.
+ *
+ * @interface RefundNotificationResult
+ */
+interface RefundNotificationResult {
+    refundRequestId: string;
+    merchantRefundOrderId?: string;
+    acquiringOrderId: string;
+    acquiringRefundOrderId: string;
+    origPaymentRequestId: string;
+    refundAmount: string;
+    refundStatus: RefundStatus | string;
+    remainingRefundAmount: string;
+    userCurrency?: string;
+    finalDealAmount: string;
+    refundReason: string;
+    refundRequestedAt: string;
+    refundUpdatedAt: string;
+    refundCompletedAt: string;
+    refundFailedReason?: RefundFailedReason | string;
+    userInfo?: RefundUserInfoResponse;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Refund Notification Interface
+ *
+ * @description
+ * Webhook notification for refund order status changes.
+ *
+ * @interface RefundNotification
+ */
+interface RefundNotification {
+    eventType: WebhookEventType.REFUND_NOTIFICATION;
+    result: RefundNotificationResult;
+}
+/**
+ * Refund Webhook Request Interface
+ *
+ * @description
+ * Full structure of refund notification webhook request from Waffo.
+ *
+ * @interface RefundWebhookRequest
+ */
+interface RefundWebhookRequest {
+    header: WebhookRequestHeader;
+    body: RefundNotification;
+}
+
+/**
+ * @fileoverview Subscription Resource Type Definitions
+ * @module types/subscription
+ *
+ * Type definitions for the Subscription resource (based on Waffo API JSON Schema).
+ *
+ * **Categories:**
+ * - **Enums:** Subscription status, period types, event types
+ * - **Request Interfaces:** Parameters for create, inquiry, cancel, manage
+ * - **Response Interfaces:** Subscription data structures
+ * - **Webhook Interfaces:** Subscription notification structures
+ *
+ * @see {@link SubscriptionResource} for API methods
+ * @see {@link CreateSubscriptionParams} for subscription creation
+ *
+ * @example
+ * import {
+ *   CreateSubscriptionParams,
+ *   SubscriptionStatus,
+ *   PeriodType,
+ * } from 'waffo-sdk';
+ *
+ * const params: CreateSubscriptionParams = {
+ *   subscriptionRequest: 'sub-123',
+ *   currency: 'USD',
+ *   amount: '9.99',
+ *   productInfo: {
+ *     description: 'Monthly Plan',
+ *     periodType: PeriodType.MONTHLY,
+ *     periodInterval: '1',
+ *   },
+ *   // ...
+ * };
+ */
+
+/**
+ * Subscription Status Enum
+ *
+ * @description
+ * Identifies the current status of a subscription.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum SubscriptionStatus {
+    AUTHORIZATION_REQUIRED = "AUTHORIZATION_REQUIRED",
+    IN_PROGRESS = "IN_PROGRESS",
+    ACTIVE = "ACTIVE",
+    CLOSE = "CLOSE",
+    MERCHANT_CANCELLED = "MERCHANT_CANCELLED",
+    USER_CANCELLED = "USER_CANCELLED",
+    CHANNEL_CANCELLED = "CHANNEL_CANCELLED",
+    EXPIRED = "EXPIRED"
+}
+/**
+ * Period Type Enum
+ *
+ * @description
+ * Billing period type for subscription.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum PeriodType {
+    DAILY = "DAILY",
+    WEEKLY = "WEEKLY",
+    MONTHLY = "MONTHLY"
+}
+/**
+ * User Terminal Type Enum
+ *
+ * @description
+ * Identifies the terminal environment where the user initiates subscription.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum SubscriptionUserTerminalType {
+    WEB = "WEB",
+    APP = "APP"
+}
+/**
+ * Cashier Language Enum
+ *
+ * @description
+ * Supported cashier languages.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum CashierLanguage {
+    EN_HK = "en-HK",
+    ZH_HANT_HK = "zh-Hant-HK",
+    ZH_HANS_HK = "zh-Hans-HK"
+}
+/**
+ * Pay Method User Account Type Enum
+ *
+ * @description
+ * User account type at the designated pay method.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum SubscriptionPayMethodUserAccountType {
+    EMAIL = "EMAIL",
+    PHONE_NO = "PHONE_NO",
+    ACCOUNT_ID = "ACCOUNT_ID"
+}
+/**
+ * Subscription Order Status Enum
+ *
+ * @description
+ * Status for subscription payment order.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum SubscriptionOrderStatus {
+    PAY_SUCCESS = "PAY_SUCCESS",
+    ORDER_CLOSE = "ORDER_CLOSE"
+}
+/**
+ * Subscription Event Type Enum
+ *
+ * @description
+ * Event types for subscription webhook notifications.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum SubscriptionEventType {
+    SUBSCRIPTION_STATUS_NOTIFICATION = "SUBSCRIPTION_STATUS_NOTIFICATION",
+    PAYMENT_NOTIFICATION = "PAYMENT_NOTIFICATION"
+}
+/**
+ * Product Information Interface (Request Parameters)
+ *
+ * @description
+ * Subscription billing product configuration.
+ *
+ * @interface ProductInfo
+ */
+interface ProductInfo {
+    description: string;
+    periodType: PeriodType | string;
+    periodInterval: string;
+    numberOfPeriod?: string;
+    trialPeriodAmount?: string;
+    numberOfTrialPeriod?: string;
+    trialPeriodType?: PeriodType | string;
+    trialPeriodInterval?: string;
+}
+/**
+ * Merchant Information Interface (Request Parameters)
+ *
+ * @description
+ * Merchant information for subscription.
+ *
+ * @interface SubscriptionMerchantInfo
+ */
+interface SubscriptionMerchantInfo {
+    merchantId: string;
+    subMerchantId?: string;
+}
+/**
+ * Subscription User Info Interface (Request Parameters)
+ *
+ * @description
+ * User information for subscription.
+ *
+ * @interface SubscriptionUserInfo
+ */
+interface SubscriptionUserInfo {
+    userId: string;
+    userEmail: string;
+    userTerminal?: SubscriptionUserTerminalType | string;
+    userPhone?: string;
+    userFirstName?: string;
+    userLastName?: string;
+    userCreatedAt?: string;
+}
+/**
+ * Subscription Goods Information Interface (Request Parameters)
+ *
+ * @description
+ * Goods information for subscription.
+ *
+ * @interface SubscriptionGoodsInfo
+ */
+interface SubscriptionGoodsInfo {
+    goodsId: string;
+    goodsName: string;
+    goodsCategory?: string;
+    goodsUrl?: string;
+    appName?: string;
+    skuName?: string;
+    goodsUniquePrice?: string;
+    goodsQuantity?: number;
+}
+/**
+ * Subscription Address Information Interface (Request Parameters)
+ *
+ * @description
+ * Address information for subscription.
+ *
+ * @interface SubscriptionAddressInfo
+ */
+interface SubscriptionAddressInfo {
+    address?: string;
+    city?: string;
+    region?: string;
+    postcode?: string;
+    addressCountryCode?: string;
+}
+/**
+ * Subscription Payment Info Interface (Request Parameters)
+ *
+ * @description
+ * Payment method configuration for subscription.
+ *
+ * @interface SubscriptionPaymentInfo
+ */
+interface SubscriptionPaymentInfo {
+    productName: SubscriptionProductName | string;
+    /**
+     * Payment method type (max 256 characters)
+     * Example values: "EWALLET", "CREDITCARD", "DEBITCARD"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodType?: string;
+    /**
+     * Specific payment method name (max 24 characters) - required
+     * Example E-wallets: "DANA", "GCASH", "ALIPAY_HK"
+     * Example Credit Cards: "CC_VISA", "CC_MASTERCARD"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodName: string;
+    payMethodProperties?: Record<string, unknown> | string;
+    payMethodUserAccountType?: SubscriptionPayMethodUserAccountType | string;
+    cashierLanguage?: CashierLanguage | string;
+    payMethodUserAccountNo?: string;
+    payMethodUserAccessToken?: string;
+}
+/**
+ * Risk Data Interface (Request Parameters)
+ *
+ * @description
+ * Auxiliary data for risk assessment.
+ *
+ * @interface SubscriptionRiskData
+ */
+interface SubscriptionRiskData {
+    userType?: RiskUserType;
+    userCategory?: string;
+    userLegalName?: string;
+    userDisplayName?: string;
+    userRegistrationIp?: string;
+    userLastSeenIp?: string;
+    userIsNew?: string;
+    userIsFirstPurchase?: string;
+}
+/**
+ * Create Subscription Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.subscription.create()`.
+ *
+ * @interface CreateSubscriptionParams
+ */
+interface CreateSubscriptionParams {
+    subscriptionRequest: string;
+    merchantSubscriptionId?: string;
+    currency: string;
+    amount: string;
+    userCurrency?: string;
+    productInfo: ProductInfo;
+    merchantInfo: SubscriptionMerchantInfo;
+    userInfo: SubscriptionUserInfo;
+    goodsInfo: SubscriptionGoodsInfo;
+    addressInfo?: SubscriptionAddressInfo;
+    paymentInfo: SubscriptionPaymentInfo;
+    requestedAt?: string;
+    successRedirectUrl?: string;
+    failedRedirectUrl?: string;
+    cancelRedirectUrl?: string;
+    notifyUrl: string;
+    subscriptionManagementUrl?: string;
+    riskData?: SubscriptionRiskData;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Inquiry Subscription Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.subscription.inquiry()`.
+ *
+ * @interface InquirySubscriptionParams
+ */
+interface InquirySubscriptionParams {
+    subscriptionRequest?: string;
+    subscriptionId?: string;
+    paymentDetails?: "0" | "1";
+}
+/**
+ * Cancel Subscription Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.subscription.cancel()`.
+ *
+ * @interface CancelSubscriptionParams
+ */
+interface CancelSubscriptionParams {
+    subscriptionId: string;
+    merchantId: string;
+    requestedAt?: string;
+}
+/**
+ * Manage Subscription Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.subscription.manage()`.
+ *
+ * @interface ManageSubscriptionParams
+ */
+interface ManageSubscriptionParams {
+    subscriptionRequest?: string;
+    subscriptionId?: string;
+}
+/**
+ * Subscription Action Interface (Response)
+ *
+ * @description
+ * Returned when subscription status is AUTHORIZATION_REQUIRED.
+ *
+ * @interface SubscriptionAction
+ */
+interface SubscriptionAction {
+    webUrl: string;
+}
+/**
+ * Product Info Response Interface (Response)
+ *
+ * @description
+ * Subscription product configuration in response.
+ *
+ * @interface ProductInfoResponse
+ */
+interface ProductInfoResponse {
+    description: string;
+    periodType: PeriodType | string;
+    periodInterval: string;
+    numberOfPeriod?: string;
+    trialPeriodAmount?: string;
+    numberOfTrialPeriod?: string;
+    startDateTime?: string;
+    endDateTime?: string;
+    nextPaymentDateTime?: string;
+    currentPeriod?: string;
+}
+/**
+ * Payment Detail Interface (Response)
+ *
+ * @description
+ * Individual payment record within subscription.
+ *
+ * @interface PaymentDetail
+ */
+interface PaymentDetail {
+    acquiringOrderId: string;
+    orderCurrency: string;
+    orderAmount: string;
+    orderStatus: SubscriptionOrderStatus | string;
+    orderUpdatedAt: string;
+    period: string;
+}
+/**
+ * Subscription Failed Reason Interface (Response)
+ *
+ * @description
+ * Error details when subscription fails.
+ *
+ * @interface SubscriptionFailedReason
+ */
+interface SubscriptionFailedReason {
+    orderFailedCode: string;
+    orderFailedDescription: string;
+}
+/**
+ * Payment Method Response Interface (Response)
+ *
+ * @description
+ * Payment method response data.
+ *
+ * @interface SubscriptionPayMethodResponse
+ */
+interface SubscriptionPayMethodResponse {
+    payMethodRefId?: string;
+    exchangeRate?: string;
+    userOpenId?: string;
+    maskCardData?: string;
+    [key: string]: string | undefined;
+}
+/**
+ * Subscription Payment Info Response Interface (Response)
+ *
+ * @description
+ * Payment method information in response.
+ *
+ * @interface SubscriptionPaymentInfoResponse
+ */
+interface SubscriptionPaymentInfoResponse {
+    productName: SubscriptionProductName | string;
+    /**
+     * Payment method type (max 256 characters)
+     * Example values: "EWALLET", "CREDITCARD", "DEBITCARD"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodType?: string;
+    /**
+     * Payment method name (max 24 characters)
+     * Example E-wallets: "DANA", "GCASH", "ALIPAY_HK"
+     * Example Credit Cards: "CC_VISA", "CC_MASTERCARD"
+     * Note: This list may be updated. Please refer to the latest API documentation.
+     */
+    payMethodName: string;
+    payMethodProperties?: Record<string, unknown> | string;
+    payMethodResponse?: SubscriptionPayMethodResponse | string;
+    payMethodUserAccountType?: SubscriptionPayMethodUserAccountType | string;
+    payMethodUserAccountNo?: string;
+    payMethodUserAccessToken?: string;
+    payMethodPublicUid?: string;
+}
+/**
+ * Create Subscription Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.subscription.create()`.
+ *
+ * @interface CreateSubscriptionData
+ */
+interface CreateSubscriptionData {
+    subscriptionRequest: string;
+    merchantSubscriptionId?: string;
+    subscriptionId: string;
+    payMethodSubscriptionId?: string;
+    subscriptionStatus: SubscriptionStatus | string;
+    subscriptionAction?: SubscriptionAction;
+}
+/**
+ * Inquiry Subscription Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.subscription.inquiry()`.
+ *
+ * @interface InquirySubscriptionData
+ */
+interface InquirySubscriptionData {
+    subscriptionRequest: string;
+    merchantSubscriptionId?: string;
+    subscriptionId: string;
+    subscriptionStatus: SubscriptionStatus | string;
+    subscriptionAction?: SubscriptionAction;
+    currency: string;
+    amount: string;
+    userCurrency?: string;
+    productInfo: ProductInfoResponse;
+    merchantInfo: SubscriptionMerchantInfo;
+    userInfo: SubscriptionUserInfo;
+    goodsInfo?: SubscriptionGoodsInfo;
+    addressInfo?: SubscriptionAddressInfo;
+    paymentInfo: SubscriptionPaymentInfoResponse;
+    requestedAt: string;
+    updatedAt: string;
+    failedReason?: SubscriptionFailedReason | string;
+    extendInfo?: string | Record<string, unknown>;
+    subscriptionManagementUrl?: string;
+    paymentDetails?: PaymentDetail[];
+}
+/**
+ * Cancel Subscription Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.subscription.cancel()`.
+ *
+ * @interface CancelSubscriptionData
+ */
+interface CancelSubscriptionData {
+    subscriptionId: string;
+    subscriptionRequest: string;
+    merchantSubscriptionId?: string;
+    orderStatus: SubscriptionStatus | string;
+}
+/**
+ * Manage Subscription Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.subscription.manage()`.
+ *
+ * @interface ManageSubscriptionData
+ */
+interface ManageSubscriptionData {
+    subscriptionRequest: string;
+    merchantSubscriptionId?: string;
+    subscriptionId: string;
+    managementUrl: string;
+    expiredAt: string;
+    subscriptionStatus: SubscriptionStatus | string;
+}
+/**
+ * Subscription Info Interface (Response)
+ *
+ * @description
+ * Subscription information in payment order response and webhook notifications.
+ *
+ * @interface SubscriptionInfo
+ */
+interface SubscriptionInfo {
+    subscriptionRequest: string;
+    subscriptionId: string;
+    period: string;
+}
+/**
+ * Subscription Status Notification Result Interface
+ *
+ * @description
+ * Payload for SUBSCRIPTION_STATUS_NOTIFICATION webhook.
+ *
+ * @interface SubscriptionStatusNotificationResult
+ */
+interface SubscriptionStatusNotificationResult {
+    subscriptionRequest: string;
+    merchantSubscriptionId?: string;
+    subscriptionId: string;
+    subscriptionStatus: SubscriptionStatus | string;
+    subscriptionAction?: SubscriptionAction;
+    currency: string;
+    amount: string;
+    userCurrency?: string;
+    productInfo: ProductInfoResponse;
+    merchantInfo: SubscriptionMerchantInfo;
+    userInfo: SubscriptionUserInfo;
+    goodsInfo?: SubscriptionGoodsInfo;
+    addressInfo?: SubscriptionAddressInfo;
+    paymentInfo: SubscriptionPaymentInfoResponse;
+    requestedAt: string;
+    updatedAt: string;
+    failedReason?: SubscriptionFailedReason | string;
+    extendInfo?: string | Record<string, unknown>;
+    subscriptionManagementUrl?: string;
+    paymentDetails?: PaymentDetail[];
+}
+/**
+ * Subscription Payment Notification Result Interface
+ *
+ * @description
+ * Payload for PAYMENT_NOTIFICATION webhook (subscription deduction).
+ *
+ * @interface SubscriptionPaymentNotificationResult
+ */
+interface SubscriptionPaymentNotificationResult {
+    acquiringOrderId: string;
+    orderStatus: SubscriptionOrderStatus | string;
+    orderCurrency: string;
+    orderAmount: string;
+    userCurrency?: string;
+    finalDealAmount: string;
+    orderDescription: string;
+    merchantInfo: SubscriptionMerchantInfo;
+    userInfo: SubscriptionUserInfo;
+    goodsInfo?: SubscriptionGoodsInfo;
+    addressInfo?: SubscriptionAddressInfo;
+    paymentInfo: SubscriptionPaymentInfoResponse;
+    subscriptionInfo: SubscriptionInfo;
+    orderRequestedAt: string;
+    orderUpdatedAt: string;
+    orderFailedReason?: SubscriptionFailedReason | string;
+    extendInfo?: string | Record<string, unknown>;
+}
+/**
+ * Subscription Status Notification Interface
+ *
+ * @description
+ * Webhook notification for subscription status changes.
+ *
+ * @interface SubscriptionStatusNotification
+ */
+interface SubscriptionStatusNotification {
+    eventType: SubscriptionEventType.SUBSCRIPTION_STATUS_NOTIFICATION;
+    result: SubscriptionStatusNotificationResult;
+}
+/**
+ * Subscription Payment Notification Interface
+ *
+ * @description
+ * Webhook notification for subscription payment events (recurring billing).
+ *
+ * @interface SubscriptionPaymentNotification
+ */
+interface SubscriptionPaymentNotification {
+    eventType: SubscriptionEventType.PAYMENT_NOTIFICATION;
+    result: SubscriptionPaymentNotificationResult;
+}
+/**
+ * Subscription Notification Union Type
+ *
+ * @description
+ * Union type for all subscription webhook notifications.
+ *
+ * @typedef {SubscriptionStatusNotification | SubscriptionPaymentNotification} SubscriptionNotification
+ */
+type SubscriptionNotification = SubscriptionStatusNotification | SubscriptionPaymentNotification;
+/**
+ * Subscription Status Webhook Request Interface
+ *
+ * @description
+ * Full structure of subscription status notification webhook request from Waffo.
+ *
+ * @interface SubscriptionStatusWebhookRequest
+ */
+interface SubscriptionStatusWebhookRequest {
+    header: WebhookRequestHeader;
+    body: SubscriptionStatusNotification;
+}
+/**
+ * Subscription Payment Webhook Request Interface
+ *
+ * @description
+ * Full structure of subscription payment notification webhook request from Waffo.
+ *
+ * @interface SubscriptionPaymentWebhookRequest
+ */
+interface SubscriptionPaymentWebhookRequest {
+    header: WebhookRequestHeader;
+    body: SubscriptionPaymentNotification;
+}
+/**
+ * Subscription Webhook Request Union Type
+ *
+ * @description
+ * Union type for all subscription webhook requests.
+ *
+ * @typedef {SubscriptionStatusWebhookRequest | SubscriptionPaymentWebhookRequest} SubscriptionWebhookRequest
+ */
+type SubscriptionWebhookRequest = SubscriptionStatusWebhookRequest | SubscriptionPaymentWebhookRequest;
+
+/**
+ * @fileoverview Webhook Type Definitions
+ * @module types/webhook
+ *
+ * Types for processing webhook notifications:
+ * - Event types and response status enums
+ * - Request/Response interfaces
+ * - Handler types for processing notifications
+ *
+ * @see {@link WebhookHandler} for processing webhooks
+ *
+ * @example
+ * import {
+ *   WebhookEventType,
+ *   WebhookResponseStatus,
+ *   WebhookHandlerOptions,
+ * } from 'waffo-sdk';
+ *
+ * const options: WebhookHandlerOptions = {
+ *   onPayment: async (ctx) => {
+ *     console.log('Event:', ctx.eventType);
+ *     console.log('Notification:', ctx.notification);
+ *   },
+ * };
+ */
+
+/**
+ * Type of webhook notification from Waffo.
+ *
+ * @enum {string}
+ * @readonly
+ */
+declare enum WebhookEventType {
+    /** Payment order status change */
+    PAYMENT_NOTIFICATION = "PAYMENT_NOTIFICATION",
+    /** Refund status change */
+    REFUND_NOTIFICATION = "REFUND_NOTIFICATION",
+    /** Subscription status change */
+    SUBSCRIPTION_STATUS_NOTIFICATION = "SUBSCRIPTION_STATUS_NOTIFICATION"
+}
+/**
+ * Merchant webhook response status.
+ *
+ * - **SUCCESS**: Waffo stops retrying
+ * - **FAILED/UNKNOWN**: Waffo retries within 24 hours
+ *
+ * @enum {string}
+ * @readonly
+ *
+ * @example
+ * // Return SUCCESS to acknowledge receipt
+ * const response = buildWebhookResponse(WebhookResponseStatus.SUCCESS, privateKey);
+ *
+ * // Return FAILED to request retry
+ * const response = buildWebhookResponse(WebhookResponseStatus.FAILED, privateKey);
+ */
+declare enum WebhookResponseStatus {
+    /** Successfully processed, no retry needed */
+    SUCCESS = "success",
+    /** Processing failed, Waffo will retry */
+    FAILED = "failed",
+    /** Unknown status, Waffo will retry */
+    UNKNOWN = "unknown"
+}
+/**
+ * Webhook request headers from Waffo.
+ * @interface WebhookRequestHeader
+ */
+interface WebhookRequestHeader {
+    /** RSA-SHA256 signature for verification */
+    "X-SIGNATURE": string;
+    /** Optional MIME type */
+    "Content-Type"?: string;
+}
+/**
+ * Webhook response headers to send back to Waffo.
+ * @type WebhookResponseHeader
+ */
+type WebhookResponseHeader = SignatureHeader;
+/**
+ * Webhook response body to send back to Waffo.
+ * @interface WebhookResponseBody
+ */
+interface WebhookResponseBody {
+    /** Response status message */
+    message: WebhookResponseStatus | string;
+}
+/**
+ * Complete webhook response structure.
+ *
+ * @interface WebhookResponse
+ *
+ * @example
+ * const response: WebhookResponse = buildSuccessResponse(privateKey);
+ * res.set(response.header).json(response.body);
+ */
+interface WebhookResponse {
+    /** Response headers (includes X-SIGNATURE) */
+    header: WebhookResponseHeader;
+    /** Response body (includes status message) */
+    body: WebhookResponseBody;
+}
+/**
+ * Context passed to webhook handlers.
+ *
+ * @interface WebhookHandlerContext
+ * @template T - The notification type
+ *
+ * @example
+ * const handler: PaymentNotificationHandler = async (ctx) => {
+ *   console.log('Event type:', ctx.eventType);
+ *   console.log('Raw body:', ctx.rawBody);
+ *   console.log('Order status:', ctx.notification.result.orderStatus);
+ * };
+ */
+interface WebhookHandlerContext<T> {
+    /** Parsed notification payload */
+    notification: T;
+    /** Original raw request body (for logging/debugging) */
+    rawBody: string;
+    /** Webhook event type */
+    eventType: WebhookEventType;
+}
+/**
+ * Handler for payment notifications.
+ * @param context - Context with PaymentNotification
+ */
+type PaymentNotificationHandler = (context: WebhookHandlerContext<PaymentNotification>) => void | Promise<void>;
+/**
+ * Handler for refund notifications.
+ * @param context - Context with RefundNotification
+ */
+type RefundNotificationHandler = (context: WebhookHandlerContext<RefundNotification>) => void | Promise<void>;
+/**
+ * Handler for subscription status notifications.
+ * @param context - Context with SubscriptionStatusNotification
+ */
+type SubscriptionStatusNotificationHandler = (context: WebhookHandlerContext<SubscriptionStatusNotification>) => void | Promise<void>;
+/**
+ * Handler for subscription payment notifications.
+ * @param context - Context with SubscriptionPaymentNotification
+ */
+type SubscriptionPaymentNotificationHandler = (context: WebhookHandlerContext<SubscriptionPaymentNotification>) => void | Promise<void>;
+/**
+ * Handler for webhook processing errors.
+ * @param error - The error that occurred
+ */
+type WebhookErrorHandler = (error: Error) => void | Promise<void>;
+/**
+ * Options for configuring webhook handlers.
+ *
+ * @interface WebhookHandlerOptions
+ *
+ * @example
+ * const options: WebhookHandlerOptions = {
+ *   onPayment: async (ctx) => {
+ *     await updateOrder(ctx.notification.result);
+ *   },
+ *   onRefund: async (ctx) => {
+ *     await processRefund(ctx.notification.result);
+ *   },
+ *   onSubscriptionStatus: async (ctx) => {
+ *     await updateSubscription(ctx.notification.result);
+ *   },
+ *   onSubscriptionPayment: async (ctx) => {
+ *     await recordPayment(ctx.notification.result);
+ *   },
+ *   onError: async (error) => {
+ *     console.error('Webhook error:', error);
+ *   },
+ * };
+ */
+interface WebhookHandlerOptions {
+    /** Handler for payment notifications */
+    onPayment?: PaymentNotificationHandler;
+    /** Handler for refund notifications */
+    onRefund?: RefundNotificationHandler;
+    /** Handler for subscription status changes */
+    onSubscriptionStatus?: SubscriptionStatusNotificationHandler;
+    /** Handler for subscription recurring payments */
+    onSubscriptionPayment?: SubscriptionPaymentNotificationHandler;
+    /** Handler for processing errors */
+    onError?: WebhookErrorHandler;
+}
+/**
+ * Result from webhook handler.
+ *
+ * @interface WebhookHandlerResult
+ *
+ * @example
+ * const result = await waffo.webhook.handle(body, signature, options);
+ * if (result.success) {
+ *   res.set(result.response.header).json(result.response.body);
+ * } else {
+ *   console.error('Webhook failed:', result.error);
+ *   res.set(result.response.header).json(result.response.body);
+ * }
+ */
+interface WebhookHandlerResult {
+    /** Whether processing was successful */
+    success: boolean;
+    /** Signed response to send back to Waffo */
+    response: WebhookResponse;
+    /** Error message (only on failure) */
+    error?: string;
+}
+
+/**
+ * @fileoverview Cryptographic Type Definitions
+ * @module types/crypto
+ *
+ * RSA key pair and related cryptographic types for API request signing
+ * and response verification.
+ *
+ * @see {@link Waffo.generateKeyPair} for generating key pairs
+ * @see {@link signForRSA} for signing requests
+ * @see {@link verify} for verifying signatures
+ *
+ * @example
+ * import { KeyPair } from 'waffo-sdk';
+ *
+ * const keys: KeyPair = Waffo.generateKeyPair();
+ * console.log('Private key:', keys.privateKey);
+ * console.log('Public key:', keys.publicKey);
+ */
+/**
+ * RSA key pair for signing and verification.
+ *
+ * Keys are in the format required by the Waffo API:
+ * - Private key: Base64 encoded PKCS8 DER format
+ * - Public key: Base64 encoded X509/SPKI DER format
+ *
+ * @interface KeyPair
+ *
+ * @example
+ * const keys = Waffo.generateKeyPair();
+ *
+ * // Use private key with SDK
+ * const waffo = new Waffo({
+ *   apiKey: 'key',
+ *   privateKey: keys.privateKey,
+ * });
+ *
+ * // Register public key with Waffo merchant dashboard
+ * console.log('Register this with Waffo:', keys.publicKey);
+ */
+interface KeyPair {
+    /** RSA private key (Base64 encoded PKCS8 DER), for signing requests */
+    privateKey: string;
+    /** RSA public key (Base64 encoded X509/SPKI DER), register with Waffo */
+    publicKey: string;
+}
+
+/**
+ * @fileoverview ISO Standard Code Definitions
+ * @module types/iso
+ *
+ * @description
+ * This module contains ISO standard codes used throughout the SDK:
+ *
+ * - **{@link CountryCode}** - ISO 3166-1 alpha-3 country codes (e.g., USA, JPN, CHN)
+ * - **{@link CurrencyCode}** - ISO 4217 currency codes (e.g., USD, JPY, EUR)
+ *
+ * These codes ensure international compatibility and standardization
+ * for order creation, address information, and payment processing.
+ *
+ * @example
+ * // Using country codes for user address
+ * import { CountryCode, CurrencyCode } from 'waffo-sdk-nodejs';
+ *
+ * const orderParams = {
+ *   orderAmount: '1000',
+ *   orderCurrency: CurrencyCode.JPY,
+ *   userInfo: {
+ *     userCountry: CountryCode.JPN,
+ *   },
+ *   addressInfo: {
+ *     country: CountryCode.JPN,
+ *     city: 'Tokyo',
+ *   },
+ * };
+ *
+ * @example
+ * // Multi-currency support
+ * const supportedCurrencies = [
+ *   CurrencyCode.USD,
+ *   CurrencyCode.EUR,
+ *   CurrencyCode.JPY,
+ *   CurrencyCode.GBP,
+ * ];
+ *
+ * @see {@link CreateOrderParams} for order creation parameters
+ * @see {@link AddressInfo} for address information structure
+ */
+/**
+ * ISO 3166-1 alpha-3 country codes.
+ *
+ * @description
+ * Three-letter country codes following the ISO 3166-1 standard.
+ * Use these codes for specifying user country and address information
+ * in order creation and payment processing.
+ *
+ * Common codes:
+ * - `USA` - United States of America
+ * - `JPN` - Japan
+ * - `CHN` - China
+ * - `GBR` - United Kingdom
+ * - `DEU` - Germany
+ *
+ * @example
+ * // Specify user's country
+ * const userInfo = {
+ *   userCountry: CountryCode.JPN,
+ *   userName: 'Taro Yamada',
+ * };
+ *
+ * @example
+ * // Specify shipping address country
+ * const addressInfo = {
+ *   country: CountryCode.USA,
+ *   state: 'CA',
+ *   city: 'San Francisco',
+ *   address1: '123 Main St',
+ *   zipCode: '94102',
+ * };
+ *
+ * @enum {string}
+ * @readonly
+ * @see https://www.iso.org/iso-3166-country-codes.html
+ */
+declare enum CountryCode {
+    AFG = "AFG",// Afghanistan
+    ALB = "ALB",// Albania
+    DZA = "DZA",// Algeria
+    ASM = "ASM",// American Samoa
+    AND = "AND",// Andorra
+    AGO = "AGO",// Angola
+    AIA = "AIA",// Anguilla
+    ATA = "ATA",// Antarctica
+    ATG = "ATG",// Antigua and Barbuda
+    ARG = "ARG",// Argentina
+    ARM = "ARM",// Armenia
+    ABW = "ABW",// Aruba
+    AUS = "AUS",// Australia
+    AUT = "AUT",// Austria
+    AZE = "AZE",// Azerbaijan
+    BHS = "BHS",// Bahamas
+    BHR = "BHR",// Bahrain
+    BGD = "BGD",// Bangladesh
+    BRB = "BRB",// Barbados
+    BLR = "BLR",// Belarus
+    BEL = "BEL",// Belgium
+    BLZ = "BLZ",// Belize
+    BEN = "BEN",// Benin
+    BMU = "BMU",// Bermuda
+    BTN = "BTN",// Bhutan
+    BOL = "BOL",// Bolivia
+    BES = "BES",// Bonaire, Sint Eustatius and Saba
+    BIH = "BIH",// Bosnia and Herzegovina
+    BWA = "BWA",// Botswana
+    BVT = "BVT",// Bouvet Island
+    BRA = "BRA",// Brazil
+    IOT = "IOT",// British Indian Ocean Territory
+    BRN = "BRN",// Brunei Darussalam
+    BGR = "BGR",// Bulgaria
+    BFA = "BFA",// Burkina Faso
+    BDI = "BDI",// Burundi
+    CPV = "CPV",// Cabo Verde
+    KHM = "KHM",// Cambodia
+    CMR = "CMR",// Cameroon
+    CAN = "CAN",// Canada
+    CYM = "CYM",// Cayman Islands
+    CAF = "CAF",// Central African Republic
+    TCD = "TCD",// Chad
+    CHL = "CHL",// Chile
+    CHN = "CHN",// China
+    CXR = "CXR",// Christmas Island
+    CCK = "CCK",// Cocos (Keeling) Islands
+    COL = "COL",// Colombia
+    COM = "COM",// Comoros
+    COD = "COD",// Congo (Democratic Republic)
+    COG = "COG",// Congo
+    COK = "COK",// Cook Islands
+    CRI = "CRI",// Costa Rica
+    HRV = "HRV",// Croatia
+    CUB = "CUB",// Cuba
+    CUW = "CUW",// Curaçao
+    CYP = "CYP",// Cyprus
+    CZE = "CZE",// Czechia
+    CIV = "CIV",// Côte d'Ivoire
+    DNK = "DNK",// Denmark
+    DJI = "DJI",// Djibouti
+    DMA = "DMA",// Dominica
+    DOM = "DOM",// Dominican Republic
+    ECU = "ECU",// Ecuador
+    EGY = "EGY",// Egypt
+    SLV = "SLV",// El Salvador
+    GNQ = "GNQ",// Equatorial Guinea
+    ERI = "ERI",// Eritrea
+    EST = "EST",// Estonia
+    SWZ = "SWZ",// Eswatini
+    ETH = "ETH",// Ethiopia
+    FLK = "FLK",// Falkland Islands
+    FRO = "FRO",// Faroe Islands
+    FJI = "FJI",// Fiji
+    FIN = "FIN",// Finland
+    FRA = "FRA",// France
+    GUF = "GUF",// French Guiana
+    PYF = "PYF",// French Polynesia
+    ATF = "ATF",// French Southern Territories
+    GAB = "GAB",// Gabon
+    GMB = "GMB",// Gambia
+    GEO = "GEO",// Georgia
+    DEU = "DEU",// Germany
+    GHA = "GHA",// Ghana
+    GIB = "GIB",// Gibraltar
+    GRC = "GRC",// Greece
+    GRL = "GRL",// Greenland
+    GRD = "GRD",// Grenada
+    GLP = "GLP",// Guadeloupe
+    GUM = "GUM",// Guam
+    GTM = "GTM",// Guatemala
+    GGY = "GGY",// Guernsey
+    GIN = "GIN",// Guinea
+    GNB = "GNB",// Guinea-Bissau
+    GUY = "GUY",// Guyana
+    HTI = "HTI",// Haiti
+    HMD = "HMD",// Heard Island and McDonald Islands
+    VAT = "VAT",// Holy See
+    HND = "HND",// Honduras
+    HKG = "HKG",// Hong Kong
+    HUN = "HUN",// Hungary
+    ISL = "ISL",// Iceland
+    IND = "IND",// India
+    IDN = "IDN",// Indonesia
+    IRN = "IRN",// Iran
+    IRQ = "IRQ",// Iraq
+    IRL = "IRL",// Ireland
+    IMN = "IMN",// Isle of Man
+    ISR = "ISR",// Israel
+    ITA = "ITA",// Italy
+    JAM = "JAM",// Jamaica
+    JPN = "JPN",// Japan
+    JEY = "JEY",// Jersey
+    JOR = "JOR",// Jordan
+    KAZ = "KAZ",// Kazakhstan
+    KEN = "KEN",// Kenya
+    KIR = "KIR",// Kiribati
+    PRK = "PRK",// Korea (Democratic People's Republic)
+    KOR = "KOR",// Korea (Republic)
+    KWT = "KWT",// Kuwait
+    KGZ = "KGZ",// Kyrgyzstan
+    LAO = "LAO",// Lao People's Democratic Republic
+    LVA = "LVA",// Latvia
+    LBN = "LBN",// Lebanon
+    LSO = "LSO",// Lesotho
+    LBR = "LBR",// Liberia
+    LBY = "LBY",// Libya
+    LIE = "LIE",// Liechtenstein
+    LTU = "LTU",// Lithuania
+    LUX = "LUX",// Luxembourg
+    MAC = "MAC",// Macao
+    MDG = "MDG",// Madagascar
+    MWI = "MWI",// Malawi
+    MYS = "MYS",// Malaysia
+    MDV = "MDV",// Maldives
+    MLI = "MLI",// Mali
+    MLT = "MLT",// Malta
+    MHL = "MHL",// Marshall Islands
+    MTQ = "MTQ",// Martinique
+    MRT = "MRT",// Mauritania
+    MUS = "MUS",// Mauritius
+    MYT = "MYT",// Mayotte
+    MEX = "MEX",// Mexico
+    FSM = "FSM",// Micronesia
+    MDA = "MDA",// Moldova
+    MCO = "MCO",// Monaco
+    MNG = "MNG",// Mongolia
+    MNE = "MNE",// Montenegro
+    MSR = "MSR",// Montserrat
+    MAR = "MAR",// Morocco
+    MOZ = "MOZ",// Mozambique
+    MMR = "MMR",// Myanmar
+    NAM = "NAM",// Namibia
+    NRU = "NRU",// Nauru
+    NPL = "NPL",// Nepal
+    NLD = "NLD",// Netherlands
+    NCL = "NCL",// New Caledonia
+    NZL = "NZL",// New Zealand
+    NIC = "NIC",// Nicaragua
+    NER = "NER",// Niger
+    NGA = "NGA",// Nigeria
+    NIU = "NIU",// Niue
+    NFK = "NFK",// Norfolk Island
+    MKD = "MKD",// North Macedonia
+    MNP = "MNP",// Northern Mariana Islands
+    NOR = "NOR",// Norway
+    OMN = "OMN",// Oman
+    PAK = "PAK",// Pakistan
+    PLW = "PLW",// Palau
+    PSE = "PSE",// Palestine
+    PAN = "PAN",// Panama
+    PNG = "PNG",// Papua New Guinea
+    PRY = "PRY",// Paraguay
+    PER = "PER",// Peru
+    PHL = "PHL",// Philippines
+    PCN = "PCN",// Pitcairn
+    POL = "POL",// Poland
+    PRT = "PRT",// Portugal
+    PRI = "PRI",// Puerto Rico
+    QAT = "QAT",// Qatar
+    ROU = "ROU",// Romania
+    RUS = "RUS",// Russian Federation
+    RWA = "RWA",// Rwanda
+    REU = "REU",// Réunion
+    BLM = "BLM",// Saint Barthélemy
+    SHN = "SHN",// Saint Helena, Ascension and Tristan da Cunha
+    KNA = "KNA",// Saint Kitts and Nevis
+    LCA = "LCA",// Saint Lucia
+    MAF = "MAF",// Saint Martin (French part)
+    SPM = "SPM",// Saint Pierre and Miquelon
+    VCT = "VCT",// Saint Vincent and the Grenadines
+    WSM = "WSM",// Samoa
+    SMR = "SMR",// San Marino
+    STP = "STP",// Sao Tome and Principe
+    SAU = "SAU",// Saudi Arabia
+    SEN = "SEN",// Senegal
+    SRB = "SRB",// Serbia
+    SYC = "SYC",// Seychelles
+    SLE = "SLE",// Sierra Leone
+    SGP = "SGP",// Singapore
+    SXM = "SXM",// Sint Maarten (Dutch part)
+    SVK = "SVK",// Slovakia
+    SVN = "SVN",// Slovenia
+    SLB = "SLB",// Solomon Islands
+    SOM = "SOM",// Somalia
+    ZAF = "ZAF",// South Africa
+    SGS = "SGS",// South Georgia and the South Sandwich Islands
+    SSD = "SSD",// South Sudan
+    ESP = "ESP",// Spain
+    LKA = "LKA",// Sri Lanka
+    SDN = "SDN",// Sudan
+    SUR = "SUR",// Suriname
+    SJM = "SJM",// Svalbard and Jan Mayen
+    SWE = "SWE",// Sweden
+    CHE = "CHE",// Switzerland
+    SYR = "SYR",// Syrian Arab Republic
+    TWN = "TWN",// Taiwan
+    TJK = "TJK",// Tajikistan
+    TZA = "TZA",// Tanzania
+    THA = "THA",// Thailand
+    TLS = "TLS",// Timor-Leste
+    TGO = "TGO",// Togo
+    TKL = "TKL",// Tokelau
+    TON = "TON",// Tonga
+    TTO = "TTO",// Trinidad and Tobago
+    TUN = "TUN",// Tunisia
+    TUR = "TUR",// Turkey
+    TKM = "TKM",// Turkmenistan
+    TCA = "TCA",// Turks and Caicos Islands
+    TUV = "TUV",// Tuvalu
+    UGA = "UGA",// Uganda
+    UKR = "UKR",// Ukraine
+    ARE = "ARE",// United Arab Emirates
+    GBR = "GBR",// United Kingdom
+    UMI = "UMI",// United States Minor Outlying Islands
+    USA = "USA",// United States of America
+    URY = "URY",// Uruguay
+    UZB = "UZB",// Uzbekistan
+    VUT = "VUT",// Vanuatu
+    VEN = "VEN",// Venezuela
+    VNM = "VNM",// Viet Nam
+    VGB = "VGB",// Virgin Islands (British)
+    VIR = "VIR",// Virgin Islands (U.S.)
+    WLF = "WLF",// Wallis and Futuna
+    ESH = "ESH",// Western Sahara
+    YEM = "YEM",// Yemen
+    ZMB = "ZMB",// Zambia
+    ZWE = "ZWE",// Zimbabwe
+    ALA = "ALA"
+}
+/**
+ * ISO 4217 currency codes.
+ *
+ * @description
+ * Three-letter currency codes following the ISO 4217 standard.
+ * Use these codes for specifying order amounts and payment currencies.
+ *
+ * Common codes:
+ * - `USD` - United States Dollar
+ * - `EUR` - Euro
+ * - `JPY` - Japanese Yen
+ * - `GBP` - Pound Sterling
+ * - `CNY` - Chinese Yuan
+ *
+ * Note: Currency codes determine the decimal precision for amounts.
+ * For example, JPY has no decimal places, while USD has 2.
+ *
+ * @example
+ * // Create an order with Japanese Yen
+ * const orderParams = {
+ *   orderAmount: '1000', // 1000 JPY (no decimals)
+ *   orderCurrency: CurrencyCode.JPY,
+ * };
+ *
+ * @example
+ * // Create an order with US Dollars
+ * const orderParams = {
+ *   orderAmount: '19.99', // $19.99
+ *   orderCurrency: CurrencyCode.USD,
+ * };
+ *
+ * @example
+ * // Validate supported currencies
+ * function isSupportedCurrency(code: string): code is CurrencyCode {
+ *   return Object.values(CurrencyCode).includes(code as CurrencyCode);
+ * }
+ *
+ * @enum {string}
+ * @readonly
+ * @see https://www.iso.org/iso-4217-currency-codes.html
+ */
+declare enum CurrencyCode {
+    AED = "AED",// United Arab Emirates Dirham
+    AFN = "AFN",// Afghan Afghani
+    ALL = "ALL",// Albanian Lek
+    AMD = "AMD",// Armenian Dram
+    ANG = "ANG",// Netherlands Antillean Guilder
+    AOA = "AOA",// Angolan Kwanza
+    ARS = "ARS",// Argentine Peso
+    AUD = "AUD",// Australian Dollar
+    AWG = "AWG",// Aruban Florin
+    AZN = "AZN",// Azerbaijani Manat
+    BAM = "BAM",// Bosnia and Herzegovina Convertible Mark
+    BBD = "BBD",// Barbados Dollar
+    BDT = "BDT",// Bangladeshi Taka
+    BGN = "BGN",// Bulgarian Lev
+    BHD = "BHD",// Bahraini Dinar
+    BIF = "BIF",// Burundian Franc
+    BMD = "BMD",// Bermudian Dollar
+    BND = "BND",// Brunei Dollar
+    BOB = "BOB",// Boliviano
+    BOV = "BOV",// Bolivian Mvdol
+    BRL = "BRL",// Brazilian Real
+    BSD = "BSD",// Bahamian Dollar
+    BTN = "BTN",// Bhutanese Ngultrum
+    BWP = "BWP",// Botswana Pula
+    BYN = "BYN",// Belarusian Ruble
+    BZD = "BZD",// Belize Dollar
+    CAD = "CAD",// Canadian Dollar
+    CDF = "CDF",// Congolese Franc
+    CHE = "CHE",// WIR Euro
+    CHF = "CHF",// Swiss Franc
+    CHW = "CHW",// WIR Franc
+    CLF = "CLF",// Unidad de Fomento
+    CLP = "CLP",// Chilean Peso
+    CNY = "CNY",// Chinese Yuan
+    COP = "COP",// Colombian Peso
+    COU = "COU",// Unidad de Valor Real
+    CRC = "CRC",// Costa Rican Colon
+    CUC = "CUC",// Cuban Convertible Peso
+    CUP = "CUP",// Cuban Peso
+    CVE = "CVE",// Cape Verdean Escudo
+    CZK = "CZK",// Czech Koruna
+    DJF = "DJF",// Djiboutian Franc
+    DKK = "DKK",// Danish Krone
+    DOP = "DOP",// Dominican Peso
+    DZD = "DZD",// Algerian Dinar
+    EGP = "EGP",// Egyptian Pound
+    ERN = "ERN",// Eritrean Nakfa
+    ETB = "ETB",// Ethiopian Birr
+    EUR = "EUR",// Euro
+    FJD = "FJD",// Fiji Dollar
+    FKP = "FKP",// Falkland Islands Pound
+    GBP = "GBP",// Pound Sterling
+    GEL = "GEL",// Georgian Lari
+    GHS = "GHS",// Ghanaian Cedi
+    GIP = "GIP",// Gibraltar Pound
+    GMD = "GMD",// Gambian Dalasi
+    GNF = "GNF",// Guinean Franc
+    GTQ = "GTQ",// Guatemalan Quetzal
+    GYD = "GYD",// Guyanese Dollar
+    HKD = "HKD",// Hong Kong Dollar
+    HNL = "HNL",// Honduran Lempira
+    HRK = "HRK",// Croatian Kuna
+    HTG = "HTG",// Haitian Gourde
+    HUF = "HUF",// Hungarian Forint
+    IDR = "IDR",// Indonesian Rupiah
+    ILS = "ILS",// Israeli New Shekel
+    INR = "INR",// Indian Rupee
+    IQD = "IQD",// Iraqi Dinar
+    IRR = "IRR",// Iranian Rial
+    ISK = "ISK",// Icelandic Króna
+    JMD = "JMD",// Jamaican Dollar
+    JOD = "JOD",// Jordanian Dinar
+    JPY = "JPY",// Japanese Yen
+    KES = "KES",// Kenyan Shilling
+    KGS = "KGS",// Kyrgyzstani Som
+    KHR = "KHR",// Cambodian Riel
+    KMF = "KMF",// Comoro Franc
+    KPW = "KPW",// North Korean Won
+    KRW = "KRW",// South Korean Won
+    KWD = "KWD",// Kuwaiti Dinar
+    KYD = "KYD",// Cayman Islands Dollar
+    KZT = "KZT",// Kazakhstani Tenge
+    LAK = "LAK",// Lao Kip
+    LBP = "LBP",// Lebanese Pound
+    LKR = "LKR",// Sri Lankan Rupee
+    LRD = "LRD",// Liberian Dollar
+    LSL = "LSL",// Lesotho Loti
+    LYD = "LYD",// Libyan Dinar
+    MAD = "MAD",// Moroccan Dirham
+    MDL = "MDL",// Moldovan Leu
+    MGA = "MGA",// Malagasy Ariary
+    MKD = "MKD",// Macedonian Denar
+    MMK = "MMK",// Myanmar Kyat
+    MNT = "MNT",// Mongolian Tögrög
+    MOP = "MOP",// Macanese Pataca
+    MRU = "MRU",// Mauritanian Ouguiya
+    MUR = "MUR",// Mauritian Rupee
+    MVR = "MVR",// Maldivian Rufiyaa
+    MWK = "MWK",// Malawian Kwacha
+    MXN = "MXN",// Mexican Peso
+    MXV = "MXV",// Mexican Unidad de Inversion
+    MYR = "MYR",// Malaysian Ringgit
+    MZN = "MZN",// Mozambican Metical
+    NAD = "NAD",// Namibian Dollar
+    NGN = "NGN",// Nigerian Naira
+    NIO = "NIO",// Nicaraguan Córdoba
+    NOK = "NOK",// Norwegian Krone
+    NPR = "NPR",// Nepalese Rupee
+    NZD = "NZD",// New Zealand Dollar
+    OMR = "OMR",// Omani Rial
+    PAB = "PAB",// Panamanian Balboa
+    PEN = "PEN",// Peruvian Sol
+    PGK = "PGK",// Papua New Guinean Kina
+    PHP = "PHP",// Philippine Peso
+    PKR = "PKR",// Pakistani Rupee
+    PLN = "PLN",// Polish Zloty
+    PYG = "PYG",// Paraguayan Guarani
+    QAR = "QAR",// Qatari Riyal
+    RON = "RON",// Romanian Leu
+    RSD = "RSD",// Serbian Dinar
+    RUB = "RUB",// Russian Ruble
+    RWF = "RWF",// Rwandan Franc
+    SAR = "SAR",// Saudi Riyal
+    SBD = "SBD",// Solomon Islands Dollar
+    SCR = "SCR",// Seychelles Rupee
+    SDG = "SDG",// Sudanese Pound
+    SEK = "SEK",// Swedish Krona
+    SGD = "SGD",// Singapore Dollar
+    SHP = "SHP",// Saint Helena Pound
+    SLE = "SLE",// Sierra Leonean Leone
+    SLL = "SLL",// Sierra Leonean Leone (old)
+    SOS = "SOS",// Somali Shilling
+    SRD = "SRD",// Surinamese Dollar
+    SSP = "SSP",// South Sudanese Pound
+    STN = "STN",// São Tomé and Príncipe Dobra
+    SVC = "SVC",// Salvadoran Colón
+    SYP = "SYP",// Syrian Pound
+    SZL = "SZL",// Swazi Lilangeni
+    THB = "THB",// Thai Baht
+    TJS = "TJS",// Tajikistani Somoni
+    TMT = "TMT",// Turkmenistan Manat
+    TND = "TND",// Tunisian Dinar
+    TOP = "TOP",// Tongan Paʻanga
+    TRY = "TRY",// Turkish Lira
+    TTD = "TTD",// Trinidad and Tobago Dollar
+    TWD = "TWD",// New Taiwan Dollar
+    TZS = "TZS",// Tanzanian Shilling
+    UAH = "UAH",// Ukrainian Hryvnia
+    UGX = "UGX",// Ugandan Shilling
+    USD = "USD",// United States Dollar
+    USN = "USN",// United States Dollar (Next day)
+    UYI = "UYI",// Uruguay Peso en Unidades Indexadas
+    UYU = "UYU",// Uruguayan Peso
+    UYW = "UYW",// Unidad Previsional
+    UZS = "UZS",// Uzbekistan Som
+    VED = "VED",// Venezuelan Digital Bolívar
+    VES = "VES",// Venezuelan Sovereign Bolívar
+    VND = "VND",// Vietnamese Đồng
+    VUV = "VUV",// Vanuatu Vatu
+    WST = "WST",// Samoan Tala
+    XAF = "XAF",// CFA Franc BEAC
+    XAG = "XAG",// Silver (one troy ounce)
+    XAU = "XAU",// Gold (one troy ounce)
+    XBA = "XBA",// European Composite Unit
+    XBB = "XBB",// European Monetary Unit
+    XBC = "XBC",// European Unit of Account 9
+    XBD = "XBD",// European Unit of Account 17
+    XCD = "XCD",// East Caribbean Dollar
+    XDR = "XDR",// Special Drawing Rights
+    XOF = "XOF",// CFA Franc BCEAO
+    XPD = "XPD",// Palladium (one troy ounce)
+    XPF = "XPF",// CFP Franc
+    XPT = "XPT",// Platinum (one troy ounce)
+    XSU = "XSU",// Sucre
+    XTS = "XTS",// Code reserved for testing
+    XUA = "XUA",// ADB Unit of Account
+    XXX = "XXX",// No currency
+    YER = "YER",// Yemeni Rial
+    ZAR = "ZAR",// South African Rand
+    ZMW = "ZMW",// Zambian Kwacha
+    ZWL = "ZWL"
+}
+
+/**
+ * @fileoverview Merchant Config Resource Type Definitions
+ * @module types/merchantconfig
+ *
+ * Type definitions for the Merchant Config resource.
+ *
+ * **Categories:**
+ * - **Request Interfaces:** Parameters for merchant config inquiry
+ * - **Response Interfaces:** Merchant configuration data structures
+ *
+ * @see {@link MerchantConfigResource} for API methods
+ *
+ * @example
+ * import { MerchantConfigInquiryParams, MerchantConfigInquiryData } from 'waffo-sdk';
+ *
+ * const params: MerchantConfigInquiryParams = { merchantId: 'M001' };
+ * const result = await waffo.merchantConfig.inquiry(params);
+ */
+/**
+ * Merchant Config Inquiry Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.merchantConfig.inquiry()`.
+ *
+ * @interface MerchantConfigInquiryParams
+ */
+interface MerchantConfigInquiryParams {
+    merchantId: string;
+}
+/**
+ * Merchant Config Inquiry Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.merchantConfig.inquiry()`.
+ *
+ * @interface MerchantConfigInquiryData
+ */
+interface MerchantConfigInquiryData {
+    merchantId: string;
+    totalDailyLimit?: Record<string, string> | string;
+    remainingDailyLimit?: Record<string, string> | string;
+    transactionLimit?: Record<string, string> | string;
+}
+
+/**
+ * @fileoverview Pay Method Config Resource Type Definitions
+ * @module types/paymethodconfig
+ *
+ * Type definitions for the Pay Method Config resource.
+ *
+ * **Categories:**
+ * - **Request Interfaces:** Parameters for payment method config inquiry
+ * - **Response Interfaces:** Payment method configuration data structures
+ *
+ * @see {@link PayMethodConfigResource} for API methods
+ *
+ * @example
+ * import { PayMethodConfigInquiryParams, PayMethodDetail } from 'waffo-sdk';
+ *
+ * const params: PayMethodConfigInquiryParams = { merchantId: 'M001' };
+ * const result = await waffo.payMethodConfig.inquiry(params);
+ *
+ * const available = result.data.payMethodDetails.filter(m => m.currentStatus === '1');
+ */
+
+/**
+ * Pay Method Config Inquiry Request Parameters Interface
+ *
+ * @description
+ * Request parameters for calling `waffo.payMethodConfig.inquiry()`.
+ *
+ * @interface PayMethodConfigInquiryParams
+ */
+interface PayMethodConfigInquiryParams {
+    merchantId: string;
+}
+/**
+ * Fixed Maintenance Rule Interface (Response)
+ *
+ * @description
+ * Fixed maintenance periods for payment method.
+ *
+ * @interface FixedMaintenanceRule
+ */
+interface FixedMaintenanceRule {
+    startRule?: string;
+    endRule?: string;
+}
+/**
+ * Pay Method Detail Interface (Response)
+ *
+ * @description
+ * Payment method configuration details.
+ *
+ * @interface PayMethodDetail
+ */
+interface PayMethodDetail {
+    productName: ProductName | string;
+    payMethodName: string;
+    country: string;
+    currentStatus: "0" | "1";
+    fixedMaintenanceRules?: FixedMaintenanceRule[];
+    fixedMaintenanceTimezone?: string;
+}
+/**
+ * Pay Method Config Inquiry Response Data Interface
+ *
+ * @description
+ * Business data returned by `waffo.payMethodConfig.inquiry()`.
+ *
+ * @interface PayMethodConfigInquiryData
+ */
+interface PayMethodConfigInquiryData {
+    merchantId: string;
+    payMethodDetails: PayMethodDetail[];
+}
+
+/**
+ * @fileoverview HTTP Client for Waffo API Communication
+ * @module core/httpClient
+ *
+ * Low-level HTTP client for communicating with the Waffo Payment Platform API.
+ *
+ * **Features:**
+ * - Request signing using RSA-SHA256 algorithm
+ * - Response signature verification for integrity
+ * - Automatic timeout handling with AbortController
+ * - Error handling and response parsing
+ *
+ * This client is used internally by all resource classes but can also be
+ * accessed directly via `waffo.httpClient` for custom API requests.
+ *
+ * @see {@link Waffo} for the main SDK class
+ * @see {@link ApiResponse} for the response format
+ *
+ * @example
+ * // Direct usage through Waffo instance
+ * const result = await waffo.httpClient.post('/custom/endpoint', {
+ *   body: { customField: 'value' },
+ * });
+ * if (result.success) {
+ *   console.log('Response:', result.data);
+ * }
+ */
+
+/**
+ * Low-level HTTP client for Waffo API communication.
+ *
+ * Handles all aspects of API communication:
+ * - **Request Signing**: Automatically signs request bodies using RSA-SHA256
+ * - **Response Verification**: Verifies response signatures for data integrity
+ * - **Timeout Handling**: Uses AbortController for reliable timeout management
+ * - **Error Handling**: Parses errors and wraps them in consistent response format
+ *
+ * @class HttpClient
+ * @internal Primarily for internal SDK use
+ *
+ * @example
+ * // Typically accessed through Waffo instance
+ * const result = await waffo.httpClient.post<CustomResponse>('/custom/endpoint', {
+ *   body: { field: 'value' },
+ * });
+ *
+ * @see {@link ApiResponse} for the response format
+ * @see {@link RequestOptions} for request configuration
+ */
+declare class HttpClient {
+    /** @private */
+    private config;
+    /**
+     * Creates an HTTP client instance with the provided SDK configuration.
+     *
+     * Resolves environment-specific settings such as API base URL and public key.
+     *
+     * @param {WaffoConfig} config - Waffo SDK configuration object
+     * @param {string} config.apiKey - API key assigned by Waffo
+     * @param {string} config.privateKey - Merchant private key (Base64 encoded PKCS8 DER)
+     * @param {string} [config.waffoPublicKey] - Waffo public key for response verification
+     * @param {Environment} [config.environment=Environment.PRODUCTION] - API environment
+     * @param {number} [config.timeout=30000] - Request timeout in milliseconds
+     * @param {Logger} [config.logger] - Logger instance for debugging
+     *
+     * @example
+     * const client = new HttpClient({
+     *   apiKey: 'your-api-key',
+     *   privateKey: 'your-private-key',
+     *   environment: Environment.SANDBOX,
+     * });
+     *
+     * @see {@link WaffoConfig} for configuration options
+     */
+    constructor(config: WaffoConfig);
+    /**
+     * Generates an RSA-SHA256 signature for the request body.
+     *
+     * @param {string} payload - Request body string to sign (JSON serialized)
+     * @returns {string} Base64 encoded RSA-SHA256 signature
+     * @throws {Error} "Failed to generate RSA signature" when signing fails
+     * @private
+     */
+    private generateSignature;
+    /**
+     * Verifies the RSA-SHA256 signature of the response body.
+     *
+     * Ensures the response has not been tampered with during transmission.
+     *
+     * @param {string} responseBody - Response body string (raw JSON)
+     * @param {string} signature - X-SIGNATURE header value (Base64 encoded)
+     * @returns {boolean} `true` if signature is valid, `false` otherwise
+     * @private
+     */
+    private verifyResponseSignature;
+    /**
+     * Sends an HTTP POST request with automatic signing and verification.
+     *
+     * **Request Flow:**
+     * 1. Serializes the request body to JSON
+     * 2. Signs the request body using RSA-SHA256
+     * 3. Sends the request with X-API-KEY and X-SIGNATURE headers
+     * 4. Verifies the response signature using Waffo's public key
+     * 5. Parses and returns the response in standardized format
+     *
+     * **Error Handling:**
+     * - Network errors: `{ success: false, error: message }`
+     * - Timeout: status code 408 (REQUEST_TIMEOUT)
+     * - Invalid signature: returns error
+     * - Business errors (code !== "0"): parsed and returned as errors
+     *
+     * @template T - Expected response data type
+     * @template B - Request body type (must extend object)
+     *
+     * @param {string} endpoint - API endpoint path (e.g., '/order/create')
+     * @param {RequestOptions<B>} [options={}] - Request options
+     * @param {B} [options.body] - Request body object (will be JSON serialized)
+     * @param {Record<string, string>} [options.headers] - Additional request headers
+     *
+     * @returns {Promise<ApiResponse<T>>} Response object with success status and data/error
+     *
+     * @example
+     * // Make a POST request
+     * const result = await httpClient.post<CreateOrderData>('/order/create', {
+     *   body: {
+     *     paymentRequestId: 'req-123',
+     *     merchantOrderId: 'order-456',
+     *     // ... other fields
+     *   },
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Order created:', result.data.acquiringOrderId);
+     * } else {
+     *   console.error('Error:', result.error);
+     * }
+     *
+     * @example
+     * // Handle timeout errors
+     * const result = await httpClient.post('/order/create', { body: params });
+     * if (!result.success && result.statusCode === HttpStatusCode.REQUEST_TIMEOUT) {
+     *   console.log('Request timed out, please retry');
+     * }
+     *
+     * @see {@link ApiResponse} for the response format
+     * @see {@link RequestOptions} for request options
+     */
+    post<T, B extends object = Record<string, unknown>>(endpoint: string, options?: RequestOptions<B>): Promise<ApiResponse<T>>;
+}
+
+/**
+ * @fileoverview Webhook Handler for Waffo Webhook Notifications
+ * @module core/webhook
+ *
+ * Provides the WebhookHandler class for processing incoming webhook
+ * notifications from the Waffo Payment Platform.
+ *
+ * **Features:**
+ * - Signature verification using Waffo's public key
+ * - Response signing using merchant's private key
+ * - Event type routing to appropriate handlers
+ * - Error handling and response formatting
+ *
+ * @see {@link Waffo} for the main SDK class
+ * @see {@link WebhookHandlerOptions} for handler configuration
+ *
+ * @example
+ * // Express.js webhook endpoint
+ * app.post('/webhook', async (req, res) => {
+ *   const result = await waffo.webhook.handle(
+ *     JSON.stringify(req.body),
+ *     req.headers['x-signature'],
+ *     {
+ *       onPayment: async ({ notification }) => {
+ *         console.log('Payment:', notification.result.orderStatus);
+ *       },
+ *       onRefund: async ({ notification }) => {
+ *         console.log('Refund:', notification.result.refundStatus);
+ *       },
+ *     }
+ *   );
+ *   res.set(result.response.header).json(result.response.body);
+ * });
+ */
+
+/**
+ * Handles incoming webhook notifications from the Waffo Payment Platform.
+ *
+ * **Features:**
+ * - Signature verification using Waffo's public key
+ * - Event routing to appropriate handlers based on event type
+ * - Response signing using merchant's private key
+ * - Consistent error handling and response formatting
+ *
+ * Accessed via `waffo.webhook` after SDK initialization.
+ *
+ * @class WebhookHandler
+ *
+ * @example
+ * // Handle different notification types
+ * const result = await waffo.webhook.handle(requestBody, signature, {
+ *   onPayment: async (ctx) => {
+ *     const { orderStatus, acquiringOrderId } = ctx.notification.result;
+ *     if (orderStatus === 'PAY_SUCCESS') {
+ *       await fulfillOrder(acquiringOrderId);
+ *     }
+ *   },
+ *   onRefund: async (ctx) => {
+ *     const { refundStatus, acquiringRefundOrderId } = ctx.notification.result;
+ *     await updateRefundStatus(acquiringRefundOrderId, refundStatus);
+ *   },
+ *   onSubscriptionStatus: async (ctx) => {
+ *     const { subscriptionStatus, subscriptionId } = ctx.notification.result;
+ *     await updateSubscription(subscriptionId, subscriptionStatus);
+ *   },
+ *   onError: async (error) => {
+ *     console.error('Webhook error:', error.message);
+ *   },
+ * });
+ *
+ * @see {@link WebhookHandlerOptions} for handler configuration
+ * @see {@link WebhookHandlerResult} for return type
+ */
+declare class WebhookHandler {
+    /** @private */
+    private config;
+    /**
+     * Creates a webhook handler instance.
+     *
+     * Initializes the handler with SDK configuration and resolves
+     * environment-specific settings such as Waffo's public key.
+     *
+     * @param {WaffoConfig} config - Waffo SDK configuration object
+     * @param {string} config.privateKey - Merchant private key (Base64 encoded PKCS8 DER)
+     * @param {string} [config.waffoPublicKey] - Waffo public key for request verification
+     * @param {Environment} [config.environment=Environment.PRODUCTION] - API environment
+     *
+     * @example
+     * // Typically created automatically by Waffo SDK
+     * const waffo = new Waffo(config);
+     * // Access via: waffo.webhook
+     *
+     * @see {@link WaffoConfig} for configuration options
+     */
+    constructor(config: WaffoConfig);
+    /**
+     * Processes an incoming webhook notification from Waffo.
+     *
+     * **Processing Flow:**
+     * 1. Verifies the request signature using Waffo's public key
+     * 2. Parses the notification and determines its type
+     * 3. Routes to the appropriate handler based on event type
+     * 4. Returns a signed response to acknowledge receipt
+     *
+     * **Supported Event Types:**
+     * - `PAYMENT_NOTIFICATION` - Payment order status changes
+     * - `REFUND_NOTIFICATION` - Refund status changes
+     * - `SUBSCRIPTION_STATUS_NOTIFICATION` - Subscription status changes
+     * - `PAYMENT_NOTIFICATION` with subscriptionId - Subscription payments
+     *
+     * @param {string} requestBody - Raw request body string (JSON)
+     * @param {string} signature - X-SIGNATURE header value from Waffo
+     * @param {WebhookHandlerOptions} options - Handler configuration options
+     *
+     * @returns {Promise<WebhookHandlerResult>} Result with success status and signed response
+     *
+     * @example
+     * // Express.js endpoint
+     * app.post('/webhook', async (req, res) => {
+     *   const result = await waffo.webhook.handle(
+     *     JSON.stringify(req.body),
+     *     req.headers['x-signature'],
+     *     {
+     *       onPayment: async ({ notification }) => {
+     *         const { orderStatus, acquiringOrderId } = notification.result;
+     *         await db.orders.updateStatus(acquiringOrderId, orderStatus);
+     *       },
+     *       onRefund: async ({ notification }) => {
+     *         const { refundStatus } = notification.result;
+     *         await db.refunds.update(notification.result);
+     *       },
+     *       onSubscriptionStatus: async ({ notification }) => {
+     *         await db.subscriptions.update(notification.result);
+     *       },
+     *       onSubscriptionPayment: async ({ notification }) => {
+     *         await db.payments.create(notification.result);
+     *       },
+     *       onError: async (error) => {
+     *         logger.error('Webhook error', error);
+     *       },
+     *     }
+     *   );
+     *
+     *   // Return signed response to Waffo
+     *   res.set(result.response.header).json(result.response.body);
+     * });
+     *
+     * @example
+     * // Next.js API route
+     * export async function POST(request: Request) {
+     *   const body = await request.text();
+     *   const signature = request.headers.get('x-signature') || '';
+     *
+     *   const result = await waffo.webhook.handle(body, signature, {
+     *     onPayment: async (ctx) => { ... },
+     *   });
+     *
+     *   return new Response(JSON.stringify(result.response.body), {
+     *     headers: result.response.header,
+     *   });
+     * }
+     *
+     * @see {@link WebhookHandlerOptions} for handler configuration
+     * @see {@link WebhookHandlerResult} for return type
+     */
+    handle(requestBody: string, signature: string, options?: WebhookHandlerOptions): Promise<WebhookHandlerResult>;
+}
+
+/**
+ * @fileoverview Base Resource Class
+ * @module resources/base
+ *
+ * Abstract base class for all API resource classes.
+ * Defines common structure and dependencies shared by all resources.
+ *
+ * **Resource Inheritance:**
+ * - {@link OrderResource} - Order operations
+ * - {@link RefundResource} - Refund operations
+ * - {@link SubscriptionResource} - Subscription operations
+ * - {@link MerchantConfigResource} - Merchant config operations
+ * - {@link PayMethodConfigResource} - Payment method config operations
+ *
+ * @internal For internal SDK use only
+ */
+
+/**
+ * Abstract base class for all API resources in the Waffo SDK.
+ *
+ * Provides common foundation for all resource classes:
+ * - HTTP client reference for making API requests
+ * - Base path configuration for API endpoints
+ *
+ * @abstract
+ * @class BaseResource
+ * @internal For internal SDK use only
+ *
+ * @see {@link OrderResource} for order operations
+ * @see {@link RefundResource} for refund operations
+ * @see {@link SubscriptionResource} for subscription operations
+ */
+declare abstract class BaseResource {
+    /**
+     * HTTP client for making API requests with automatic signing.
+     * @protected
+     */
+    protected client: HttpClient;
+    /**
+     * Base path for API endpoints (e.g., '/order', '/refund').
+     * @protected
+     */
+    protected basePath: string;
+    /**
+     * Initializes the base resource with HTTP client and base path.
+     *
+     * @param {HttpClient} client - HTTP client instance
+     * @param {string} basePath - Base path for API endpoints
+     * @protected
+     */
+    constructor(client: HttpClient, basePath: string);
+}
+
+/**
+ * @fileoverview Order Resource Implementation
+ * @module resources/order/resource
+ *
+ * Implements the Order resource class providing all order-related API operations.
+ *
+ * @see {@link OrderResource} for the main class
+ * @see {@link CreateOrderParams} for order creation parameters
+ *
+ * @example
+ * // Access via Waffo instance
+ * const result = await waffo.order.create({
+ *   paymentRequestId: 'req-123',
+ *   merchantOrderId: 'order-456',
+ *   orderCurrency: 'USD',
+ *   orderAmount: '10.00',
+ *   // ... other required fields
+ * });
+ */
+
+/**
+ * Order resource for all payment order operations.
+ *
+ * Provides methods for creating, querying, canceling, refunding,
+ * and capturing payment orders.
+ *
+ * @class OrderResource
+ * @extends BaseResource
+ *
+ * @example
+ * // Create an order
+ * const createResult = await waffo.order.create({ ... });
+ *
+ * // Query order status
+ * const inquiryResult = await waffo.order.inquiry({
+ *   acquiringOrderId: createResult.data.acquiringOrderId,
+ * });
+ *
+ * // Request a refund
+ * const refundResult = await waffo.order.refund({
+ *   refundRequestId: 'refund-123',
+ *   acquiringOrderId: createResult.data.acquiringOrderId,
+ *   merchantId: 'M001',
+ *   refundAmount: '5.00',
+ *   refundReason: 'Customer request',
+ * });
+ */
+declare class OrderResource extends BaseResource {
+    /**
+     * Creates an Order resource instance.
+     * @param {HttpClient} client - HTTP client instance
+     */
+    constructor(client: HttpClient);
+    /**
+     * Creates a new payment order.
+     *
+     * Supports multiple payment methods including e-wallet, credit card,
+     * bank transfer, and more.
+     *
+     * @param {CreateOrderParams} params - Order creation parameters
+     * @returns {Promise<ApiResponse<CreateOrderData>>} Order creation result
+     *
+     * @example
+     * const result = await waffo.order.create({
+     *   paymentRequestId: 'req-' + Date.now(),
+     *   merchantOrderId: 'order-456',
+     *   orderCurrency: 'IDR',
+     *   orderAmount: '100000',
+     *   orderDescription: 'Product purchase',
+     *   merchantInfo: { merchantId: 'M001' },
+     *   userInfo: {
+     *     userId: 'U001',
+     *     userEmail: 'user@example.com',
+     *     userTerminal: 'WEB',
+     *   },
+     *   goodsInfo: {
+     *     goodsName: 'Premium Plan',
+     *     goodsUrl: 'https://example.com/product',
+     *   },
+     *   paymentInfo: {
+     *     productName: 'ONE_TIME_PAYMENT',
+     *     payMethodName: 'DANA',
+     *   },
+     *   notifyUrl: 'https://example.com/webhook',
+     *   successRedirectUrl: 'https://example.com/success',
+     * });
+     *
+     * if (result.success) {
+     *   // Redirect user to payment page
+     *   const redirectUrl = result.data.orderAction?.webUrl;
+     * }
+     *
+     * @see {@link CreateOrderParams} for all available parameters
+     */
+    create(params: CreateOrderParams): Promise<ApiResponse<CreateOrderData>>;
+    /**
+     * Queries current order status and details.
+     *
+     * Provide either `paymentRequestId` or `acquiringOrderId` to identify the order.
+     *
+     * @param {InquiryOrderParams} params - Query parameters
+     * @returns {Promise<ApiResponse<InquiryOrderData>>} Order details
+     *
+     * @example
+     * // Query by acquiring order ID
+     * const result = await waffo.order.inquiry({
+     *   acquiringOrderId: 'ACQ123456789',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Order status:', result.data.orderStatus);
+     *   console.log('Amount:', result.data.orderAmount, result.data.orderCurrency);
+     * }
+     *
+     * @example
+     * // Query by payment request ID
+     * const result = await waffo.order.inquiry({
+     *   paymentRequestId: 'req-123',
+     * });
+     *
+     * @see {@link InquiryOrderData} for response structure
+     */
+    inquiry(params: InquiryOrderParams): Promise<ApiResponse<InquiryOrderData>>;
+    /**
+     * Cancels an unpaid order.
+     *
+     * Only orders with status `AUTHORIZATION_REQUIRED` or `PAY_IN_PROGRESS` can be canceled.
+     *
+     * @param {CancelOrderParams} params - Cancel parameters
+     * @returns {Promise<ApiResponse<CancelOrderData>>} Cancellation result
+     *
+     * @example
+     * const result = await waffo.order.cancel({
+     *   acquiringOrderId: 'ACQ123456789',
+     *   merchantId: 'M001',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Order canceled:', result.data.orderStatus);
+     *   // => 'ORDER_CLOSE'
+     * }
+     *
+     * @see {@link CancelOrderData} for response structure
+     */
+    cancel(params: CancelOrderParams): Promise<ApiResponse<CancelOrderData>>;
+    /**
+     * Initiates a refund request for a paid order.
+     *
+     * Supports both full and partial refunds. Multiple partial refunds can be
+     * made until the total refunded amount equals the original order amount.
+     *
+     * @param {RefundOrderParams} params - Refund parameters
+     * @returns {Promise<ApiResponse<CreateRefundData>>} Refund request result
+     *
+     * @example
+     * // Full refund
+     * const result = await waffo.order.refund({
+     *   refundRequestId: 'refund-' + Date.now(),
+     *   acquiringOrderId: 'ACQ123456789',
+     *   merchantId: 'M001',
+     *   refundAmount: '100000',
+     *   refundReason: 'Customer request',
+     *   refundNotifyUrl: 'https://example.com/refund-webhook',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Refund status:', result.data.refundStatus);
+     *   console.log('Remaining refundable:', result.data.remainingRefundAmount);
+     * }
+     *
+     * @example
+     * // Partial refund
+     * const result = await waffo.order.refund({
+     *   refundRequestId: 'refund-partial-123',
+     *   acquiringOrderId: 'ACQ123456789',
+     *   merchantId: 'M001',
+     *   refundAmount: '50000', // Partial amount
+     *   refundReason: 'Partial refund',
+     * });
+     *
+     * @see {@link CreateRefundData} for response structure
+     */
+    refund(params: RefundOrderParams): Promise<ApiResponse<CreateRefundData>>;
+    /**
+     * Captures an authorized payment (manualCapture mode only).
+     *
+     * Converts an authorization to an actual charge. Supports both
+     * partial and full capture amounts.
+     *
+     * @param {CaptureOrderParams} params - Capture parameters
+     * @returns {Promise<ApiResponse<CaptureOrderData>>} Capture result
+     *
+     * @example
+     * // Full capture
+     * const result = await waffo.order.capture({
+     *   acquiringOrderId: 'ACQ123456789',
+     *   merchantId: 'M001',
+     *   captureAmount: '100000', // Full authorized amount
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Capture status:', result.data.orderStatus);
+     * }
+     *
+     * @example
+     * // Partial capture
+     * const result = await waffo.order.capture({
+     *   acquiringOrderId: 'ACQ123456789',
+     *   merchantId: 'M001',
+     *   captureAmount: '75000', // Capture less than authorized
+     * });
+     *
+     * @see {@link CaptureOrderData} for response structure
+     */
+    capture(params: CaptureOrderParams): Promise<ApiResponse<CaptureOrderData>>;
+}
+
+/**
+ * @fileoverview Refund Resource Implementation
+ * @module resources/refund/resource
+ *
+ * Implements the Refund resource class providing refund inquiry operations.
+ *
+ * @see {@link RefundResource} for the main class
+ * @see {@link RefundInquiryParams} for inquiry parameters
+ *
+ * @example
+ * // Query refund status
+ * const result = await waffo.refund.inquiry({
+ *   refundRequestId: 'refund-123',
+ * });
+ */
+
+/**
+ * Refund resource for querying refund status and details.
+ *
+ * Note: Refund creation is done through {@link OrderResource.refund}.
+ *
+ * @class RefundResource
+ * @extends BaseResource
+ *
+ * @example
+ * const result = await waffo.refund.inquiry({
+ *   acquiringRefundOrderId: 'REF123456789',
+ * });
+ *
+ * if (result.success) {
+ *   console.log('Refund status:', result.data.refundStatus);
+ * }
+ */
+declare class RefundResource extends BaseResource {
+    /**
+     * Creates a Refund resource instance.
+     * @param {HttpClient} client - HTTP client instance
+     */
+    constructor(client: HttpClient);
+    /**
+     * Queries current refund status and details.
+     *
+     * Provide either `refundRequestId` or `acquiringRefundOrderId` to identify the refund.
+     *
+     * @param {RefundInquiryParams} params - Query parameters
+     * @returns {Promise<ApiResponse<InquiryRefundData>>} Refund details
+     *
+     * @example
+     * // Query by refund request ID
+     * const result = await waffo.refund.inquiry({
+     *   refundRequestId: 'refund-123',
+     * });
+     *
+     * if (result.success) {
+     *   const { refundStatus, refundAmount, remainingRefundAmount } = result.data;
+     *   console.log(`Status: ${refundStatus}`);
+     *   console.log(`Refunded: ${refundAmount}`);
+     *   console.log(`Remaining: ${remainingRefundAmount}`);
+     * }
+     *
+     * @example
+     * // Query by acquiring refund order ID
+     * const result = await waffo.refund.inquiry({
+     *   acquiringRefundOrderId: 'REF123456789',
+     * });
+     *
+     * @see {@link InquiryRefundData} for response structure
+     */
+    inquiry(params: RefundInquiryParams): Promise<ApiResponse<InquiryRefundData>>;
+}
+
+/**
+ * @fileoverview Subscription Resource Implementation
+ * @module resources/subscription/resource
+ *
+ * Implements the Subscription resource class providing all subscription-related
+ * API operations for recurring payments.
+ *
+ * @see {@link SubscriptionResource} for the main class
+ * @see {@link CreateSubscriptionParams} for subscription creation parameters
+ *
+ * @example
+ * // Create a subscription
+ * const result = await waffo.subscription.create({
+ *   subscriptionRequest: 'sub-req-123',
+ *   currency: 'USD',
+ *   amount: '9.99',
+ *   productInfo: {
+ *     description: 'Monthly Premium',
+ *     periodType: 'MONTHLY',
+ *     periodInterval: '1',
+ *   },
+ *   // ... other required fields
+ * });
+ */
+
+/**
+ * Subscription resource for recurring payment operations.
+ *
+ * Provides methods for creating, querying, canceling, and managing subscriptions.
+ *
+ * @class SubscriptionResource
+ * @extends BaseResource
+ *
+ * @example
+ * // Full subscription lifecycle
+ * const createResult = await waffo.subscription.create({ ... });
+ * const inquiryResult = await waffo.subscription.inquiry({
+ *   subscriptionId: createResult.data.subscriptionId,
+ * });
+ * const cancelResult = await waffo.subscription.cancel({
+ *   subscriptionId: createResult.data.subscriptionId,
+ *   merchantId: 'M001',
+ * });
+ */
+declare class SubscriptionResource extends BaseResource {
+    /**
+     * Creates a Subscription resource instance.
+     * @param {HttpClient} client - HTTP client instance
+     */
+    constructor(client: HttpClient);
+    /**
+     * Creates a new subscription signing request for recurring payments.
+     *
+     * After creation, redirect the user to the signing URL to authorize
+     * the recurring payment agreement.
+     *
+     * @param {CreateSubscriptionParams} params - Subscription creation parameters
+     * @returns {Promise<ApiResponse<CreateSubscriptionData>>} Subscription creation result
+     *
+     * @example
+     * const result = await waffo.subscription.create({
+     *   subscriptionRequest: 'sub-' + Date.now(),
+     *   currency: 'HKD',
+     *   amount: '99.00',
+     *   productInfo: {
+     *     description: 'Premium Monthly Plan',
+     *     periodType: 'MONTHLY',
+     *     periodInterval: '1',
+     *     numberOfPeriod: '12', // 12 months
+     *   },
+     *   merchantInfo: { merchantId: 'M001' },
+     *   userInfo: {
+     *     userId: 'U001',
+     *     userEmail: 'user@example.com',
+     *   },
+     *   goodsInfo: {
+     *     goodsId: 'PREMIUM-PLAN',
+     *     goodsName: 'Premium Plan',
+     *     goodsUrl: 'https://example.com/plan',
+     *   },
+     *   paymentInfo: {
+     *     productName: 'SUBSCRIPTION',
+     *     payMethodName: 'ALIPAY_HK',
+     *   },
+     *   notifyUrl: 'https://example.com/webhook',
+     *   successRedirectUrl: 'https://example.com/success',
+     * });
+     *
+     * if (result.success) {
+     *   // Redirect user to subscription signing page
+     *   const signingUrl = result.data.subscriptionAction?.webUrl;
+     * }
+     *
+     * @see {@link CreateSubscriptionData} for response structure
+     */
+    create(params: CreateSubscriptionParams): Promise<ApiResponse<CreateSubscriptionData>>;
+    /**
+     * Queries subscription details and optionally payment history.
+     *
+     * @param {InquirySubscriptionParams} params - Query parameters
+     * @returns {Promise<ApiResponse<InquirySubscriptionData>>} Subscription details
+     *
+     * @example
+     * // Query subscription status
+     * const result = await waffo.subscription.inquiry({
+     *   subscriptionId: 'SUB123456789',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Status:', result.data.subscriptionStatus);
+     *   console.log('Next payment:', result.data.productInfo.nextPaymentDateTime);
+     * }
+     *
+     * @example
+     * // Query with payment history
+     * const result = await waffo.subscription.inquiry({
+     *   subscriptionId: 'SUB123456789',
+     *   paymentDetails: '1', // Include payment history
+     * });
+     *
+     * if (result.success && result.data.paymentDetails) {
+     *   result.data.paymentDetails.forEach(payment => {
+     *     console.log(`Period ${payment.period}: ${payment.orderStatus}`);
+     *   });
+     * }
+     *
+     * @see {@link InquirySubscriptionData} for response structure
+     */
+    inquiry(params: InquirySubscriptionParams): Promise<ApiResponse<InquirySubscriptionData>>;
+    /**
+     * Cancels an active subscription.
+     *
+     * Once canceled, no further recurring payments will be processed.
+     *
+     * @param {CancelSubscriptionParams} params - Cancel parameters
+     * @returns {Promise<ApiResponse<CancelSubscriptionData>>} Cancellation result
+     *
+     * @example
+     * const result = await waffo.subscription.cancel({
+     *   subscriptionId: 'SUB123456789',
+     *   merchantId: 'M001',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Subscription canceled:', result.data.orderStatus);
+     *   // => 'MERCHANT_CANCELLED'
+     * }
+     *
+     * @see {@link CancelSubscriptionData} for response structure
+     */
+    cancel(params: CancelSubscriptionParams): Promise<ApiResponse<CancelSubscriptionData>>;
+    /**
+     * Generates a temporary management URL for users to manage their subscription.
+     *
+     * The URL allows users to view subscription details and cancel if needed.
+     * The URL expires after a certain period (check `expiredAt` in response).
+     *
+     * @param {ManageSubscriptionParams} params - Management parameters
+     * @returns {Promise<ApiResponse<ManageSubscriptionData>>} Management URL and expiration
+     *
+     * @example
+     * const result = await waffo.subscription.manage({
+     *   subscriptionId: 'SUB123456789',
+     * });
+     *
+     * if (result.success) {
+     *   console.log('Management URL:', result.data.managementUrl);
+     *   console.log('Expires at:', result.data.expiredAt);
+     *   // Send URL to user via email or display in app
+     * }
+     *
+     * @see {@link ManageSubscriptionData} for response structure
+     */
+    manage(params: ManageSubscriptionParams): Promise<ApiResponse<ManageSubscriptionData>>;
+}
+
+/**
+ * @fileoverview Merchant Config Resource Implementation
+ * @module resources/merchantconfig/resource
+ *
+ * Implements the Merchant Config resource class providing merchant
+ * configuration inquiry operations.
+ *
+ * @see {@link MerchantConfigResource} for the main class
+ * @see {@link MerchantConfigInquiryParams} for inquiry parameters
+ *
+ * @example
+ * const result = await waffo.merchantConfig.inquiry({
+ *   merchantId: 'M001',
+ * });
+ */
+
+/**
+ * Merchant configuration resource for querying transaction limits.
+ *
+ * Use this to retrieve daily limits, remaining limits, and
+ * per-transaction limits for a merchant.
+ *
+ * @class MerchantConfigResource
+ * @extends BaseResource
+ *
+ * @example
+ * const result = await waffo.merchantConfig.inquiry({ merchantId: 'M001' });
+ * if (result.success) {
+ *   console.log('Daily limit:', result.data.totalDailyLimit);
+ *   console.log('Remaining:', result.data.remainingDailyLimit);
+ * }
+ */
+declare class MerchantConfigResource extends BaseResource {
+    /**
+     * Creates a Merchant Config resource instance.
+     * @param {HttpClient} client - HTTP client instance
+     */
+    constructor(client: HttpClient);
+    /**
+     * Queries merchant configuration including transaction limits.
+     *
+     * @param {MerchantConfigInquiryParams} params - Query parameters
+     * @returns {Promise<ApiResponse<MerchantConfigInquiryData>>} Merchant configuration
+     *
+     * @example
+     * const result = await waffo.merchantConfig.inquiry({
+     *   merchantId: 'M001',
+     * });
+     *
+     * if (result.success) {
+     *   const { totalDailyLimit, remainingDailyLimit, transactionLimit } = result.data;
+     *
+     *   // Limits are returned as currency -> value maps
+     *   console.log('Daily limit (USD):', totalDailyLimit?.['USD']);
+     *   console.log('Remaining (USD):', remainingDailyLimit?.['USD']);
+     *   console.log('Per transaction (USD):', transactionLimit?.['USD']);
+     * }
+     *
+     * @see {@link MerchantConfigInquiryData} for response structure
+     */
+    inquiry(params: MerchantConfigInquiryParams): Promise<ApiResponse<MerchantConfigInquiryData>>;
+}
+
+/**
+ * @fileoverview Pay Method Config Resource Implementation
+ * @module resources/paymethodconfig/resource
+ *
+ * Implements the Pay Method Config resource class providing payment method
+ * configuration inquiry operations.
+ *
+ * @see {@link PayMethodConfigResource} for the main class
+ * @see {@link PayMethodConfigInquiryParams} for inquiry parameters
+ *
+ * @example
+ * const result = await waffo.payMethodConfig.inquiry({
+ *   merchantId: 'M001',
+ * });
+ */
+
+/**
+ * Payment method configuration resource for querying available methods.
+ *
+ * Use this to retrieve available payment methods, their current status,
+ * and scheduled maintenance windows.
+ *
+ * @class PayMethodConfigResource
+ * @extends BaseResource
+ *
+ * @example
+ * const result = await waffo.payMethodConfig.inquiry({ merchantId: 'M001' });
+ * if (result.success) {
+ *   const availableMethods = result.data.payMethodDetails.filter(
+ *     m => m.currentStatus === '1'
+ *   );
+ * }
+ */
+declare class PayMethodConfigResource extends BaseResource {
+    /**
+     * Creates a Pay Method Config resource instance.
+     * @param {HttpClient} client - HTTP client instance
+     */
+    constructor(client: HttpClient);
+    /**
+     * Queries available payment methods and their status.
+     *
+     * @param {PayMethodConfigInquiryParams} params - Query parameters
+     * @returns {Promise<ApiResponse<PayMethodConfigInquiryData>>} Payment method details
+     *
+     * @example
+     * const result = await waffo.payMethodConfig.inquiry({
+     *   merchantId: 'M001',
+     * });
+     *
+     * if (result.success) {
+     *   result.data.payMethodDetails.forEach(method => {
+     *     const status = method.currentStatus === '1' ? 'Available' : 'Unavailable';
+     *     console.log(`${method.payMethodName} (${method.country}): ${status}`);
+     *
+     *     // Check maintenance windows
+     *     if (method.fixedMaintenanceRules?.length) {
+     *       console.log('  Maintenance:', method.fixedMaintenanceRules);
+     *     }
+     *   });
+     * }
+     *
+     * @example
+     * // Filter available e-wallet methods
+     * const ewallets = result.data.payMethodDetails.filter(
+     *   m => m.currentStatus === '1' && m.productName === 'ONE_TIME_PAYMENT'
+     * );
+     *
+     * @see {@link PayMethodConfigInquiryData} for response structure
+     */
+    inquiry(params: PayMethodConfigInquiryParams): Promise<ApiResponse<PayMethodConfigInquiryData>>;
+}
+
+/**
+ * @fileoverview Waffo SDK Main Entry Point
+ * @module core/waffo
+ *
+ * Provides the main SDK class for interacting with the Waffo Payment Platform.
+ *
+ * **Supported Operations:**
+ * - Order management (create, inquiry, cancel, refund, capture)
+ * - Refund status inquiry
+ * - Subscription management (create, inquiry, cancel, manage)
+ * - Merchant and payment method configuration inquiry
+ *
+ * @see {@link WaffoConfig} for SDK configuration options
+ * @see {@link OrderResource} for order operations
+ * @see {@link SubscriptionResource} for subscription operations
+ *
+ * @example
+ * // Initialize the SDK
+ * import { Waffo, Environment } from 'waffo-sdk';
+ *
+ * const waffo = new Waffo({
+ *   apiKey: 'your-api-key',
+ *   privateKey: 'your-base64-encoded-private-key',
+ *   environment: Environment.SANDBOX,
+ * });
+ *
+ * // Create a payment order
+ * const result = await waffo.order.create({
+ *   paymentRequestId: 'req-123',
+ *   merchantOrderId: 'order-456',
+ *   orderCurrency: 'USD',
+ *   orderAmount: '10.00',
+ *   // ... other required fields
+ * });
+ */
+
+/**
+ * Main SDK class for the Waffo Payment Platform.
+ *
+ * Provides a unified interface for all payment operations with automatic
+ * RSA-SHA256 request signing and response verification.
+ *
+ * **Features:**
+ * - Order operations: create, inquiry, cancel, refund, capture
+ * - Refund inquiry
+ * - Subscription management: create, inquiry, cancel, manage
+ * - Configuration queries: merchant limits, payment methods
+ *
+ * @class Waffo
+ *
+ * @example
+ * // Basic SDK initialization
+ * const waffo = new Waffo({
+ *   apiKey: 'your-api-key',
+ *   privateKey: 'base64-encoded-pkcs8-private-key',
+ *   environment: Environment.PRODUCTION,
+ * });
+ *
+ * @example
+ * // Create and query an order
+ * const createResult = await waffo.order.create({ ... });
+ * if (createResult.success) {
+ *   const inquiryResult = await waffo.order.inquiry({
+ *     acquiringOrderId: createResult.data.acquiringOrderId,
+ *   });
+ * }
+ *
+ * @example
+ * // Handle webhooks
+ * const result = await waffo.webhook.handle(requestBody, signature, {
+ *   onPayment: async (ctx) => {
+ *     console.log('Payment received:', ctx.notification.result.orderStatus);
+ *   },
+ * });
+ *
+ * @see {@link WaffoConfig} - Configuration options
+ * @see {@link OrderResource} - Order operations
+ * @see {@link SubscriptionResource} - Subscription operations
+ */
+declare class Waffo {
+    /**
+     * Order resource for payment processing operations.
+     *
+     * **Available methods:**
+     * - `create()` - Create a new payment order
+     * - `inquiry()` - Query order status and details
+     * - `cancel()` - Cancel an unpaid order
+     * - `refund()` - Request a refund for a paid order
+     * - `capture()` - Capture an authorized payment (manualCapture mode)
+     *
+     * @type {OrderResource}
+     * @readonly
+     *
+     * @example
+     * const result = await waffo.order.create({
+     *   paymentRequestId: 'req-123',
+     *   merchantOrderId: 'order-456',
+     *   orderCurrency: 'USD',
+     *   orderAmount: '10.00',
+     *   orderDescription: 'Product purchase',
+     *   merchantInfo: { merchantId: 'M001' },
+     *   userInfo: { userId: 'U001', userEmail: 'user@example.com', userTerminal: 'WEB' },
+     *   goodsInfo: { goodsName: 'Product', goodsUrl: 'https://example.com/product' },
+     *   paymentInfo: { productName: 'ONE_TIME_PAYMENT', payMethodName: 'DANA' },
+     *   notifyUrl: 'https://example.com/webhook',
+     * });
+     *
+     * @see {@link OrderResource}
+     */
+    readonly order: OrderResource;
+    /**
+     * Refund resource for querying refund status.
+     *
+     * **Available methods:**
+     * - `inquiry()` - Query refund status by refundRequestId or acquiringRefundOrderId
+     *
+     * @type {RefundResource}
+     * @readonly
+     *
+     * @example
+     * const result = await waffo.refund.inquiry({
+     *   refundRequestId: 'refund-req-123',
+     * });
+     * if (result.success) {
+     *   console.log('Refund status:', result.data.refundStatus);
+     * }
+     *
+     * @see {@link RefundResource}
+     */
+    readonly refund: RefundResource;
+    /**
+     * Subscription resource for recurring payment operations.
+     *
+     * **Available methods:**
+     * - `create()` - Create a new subscription signing request
+     * - `inquiry()` - Query subscription status and payment history
+     * - `cancel()` - Cancel an active subscription
+     * - `manage()` - Generate a temporary management URL for users
+     *
+     * @type {SubscriptionResource}
+     * @readonly
+     *
+     * @example
+     * const result = await waffo.subscription.create({
+     *   subscriptionRequest: 'sub-req-123',
+     *   currency: 'USD',
+     *   amount: '9.99',
+     *   productInfo: {
+     *     description: 'Monthly subscription',
+     *     periodType: 'MONTHLY',
+     *     periodInterval: '1',
+     *   },
+     *   // ... other required fields
+     * });
+     *
+     * @see {@link SubscriptionResource}
+     */
+    readonly subscription: SubscriptionResource;
+    /**
+     * Merchant configuration resource for querying transaction limits.
+     *
+     * **Available methods:**
+     * - `inquiry()` - Query daily limits, remaining limits, and transaction limits
+     *
+     * @type {MerchantConfigResource}
+     * @readonly
+     *
+     * @example
+     * const result = await waffo.merchantConfig.inquiry({
+     *   merchantId: 'M001',
+     * });
+     * if (result.success) {
+     *   console.log('Daily limit:', result.data.totalDailyLimit);
+     * }
+     *
+     * @see {@link MerchantConfigResource}
+     */
+    readonly merchantConfig: MerchantConfigResource;
+    /**
+     * Payment method configuration resource for querying available methods.
+     *
+     * **Available methods:**
+     * - `inquiry()` - Query available payment methods, status, and maintenance schedules
+     *
+     * @type {PayMethodConfigResource}
+     * @readonly
+     *
+     * @example
+     * const result = await waffo.payMethodConfig.inquiry({
+     *   merchantId: 'M001',
+     * });
+     * if (result.success) {
+     *   result.data.payMethodDetails.forEach(method => {
+     *     console.log(`${method.payMethodName}: ${method.currentStatus === '1' ? 'Available' : 'Unavailable'}`);
+     *   });
+     * }
+     *
+     * @see {@link PayMethodConfigResource}
+     */
+    readonly payMethodConfig: PayMethodConfigResource;
+    /**
+     * Low-level HTTP client for direct API requests.
+     *
+     * All requests are automatically signed and responses are verified.
+     * Use this for custom endpoints not covered by the resource classes.
+     *
+     * @type {HttpClient}
+     * @readonly
+     *
+     * @example
+     * // Make a custom API request
+     * const result = await waffo.httpClient.post('/custom/endpoint', {
+     *   body: { customField: 'value' },
+     * });
+     *
+     * @see {@link HttpClient}
+     */
+    readonly httpClient: HttpClient;
+    /**
+     * Webhook handler for processing incoming notifications from Waffo.
+     *
+     * Use `handle()` method to process webhook notifications with custom handlers.
+     *
+     * @type {WebhookHandler}
+     * @readonly
+     *
+     * @example
+     * // Express.js webhook endpoint
+     * app.post('/webhook', async (req, res) => {
+     *   const result = await waffo.webhook.handle(
+     *     JSON.stringify(req.body),
+     *     req.headers['x-signature'],
+     *     {
+     *       onPayment: async (ctx) => {
+     *         await updateOrderStatus(ctx.notification.result);
+     *       },
+     *       onRefund: async (ctx) => {
+     *         await processRefund(ctx.notification.result);
+     *       },
+     *     }
+     *   );
+     *   res.set(result.response.header).json(result.response.body);
+     * });
+     *
+     * @see {@link WebhookHandler}
+     */
+    readonly webhook: WebhookHandler;
+    /**
+     * Creates a new Waffo SDK instance.
+     *
+     * Initializes the SDK with the provided configuration. The SDK automatically
+     * selects the appropriate API endpoint and public key based on the environment.
+     *
+     * @param {WaffoConfig} config - SDK configuration object
+     * @param {string} config.apiKey - API key assigned by Waffo (required)
+     * @param {string} config.privateKey - Merchant private key, Base64 encoded PKCS8 DER format (required)
+     * @param {string} [config.waffoPublicKey] - Waffo public key for response verification (optional)
+     * @param {Environment} [config.environment=Environment.PRODUCTION] - API environment (optional)
+     * @param {number} [config.timeout=30000] - Request timeout in milliseconds (optional)
+     * @param {Logger} [config.logger] - Logger instance for debugging (optional)
+     *
+     * @throws {Error} When API key or private key is missing or invalid
+     *
+     * @example
+     * // Production configuration
+     * const waffo = new Waffo({
+     *   apiKey: process.env.WAFFO_API_KEY,
+     *   privateKey: process.env.WAFFO_PRIVATE_KEY,
+     *   environment: Environment.PRODUCTION,
+     * });
+     *
+     * @example
+     * // Sandbox configuration with debugging
+     * const waffo = new Waffo({
+     *   apiKey: 'sandbox-api-key',
+     *   privateKey: 'sandbox-private-key',
+     *   environment: Environment.SANDBOX,
+     *   timeout: 60000,
+     *   logger: console,
+     * });
+     *
+     * @see {@link WaffoConfig} for configuration options
+     * @see {@link Environment} for available environments
+     */
+    constructor(config: WaffoConfig);
+    /**
+     * Generates a new 2048-bit RSA key pair for API signing and verification.
+     *
+     * **Generated key formats:**
+     * - Private key: Base64 encoded PKCS8 DER format (for signing requests)
+     * - Public key: Base64 encoded X509/SPKI DER format (for verification)
+     *
+     * **Usage:**
+     * 1. Generate a key pair using this method
+     * 2. Register the public key with Waffo via merchant dashboard
+     * 3. Store the private key securely on your server
+     * 4. Use the private key when initializing the SDK
+     *
+     * @static
+     * @returns {KeyPair} Object containing the generated key pair
+     *
+     * @example
+     * // Generate a new key pair
+     * const keys = Waffo.generateKeyPair();
+     * console.log('Private Key:', keys.privateKey);
+     * console.log('Public Key:', keys.publicKey);
+     *
+     * // Use the private key to initialize SDK
+     * const waffo = new Waffo({
+     *   apiKey: 'your-api-key',
+     *   privateKey: keys.privateKey,
+     * });
+     *
+     * @see {@link KeyPair} for the return type structure
+     */
+    static generateKeyPair(): KeyPair;
+}
+
+/**
+ * @fileoverview RSA Cryptographic Utility Functions
+ * @module utils/rsa
+ *
+ * Provides RSA cryptographic operations for the Waffo SDK:
+ * - **{@link signForRSA}** - Sign data using RSA-SHA256
+ * - **{@link verify}** - Verify RSA-SHA256 signatures
+ * - **{@link createKeyPair}** - Generate new RSA key pairs
+ *
+ * **Key Formats:**
+ * - Private keys: Base64 encoded PKCS8 DER format
+ * - Public keys: Base64 encoded X509/SPKI DER format
+ *
+ * @see {@link HttpClient} for automatic request signing
+ * @see {@link verifyWebhookSignature} for webhook verification
+ *
+ * @example
+ * import { signForRSA, verify, createKeyPair } from 'waffo-sdk';
+ *
+ * // Generate a new key pair
+ * const keys = createKeyPair();
+ *
+ * // Sign data
+ * const data = JSON.stringify({ message: 'Hello' });
+ * const signature = signForRSA(data, keys.PRIVATE_KEY_NAME);
+ *
+ * // Verify signature
+ * const isValid = verify(data, signature, keys.PUBLIC_KEY_NAME);
+ */
+/**
+ * Callback function for handling cryptographic errors.
+ *
+ * When provided to signing/verification functions, errors are passed
+ * to this callback instead of causing the function to throw.
+ *
+ * @typedef {Function} ErrorHandler
+ * @param {Error} error - The error that occurred
+ *
+ * @example
+ * const signature = signForRSA(data, privateKey, 'utf8', (error) => {
+ *   console.error('Signing failed:', error.message);
+ * });
+ */
+type ErrorHandler = (error: Error) => void;
+/**
+ * Signs a payload using RSA-SHA256 algorithm.
+ *
+ * Returns a Base64 encoded signature. Used internally by the SDK to sign
+ * all outgoing API requests (included in `X-SIGNATURE` header).
+ *
+ * @param {string} body - Payload to sign (typically JSON serialized)
+ * @param {string} privateKey - Private key (Base64 encoded PKCS8 DER format)
+ * @param {string} [charSet='utf8'] - Character encoding ('utf8', 'ascii', 'latin1')
+ * @param {ErrorHandler} [onError] - Optional error handler callback
+ *
+ * @returns {string | null} Base64 encoded signature, or `null` on failure
+ *
+ * @example
+ * // Sign a JSON payload
+ * const payload = JSON.stringify({ orderId: '123', amount: '100' });
+ * const signature = signForRSA(payload, privateKey);
+ *
+ * if (signature) {
+ *   console.log('Signature:', signature);
+ * }
+ *
+ * @example
+ * // With error handling
+ * const signature = signForRSA(payload, privateKey, 'utf8', (error) => {
+ *   console.error('Signing failed:', error.message);
+ * });
+ *
+ * @see {@link verify} for signature verification
+ * @see {@link createKeyPair} for generating key pairs
+ */
+declare function signForRSA(body: string, privateKey: string, charSet?: string, onError?: ErrorHandler): string | null;
+/**
+ * Verifies an RSA-SHA256 signature.
+ *
+ * Returns `true` if the signature is valid. Used internally by the SDK
+ * to verify API response and webhook notification signatures.
+ *
+ * @param {string} body - Original payload that was signed
+ * @param {string} sign - Signature to verify (Base64 encoded)
+ * @param {string} publicKey - Public key (Base64 encoded X509/SPKI DER format)
+ * @param {string} [charSet='utf8'] - Character encoding (must match signing)
+ * @param {ErrorHandler} [onError] - Optional error handler callback
+ *
+ * @returns {boolean} `true` if signature is valid, `false` otherwise
+ *
+ * @example
+ * // Verify a signature
+ * const isValid = verify(payload, signature, publicKey);
+ *
+ * if (isValid) {
+ *   console.log('Signature verified successfully');
+ * } else {
+ *   console.log('Invalid signature');
+ * }
+ *
+ * @example
+ * // With error handling
+ * const isValid = verify(payload, signature, publicKey, 'utf8', (error) => {
+ *   console.error('Verification error:', error.message);
+ * });
+ *
+ * @see {@link signForRSA} for signature generation
+ * @see {@link verifyWebhookSignature} for webhook verification
+ */
+declare function verify(body: string, sign: string, publicKey: string, charSet?: string, onError?: ErrorHandler): boolean;
+/**
+ * Generates a new 2048-bit RSA key pair for Waffo API authentication.
+ *
+ * **Generated Key Formats:**
+ * - Private key: Base64 encoded PKCS8 DER format (for signing)
+ * - Public key: Base64 encoded X509/SPKI DER format (for verification)
+ *
+ * **Usage:**
+ * 1. Generate a key pair using this function
+ * 2. Register the public key with Waffo via merchant dashboard
+ * 3. Store the private key securely on your server
+ * 4. Use the private key when initializing the SDK
+ *
+ * **Security Notes:**
+ * - Never expose the private key in client-side code
+ * - Store privately (environment variables, secrets manager)
+ * - Use different keys for sandbox/production
+ *
+ * @returns {{ PRIVATE_KEY_NAME: string, PUBLIC_KEY_NAME: string }} Generated key pair
+ *
+ * @example
+ * // Generate a new key pair
+ * const keys = createKeyPair();
+ *
+ * console.log('Private Key (store securely):');
+ * console.log(keys.PRIVATE_KEY_NAME);
+ *
+ * console.log('Public Key (register with Waffo):');
+ * console.log(keys.PUBLIC_KEY_NAME);
+ *
+ * @example
+ * // Use the generated private key with SDK
+ * const waffo = new Waffo({
+ *   apiKey: 'your-api-key',
+ *   privateKey: keys.PRIVATE_KEY_NAME,
+ * });
+ *
+ * @see {@link Waffo.generateKeyPair} for static access via Waffo class
+ */
+declare function createKeyPair(): {
+    PRIVATE_KEY_NAME: string;
+    PUBLIC_KEY_NAME: string;
+};
+
+/**
+ * @fileoverview Webhook Utility Functions
+ * @module utils/webhook
+ *
+ * Utility functions for handling Waffo webhook notifications:
+ * - **{@link verifyWebhookSignature}** - Verify incoming webhook signatures
+ * - **{@link buildWebhookResponse}** - Build signed webhook responses
+ * - **{@link buildSuccessResponse}** - Shorthand for success responses
+ * - **{@link buildFailedResponse}** - Shorthand for failure responses
+ * - **Type guard functions** - Check notification types
+ *
+ * **Webhook Flow:**
+ * 1. Receive webhook POST request from Waffo
+ * 2. Verify the X-SIGNATURE header
+ * 3. Process the notification based on event type
+ * 4. Return a signed response
+ *
+ * @see {@link WebhookEventType} for notification types
+ * @see {@link WebhookResponseStatus} for response statuses
+ *
+ * @example
+ * import {
+ *   verifyWebhookSignature,
+ *   buildSuccessResponse,
+ *   isPaymentNotification,
+ * } from 'waffo-sdk';
+ *
+ * // In your webhook handler
+ * const result = verifyWebhookSignature(body, signature, waffoPublicKey);
+ * if (result.isValid && isPaymentNotification(result.notification)) {
+ *   // Process payment notification
+ *   await processPayment(result.notification);
+ *   return buildSuccessResponse(merchantPrivateKey);
+ * }
+ */
+
+/**
+ * Union type representing all webhook notification types from Waffo.
+ *
+ * Use type guard functions to narrow down the specific type:
+ * - {@link isPaymentNotification} - Payment notifications
+ * - {@link isRefundNotification} - Refund notifications
+ * - {@link isSubscriptionStatusNotification} - Subscription status changes
+ * - {@link isSubscriptionPaymentNotification} - Subscription payments
+ *
+ * @typedef {PaymentNotification | RefundNotification | SubscriptionNotification} AnyWebhookNotification
+ */
+type AnyWebhookNotification = PaymentNotification | RefundNotification | SubscriptionNotification;
+/**
+ * Result of webhook signature verification.
+ *
+ * Contains verification status and parsed notification data.
+ *
+ * @interface WebhookVerificationResult
+ *
+ * @example
+ * const result = verifyWebhookSignature(body, signature, publicKey);
+ * if (result.isValid) {
+ *   console.log('Event type:', result.eventType);
+ *   console.log('Notification:', result.notification);
+ * } else {
+ *   console.error('Verification failed:', result.error);
+ * }
+ */
+interface WebhookVerificationResult {
+    /** Whether the signature verification passed */
+    isValid: boolean;
+    /** Parsed notification data (only when isValid is true) */
+    notification?: AnyWebhookNotification;
+    /** Event type from the notification (only when isValid is true) */
+    eventType?: WebhookEventType;
+    /** Error message (only when isValid is false) */
+    error?: string;
+}
+/**
+ * Verifies the signature of a webhook notification from Waffo.
+ *
+ * @param {string} requestBody - Raw request body string (JSON)
+ * @param {string} signature - X-SIGNATURE header value from Waffo
+ * @param {string} waffoPublicKey - Waffo's public key (Base64 encoded X509 DER)
+ * @returns {WebhookVerificationResult} Verification result with parsed notification
+ *
+ * @example
+ * // Express.js webhook handler
+ * app.post('/webhook', (req, res) => {
+ *   const result = verifyWebhookSignature(
+ *     JSON.stringify(req.body),
+ *     req.headers['x-signature'],
+ *     waffoPublicKey
+ *   );
+ *
+ *   if (!result.isValid) {
+ *     console.error('Invalid signature:', result.error);
+ *     return res.status(400).send('Invalid signature');
+ *   }
+ *
+ *   console.log('Event type:', result.eventType);
+ *   console.log('Notification:', result.notification);
+ *
+ *   // Process notification...
+ * });
+ *
+ * @see {@link WebhookVerificationResult} for return type
+ */
+declare function verifyWebhookSignature(requestBody: string, signature: string, waffoPublicKey: string): WebhookVerificationResult;
+/**
+ * Builds a properly signed webhook response to send back to Waffo.
+ *
+ * @param {WebhookResponseStatus} status - Response status (SUCCESS, FAILED, UNKNOWN)
+ * @param {string} merchantPrivateKey - Merchant's private key (Base64 encoded PKCS8 DER)
+ * @returns {WebhookResponse} Complete response with signed header
+ * @throws {Error} "Failed to sign webhook response" when signing fails
+ *
+ * @example
+ * // Build and send response
+ * const response = buildWebhookResponse(
+ *   WebhookResponseStatus.SUCCESS,
+ *   merchantPrivateKey
+ * );
+ *
+ * res.set(response.header).json(response.body);
+ *
+ * @example
+ * // With error status
+ * const response = buildWebhookResponse(
+ *   WebhookResponseStatus.FAILED,
+ *   merchantPrivateKey
+ * );
+ * // Waffo will retry the notification
+ *
+ * @see {@link buildSuccessResponse} for shorthand success response
+ * @see {@link buildFailedResponse} for shorthand failure response
+ */
+declare function buildWebhookResponse(status: WebhookResponseStatus, merchantPrivateKey: string): WebhookResponse;
+/**
+ * Builds a success webhook response (shorthand).
+ *
+ * Use when the notification was successfully processed.
+ * Equivalent to `buildWebhookResponse(WebhookResponseStatus.SUCCESS, merchantPrivateKey)`.
+ *
+ * @param {string} merchantPrivateKey - Merchant's private key (Base64 encoded PKCS8 DER)
+ * @returns {WebhookResponse} Response with SUCCESS status
+ * @throws {Error} "Failed to sign webhook response" when signing fails
+ *
+ * @example
+ * // After successful processing
+ * const response = buildSuccessResponse(merchantPrivateKey);
+ * res.set(response.header).json(response.body);
+ *
+ * @see {@link buildFailedResponse} for failure responses
+ */
+declare function buildSuccessResponse(merchantPrivateKey: string): WebhookResponse;
+/**
+ * Builds a failed webhook response (shorthand).
+ *
+ * Use when notification processing failed (database error, validation error, etc.).
+ * **Waffo will retry the notification within 24 hours using exponential backoff.**
+ *
+ * Equivalent to `buildWebhookResponse(WebhookResponseStatus.FAILED, merchantPrivateKey)`.
+ *
+ * @param {string} merchantPrivateKey - Merchant's private key (Base64 encoded PKCS8 DER)
+ * @returns {WebhookResponse} Response with FAILED status
+ * @throws {Error} "Failed to sign webhook response" when signing fails
+ *
+ * @example
+ * // When processing fails
+ * try {
+ *   await processNotification(notification);
+ *   return buildSuccessResponse(merchantPrivateKey);
+ * } catch (error) {
+ *   console.error('Processing failed:', error);
+ *   return buildFailedResponse(merchantPrivateKey);
+ *   // Waffo will retry later
+ * }
+ *
+ * @see {@link buildSuccessResponse} for success responses
+ */
+declare function buildFailedResponse(merchantPrivateKey: string): WebhookResponse;
+/**
+ * Extracts the event type from a webhook notification.
+ *
+ * Accepts either a parsed notification object or raw JSON string.
+ *
+ * @param {AnyWebhookNotification | string} notification - Parsed object or raw JSON
+ * @returns {WebhookEventType | undefined} Event type, or `undefined` if invalid
+ *
+ * @example
+ * // From parsed notification
+ * const eventType = getWebhookEventType(notification);
+ * // => 'PAYMENT_NOTIFICATION'
+ *
+ * @example
+ * // From raw JSON string
+ * const eventType = getWebhookEventType(requestBody);
+ *
+ * switch (eventType) {
+ *   case WebhookEventType.PAYMENT_NOTIFICATION:
+ *     handlePayment(notification);
+ *     break;
+ *   case WebhookEventType.REFUND_NOTIFICATION:
+ *     handleRefund(notification);
+ *     break;
+ * }
+ *
+ * @see {@link WebhookEventType} for available event types
+ */
+declare function getWebhookEventType(notification: AnyWebhookNotification | string): WebhookEventType | undefined;
+/**
+ * Type guard: checks if notification is a payment notification.
+ *
+ * Payment notifications are sent when a one-time/direct payment order status changes.
+ * When this returns `true`, TypeScript narrows the type to {@link PaymentNotification}.
+ *
+ * @param {AnyWebhookNotification} notification - Notification to check
+ * @returns {boolean} `true` if payment notification
+ *
+ * @example
+ * if (isPaymentNotification(notification)) {
+ *   // TypeScript knows this is PaymentNotification
+ *   const { orderStatus, acquiringOrderId } = notification.result;
+ *   console.log(`Order ${acquiringOrderId}: ${orderStatus}`);
+ * }
+ *
+ * @see {@link PaymentNotification} for the notification structure
+ */
+declare function isPaymentNotification(notification: AnyWebhookNotification): notification is PaymentNotification;
+/**
+ * Type guard: checks if notification is a refund notification.
+ *
+ * Refund notifications are sent when a refund order status changes.
+ * When this returns `true`, TypeScript narrows the type to {@link RefundNotification}.
+ *
+ * @param {AnyWebhookNotification} notification - Notification to check
+ * @returns {boolean} `true` if refund notification
+ *
+ * @example
+ * if (isRefundNotification(notification)) {
+ *   // TypeScript knows this is RefundNotification
+ *   const { refundStatus, refundAmount } = notification.result;
+ *   console.log(`Refund status: ${refundStatus}, amount: ${refundAmount}`);
+ * }
+ *
+ * @see {@link RefundNotification} for the notification structure
+ */
+declare function isRefundNotification(notification: AnyWebhookNotification): notification is RefundNotification;
+/**
+ * Type guard: checks if notification is a subscription status notification.
+ *
+ * Subscription status notifications are sent when subscription status changes
+ * (ACTIVE, MERCHANT_CANCELLED, CHANNEL_CANCELLED, EXPIRED).
+ * When this returns `true`, TypeScript narrows the type to {@link SubscriptionStatusNotification}.
+ *
+ * @param {AnyWebhookNotification} notification - Notification to check
+ * @returns {boolean} `true` if subscription status notification
+ *
+ * @example
+ * if (isSubscriptionStatusNotification(notification)) {
+ *   // TypeScript knows this is SubscriptionStatusNotification
+ *   const { subscriptionStatus, subscriptionId } = notification.result;
+ *   console.log(`Subscription ${subscriptionId}: ${subscriptionStatus}`);
+ * }
+ *
+ * @see {@link SubscriptionStatusNotification} for the notification structure
+ */
+declare function isSubscriptionStatusNotification(notification: AnyWebhookNotification): notification is SubscriptionStatusNotification;
+/**
+ * Type guard: checks if notification is a subscription payment notification.
+ *
+ * Subscription payment notifications are sent when a recurring payment is processed.
+ * **Note:** Uses the same `PAYMENT_NOTIFICATION` event type as regular payments,
+ * but includes `subscriptionId` in the result to distinguish them.
+ *
+ * When this returns `true`, TypeScript narrows the type to {@link SubscriptionPaymentNotification}.
+ *
+ * @param {AnyWebhookNotification} notification - Notification to check
+ * @returns {boolean} `true` if subscription payment notification
+ *
+ * @example
+ * if (isSubscriptionPaymentNotification(notification)) {
+ *   // TypeScript knows this is SubscriptionPaymentNotification
+ *   const { orderStatus, subscriptionInfo } = notification.result;
+ *   console.log(`Period ${subscriptionInfo.period}: ${orderStatus}`);
+ * }
+ *
+ * @see {@link SubscriptionPaymentNotification} for the notification structure
+ * @see {@link isPaymentNotification} for regular payment notifications
+ */
+declare function isSubscriptionPaymentNotification(notification: AnyWebhookNotification): notification is SubscriptionPaymentNotification;
+
+export { type AddressInfo, type AddressInfoResponse, type AnyWebhookNotification, type ApiResponse, type CancelOrderData, type CancelOrderParams, type CancelSubscriptionData, type CancelSubscriptionParams, CaptureMode, type CaptureOrderData, type CaptureOrderParams, type CardInfo, type CashierAppearance, CashierLanguage, CountryCode, type CreateOrderData, type CreateOrderParams, type CreateRefundData, type CreateSubscriptionData, type CreateSubscriptionParams, CurrencyCode, Environment, EnvironmentPublicKeys, EnvironmentUrls, type FixedMaintenanceRule, type GoodsInfo, type GoodsInfoResponse, HttpClient, HttpStatusCode, type InquiryOrderData, type InquiryOrderParams, type InquiryRefundData, type InquirySubscriptionData, type InquirySubscriptionParams, type KeyPair, type ManageSubscriptionData, type ManageSubscriptionParams, type MerchantConfigInquiryData, type MerchantConfigInquiryParams, type MerchantInfo, type MerchantInfoResponse, MerchantInitiatedMode, type OrderAction, type OrderActionData, OrderActionType, type OrderFailedReason, OrderStatus, type PayMethodConfigInquiryData, type PayMethodConfigInquiryParams, type PayMethodDetail, type PayMethodProperties, type PayMethodResponse, PayMethodUserAccountType, type PaymentDetail, type PaymentInfo, type PaymentInfoResponse, type PaymentNotification, type PaymentNotificationHandler, type PaymentNotificationResult, type PaymentWebhookRequest, PeriodType, type ProductInfo, type ProductInfoResponse, ProductName, type RefundFailedReason, type RefundInquiryParams, type RefundNotification, type RefundNotificationHandler, type RefundNotificationResult, type RefundOrderParams, RefundStatus, type RefundUserBankInfo, type RefundUserInfo, type RefundUserInfoResponse, type RefundWebhookRequest, type RequestOptions, type RiskData, type SubscriptionAction, type SubscriptionAddressInfo, SubscriptionEventType, type SubscriptionFailedReason, type SubscriptionGoodsInfo, type SubscriptionInfo, type SubscriptionMerchantInfo, type SubscriptionNotification, SubscriptionOrderStatus, type SubscriptionPayMethodResponse, SubscriptionPayMethodUserAccountType, type SubscriptionPaymentInfo, type SubscriptionPaymentInfoResponse, type SubscriptionPaymentNotification, type SubscriptionPaymentNotificationHandler, type SubscriptionPaymentNotificationResult, type SubscriptionPaymentWebhookRequest, SubscriptionProductName, type SubscriptionRiskData, SubscriptionStatus, type SubscriptionStatusNotification, type SubscriptionStatusNotificationHandler, type SubscriptionStatusNotificationResult, type SubscriptionStatusWebhookRequest, type SubscriptionUserInfo, SubscriptionUserTerminalType, type SubscriptionWebhookRequest, ThreeDsDecision, type UserBankInfo, type UserInfo, type UserInfoResponse, UserTerminalType, Waffo, type WaffoApiResponse, type WaffoConfig, type WaffoResponseBody, type WaffoResponseHeader, type WebhookErrorHandler, WebhookEventType, WebhookHandler, type WebhookHandlerContext, type WebhookHandlerOptions, type WebhookHandlerResult, type WebhookRequestHeader, type WebhookResponse, type WebhookResponseBody, type WebhookResponseHeader, WebhookResponseStatus, type WebhookVerificationResult, buildFailedResponse, buildSuccessResponse, buildWebhookResponse, createKeyPair, getWebhookEventType, isPaymentNotification, isRefundNotification, isSubscriptionPaymentNotification, isSubscriptionStatusNotification, signForRSA, verify, verifyWebhookSignature };