@waffo/waffo-node 2.3.1 → 2.3.3

package/dist/index.d.mts

@@ -735,7 +735,8 @@ declare enum WebhookEventType {
     PAYMENT_NOTIFICATION = "PAYMENT_NOTIFICATION",
     REFUND_NOTIFICATION = "REFUND_NOTIFICATION",
     SUBSCRIPTION_STATUS_NOTIFICATION = "SUBSCRIPTION_STATUS_NOTIFICATION",
-    SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION"
+    SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION",
+    SUBSCRIPTION_CHANGE_NOTIFICATION = "SUBSCRIPTION_CHANGE_NOTIFICATION"
 }
 /**
  * Result of webhook handling.
@@ -853,6 +854,33 @@ interface SubscriptionNotificationResult {
     paymentDetails?: Record<string, unknown>[];
     [key: string]: unknown;
 }
+/**
+ * Subscription change notification result payload.
+ * Triggered when a subscription change (upgrade/downgrade) reaches final status (SUCCESS or CLOSED).
+ */
+interface SubscriptionChangeNotificationResult {
+    subscriptionRequest?: string;
+    originSubscriptionRequest?: string;
+    merchantSubscriptionId?: string;
+    subscriptionId?: string;
+    /** Final status: SUCCESS or CLOSED */
+    subscriptionChangeStatus?: string;
+    subscriptionAction?: string;
+    remainingAmount?: string;
+    currency?: string;
+    userCurrency?: string;
+    requestedAt?: string;
+    subscriptionManagementUrl?: string;
+    extendInfo?: string;
+    orderExpiredAt?: string;
+    productInfoList?: Record<string, unknown>[];
+    merchantInfo?: Record<string, unknown>;
+    userInfo?: Record<string, unknown>;
+    goodsInfo?: Record<string, unknown>;
+    addressInfo?: Record<string, unknown>;
+    paymentInfo?: Record<string, unknown>;
+    [key: string]: unknown;
+}
 /**
  * Payment notification from Waffo.
  */
@@ -885,11 +913,20 @@ interface SubscriptionPeriodChangedNotification extends BaseNotification {
     result?: SubscriptionNotificationResult;
     [key: string]: unknown;
 }
+/**
+ * Subscription change notification from Waffo.
+ */
+interface SubscriptionChangeNotification extends BaseNotification {
+    eventType: 'SUBSCRIPTION_CHANGE_NOTIFICATION';
+    result?: SubscriptionChangeNotificationResult;
+    [key: string]: unknown;
+}
 type PaymentHandler = (notification: PaymentNotification) => void | Promise<void>;
 type RefundHandler = (notification: RefundNotification) => void | Promise<void>;
 type SubscriptionStatusHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
 type SubscriptionPaymentHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
 type SubscriptionPeriodChangedHandler = (notification: SubscriptionPeriodChangedNotification) => void | Promise<void>;
+type SubscriptionChangeHandler = (notification: SubscriptionChangeNotification) => void | Promise<void>;
 /**
  * Webhook handler for processing Waffo webhook notifications.
  *
@@ -924,6 +961,7 @@ declare class WebhookHandler {
     private subscriptionStatusHandler?;
     private subscriptionPaymentHandler?;
     private subscriptionPeriodChangedHandler?;
+    private subscriptionChangeHandler?;
     constructor(config: WaffoConfig);
     /**
      * Registers a handler for payment notifications.
@@ -946,6 +984,10 @@ declare class WebhookHandler {
      * Registers a handler for subscription period changed notifications.
      */
     onSubscriptionPeriodChanged(handler: SubscriptionPeriodChangedHandler): this;
+    /**
+     * Registers a handler for subscription change notifications.
+     */
+    onSubscriptionChange(handler: SubscriptionChangeHandler): this;
     /**
      * Processes a webhook notification.
      *
@@ -1215,14 +1257,13 @@ interface CancelOrderData {
  */
 interface RefundOrderParams {
     refundRequestId: string;
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
+    acquiringOrderId: string;
+    merchantId?: string;
     merchantRefundOrderId?: string;
-    merchantInfo?: MerchantInfo;
     refundAmount: string;
-    refundReason?: string;
-    requestedAt?: string;
-    notifyUrl?: string;
+    refundReason: string;
+    requestedAt: string;
+    refundNotifyUrl?: string;
     userInfo?: RefundUserInfo;
     extendInfo?: string;
     [key: string]: unknown;
@@ -1363,9 +1404,25 @@ interface RiskData {
 interface RefundUserInfo {
     userType?: string;
     userFirstName?: string;
+    userMiddleName?: string;
     userLastName?: string;
+    nationality?: string;
     userEmail?: string;
     userPhone?: string;
+    userBirthDay?: string;
+    userIDType?: string;
+    userIDNumber?: string;
+    userIDIssueDate?: string;
+    userIDExpiryDate?: string;
+    userBankInfo?: RefundUserBankInfo;
+    [key: string]: unknown;
+}
+interface RefundUserBankInfo {
+    bankAccountNo?: string;
+    bankCode?: string;
+    bankName?: string;
+    bankCity?: string;
+    bankBranch?: string;
     [key: string]: unknown;
 }
 

package/dist/index.d.ts

@@ -735,7 +735,8 @@ declare enum WebhookEventType {
     PAYMENT_NOTIFICATION = "PAYMENT_NOTIFICATION",
     REFUND_NOTIFICATION = "REFUND_NOTIFICATION",
     SUBSCRIPTION_STATUS_NOTIFICATION = "SUBSCRIPTION_STATUS_NOTIFICATION",
-    SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION"
+    SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION",
+    SUBSCRIPTION_CHANGE_NOTIFICATION = "SUBSCRIPTION_CHANGE_NOTIFICATION"
 }
 /**
  * Result of webhook handling.
@@ -853,6 +854,33 @@ interface SubscriptionNotificationResult {
     paymentDetails?: Record<string, unknown>[];
     [key: string]: unknown;
 }
+/**
+ * Subscription change notification result payload.
+ * Triggered when a subscription change (upgrade/downgrade) reaches final status (SUCCESS or CLOSED).
+ */
+interface SubscriptionChangeNotificationResult {
+    subscriptionRequest?: string;
+    originSubscriptionRequest?: string;
+    merchantSubscriptionId?: string;
+    subscriptionId?: string;
+    /** Final status: SUCCESS or CLOSED */
+    subscriptionChangeStatus?: string;
+    subscriptionAction?: string;
+    remainingAmount?: string;
+    currency?: string;
+    userCurrency?: string;
+    requestedAt?: string;
+    subscriptionManagementUrl?: string;
+    extendInfo?: string;
+    orderExpiredAt?: string;
+    productInfoList?: Record<string, unknown>[];
+    merchantInfo?: Record<string, unknown>;
+    userInfo?: Record<string, unknown>;
+    goodsInfo?: Record<string, unknown>;
+    addressInfo?: Record<string, unknown>;
+    paymentInfo?: Record<string, unknown>;
+    [key: string]: unknown;
+}
 /**
  * Payment notification from Waffo.
  */
@@ -885,11 +913,20 @@ interface SubscriptionPeriodChangedNotification extends BaseNotification {
     result?: SubscriptionNotificationResult;
     [key: string]: unknown;
 }
+/**
+ * Subscription change notification from Waffo.
+ */
+interface SubscriptionChangeNotification extends BaseNotification {
+    eventType: 'SUBSCRIPTION_CHANGE_NOTIFICATION';
+    result?: SubscriptionChangeNotificationResult;
+    [key: string]: unknown;
+}
 type PaymentHandler = (notification: PaymentNotification) => void | Promise<void>;
 type RefundHandler = (notification: RefundNotification) => void | Promise<void>;
 type SubscriptionStatusHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
 type SubscriptionPaymentHandler = (notification: SubscriptionStatusNotification) => void | Promise<void>;
 type SubscriptionPeriodChangedHandler = (notification: SubscriptionPeriodChangedNotification) => void | Promise<void>;
+type SubscriptionChangeHandler = (notification: SubscriptionChangeNotification) => void | Promise<void>;
 /**
  * Webhook handler for processing Waffo webhook notifications.
  *
@@ -924,6 +961,7 @@ declare class WebhookHandler {
     private subscriptionStatusHandler?;
     private subscriptionPaymentHandler?;
     private subscriptionPeriodChangedHandler?;
+    private subscriptionChangeHandler?;
     constructor(config: WaffoConfig);
     /**
      * Registers a handler for payment notifications.
@@ -946,6 +984,10 @@ declare class WebhookHandler {
      * Registers a handler for subscription period changed notifications.
      */
     onSubscriptionPeriodChanged(handler: SubscriptionPeriodChangedHandler): this;
+    /**
+     * Registers a handler for subscription change notifications.
+     */
+    onSubscriptionChange(handler: SubscriptionChangeHandler): this;
     /**
      * Processes a webhook notification.
      *
@@ -1215,14 +1257,13 @@ interface CancelOrderData {
  */
 interface RefundOrderParams {
     refundRequestId: string;
-    paymentRequestId?: string;
-    acquiringOrderId?: string;
+    acquiringOrderId: string;
+    merchantId?: string;
     merchantRefundOrderId?: string;
-    merchantInfo?: MerchantInfo;
     refundAmount: string;
-    refundReason?: string;
-    requestedAt?: string;
-    notifyUrl?: string;
+    refundReason: string;
+    requestedAt: string;
+    refundNotifyUrl?: string;
     userInfo?: RefundUserInfo;
     extendInfo?: string;
     [key: string]: unknown;
@@ -1363,9 +1404,25 @@ interface RiskData {
 interface RefundUserInfo {
     userType?: string;
     userFirstName?: string;
+    userMiddleName?: string;
     userLastName?: string;
+    nationality?: string;
     userEmail?: string;
     userPhone?: string;
+    userBirthDay?: string;
+    userIDType?: string;
+    userIDNumber?: string;
+    userIDIssueDate?: string;
+    userIDExpiryDate?: string;
+    userBankInfo?: RefundUserBankInfo;
+    [key: string]: unknown;
+}
+interface RefundUserBankInfo {
+    bankAccountNo?: string;
+    bankCode?: string;
+    bankName?: string;
+    bankCity?: string;
+    bankBranch?: string;
     [key: string]: unknown;
 }
 

package/dist/index.js

@@ -463,7 +463,7 @@ var HEADER_SDK_VERSION = "x-sdk-version";
 var HEADER_CONTENT_TYPE = "content-type";
 var CONTENT_TYPE_JSON = "application/json";
 var API_VERSION = "1.0.0";
-var SDK_VERSION = "waffo-node/2.3.1";
+var SDK_VERSION = "waffo-node/2.3.3";
 var WaffoHttpClient = class {
   baseUrl;
   apiKey;
@@ -600,13 +600,12 @@ var WaffoHttpClient = class {
       if (!info.merchantId) {
         info.merchantId = this.merchantId;
       }
-    } else if ("merchantId" in req) {
-      if (!req.merchantId) {
-        req.merchantId = this.merchantId;
-      }
     } else {
       req.merchantInfo = { merchantId: this.merchantId };
     }
+    if (!req.merchantId) {
+      req.merchantId = this.merchantId;
+    }
   }
   /**
    * Checks if the error is a network-related error.
@@ -624,6 +623,7 @@ var WebhookEventType = /* @__PURE__ */ ((WebhookEventType2) => {
   WebhookEventType2["REFUND_NOTIFICATION"] = "REFUND_NOTIFICATION";
   WebhookEventType2["SUBSCRIPTION_STATUS_NOTIFICATION"] = "SUBSCRIPTION_STATUS_NOTIFICATION";
   WebhookEventType2["SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION"] = "SUBSCRIPTION_PERIOD_CHANGED_NOTIFICATION";
+  WebhookEventType2["SUBSCRIPTION_CHANGE_NOTIFICATION"] = "SUBSCRIPTION_CHANGE_NOTIFICATION";
   return WebhookEventType2;
 })(WebhookEventType || {});
 var WebhookHandler = class {
@@ -635,6 +635,7 @@ var WebhookHandler = class {
   subscriptionStatusHandler;
   subscriptionPaymentHandler;
   subscriptionPeriodChangedHandler;
+  subscriptionChangeHandler;
   constructor(config) {
     this.waffoPublicKey = config.waffoPublicKey;
     this.privateKey = config.privateKey;
@@ -676,6 +677,13 @@ var WebhookHandler = class {
     this.subscriptionPeriodChangedHandler = handler;
     return this;
   }
+  /**
+   * Registers a handler for subscription change notifications.
+   */
+  onSubscriptionChange(handler) {
+    this.subscriptionChangeHandler = handler;
+    return this;
+  }
   /**
    * Processes a webhook notification.
    *
@@ -719,6 +727,11 @@ var WebhookHandler = class {
             await this.subscriptionPeriodChangedHandler(parsed);
           }
           break;
+        case "SUBSCRIPTION_CHANGE_NOTIFICATION" /* SUBSCRIPTION_CHANGE_NOTIFICATION */:
+          if (this.subscriptionChangeHandler) {
+            await this.subscriptionChangeHandler(parsed);
+          }
+          break;
         default:
           this.logger?.warn(`Unknown webhook event type: ${eventType}`);
           return this.createFailedResult(`Unknown event type: ${eventType}`);