gotrip-fx-transaction-form 1.0.202-dev → 1.0.202

package/types/types/enum.d.ts

@@ -7,7 +7,7 @@ export declare enum TransactionStatus {
     SENT_TO_BANK = "sent_to_bank",
     SENT_CONFIRMATION = "sent_confirmation_to_customer",
     CONFIRMED = "confirmed",// customer confirmed transaction request via zns
-    CUSTOMER_PURCHASE_CONFIRMATION = "customer_purchase_confirmation",// waiting for customer to confirm via ZNS (ABBANK only)
+    CUSTOMER_PURCHASE_CONFIRMATION = "customer_purchase_confirmation",// waiting for customer to confirm via ZNS (ABBANK, VPBANK)
     CANCELED = "cancelled",
     SUCCESS = "success",
     PAID = "paid",
@@ -16,6 +16,8 @@ export declare enum TransactionStatus {
 }
 export declare enum EsimTransactionStatus {
     CREATED = "created",
+    PENDING_PAYMENT = "pending_payment",
+    PAID = "paid",
     WAITING_FOR_RETURN = "waiting_for_return",
     RETURNED = "returned",
     OUT_OF_STOCK = "out_of_stock",
@@ -93,7 +95,18 @@ export declare const E_TOP_UP_VALUES: {
 export declare enum EPaymentMethod {
     PRIMARY_BALANCE = "primary_balance",
     TOPUP_BALANCE = "topup_balance",
-    BANK_TRANSFER = "bank_transfer"
+    BANK_TRANSFER = "bank_transfer",
+    ADMIN_PAYMENT = "admin_payment"
+}
+/** Wallet vs bank QR; matches API `EPaymentMode` (eSIM create / list). */
+export declare enum EPaymentMode {
+    TOPUP_BALANCE = "topup_balance",
+    BANK_TRANSFER = "bank_transfer",
+    ADMIN_PAYMENT = "admin_payment"
+}
+export declare enum EOrderPaymentType {
+    UP_FRONT = "up_front",
+    DEFERRED = "deferred"
 }
 export declare enum EInsuranceTransactionStatus {
     PENDING = "pending",

package/types/types/insurance-transaction.dto.d.ts

@@ -1,4 +1,5 @@
-import { EGender, EIdType, EInsuranceType, EPersonType, EPolicyStatus, EPolicyType, EQuoteStatus, ERelationToPrimary, ETravelType } from './insurance';
+import { EGender, EIdType, EInsuranceType, EApprovalStatus, EPersonType, EPolicyStatus, EPolicyType, EQuoteStatus, ERelationToPrimary, ETravelScope, ETravelType } from './insurance';
+import { EOrderPaymentType } from './enum';
 import { ITransaction } from './response.dto';
 export interface InsuranceQuoteInsured {
     id: number;
@@ -36,6 +37,8 @@ export interface InsuranceQuote {
     travelType: ETravelType;
     destination?: string;
     destinationId?: number;
+    provinceFromId?: number;
+    provinceToId?: number;
     basePremium: number;
     taxAmount: number;
     totalPremium: number;
@@ -84,8 +87,13 @@ export interface InsuranceTransaction {
     type: EInsuranceType;
     policyType: EPolicyType;
     travelType: ETravelType;
+    travelScope: ETravelScope;
     status: EPolicyStatus;
     totalAmount: number;
+    premiumBeforeDiscount?: number;
+    couponId?: number;
+    couponCode?: string;
+    couponDiscountAmount?: number;
     providerPolicyId?: string;
     providerPolicyNumber?: string;
     providerData?: Record<string, any>;
@@ -94,8 +102,21 @@ export interface InsuranceTransaction {
     documents?: InsurancePolicyDocument[];
     userId?: number;
     tenantId?: number;
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
+    approvalStatus?: EApprovalStatus | null;
+    approvalBypassed?: boolean;
+    createdByAdminId?: number | null;
+    updatedByAdminId?: number | null;
+    approvedAt?: string | null;
+    rejectedAt?: string | null;
+    rejectionReasonCode?: string | null;
+    rejectionReasonText?: string | null;
     createdAt: string;
     updatedAt: string;
     quote?: InsuranceQuote;
     policyInsureds?: PolicyInsured[];
+    utm?: Record<string, string>;
 }

package/types/types/insurance.d.ts

@@ -2,6 +2,10 @@ export declare enum ETravelType {
     SINGLE = "single",
     ANNUAL = "annual"
 }
+export declare enum ETravelScope {
+    INTERNATIONAL = "international",
+    DOMESTIC = "domestic"
+}
 export declare enum ERelationToPrimary {
     SELF = "self",
     SPOUSE = "spouse",
@@ -20,13 +24,16 @@ export declare enum ERelationToPrimary {
 }
 export declare enum EIdType {
     PASSPORT = "passport",
-    ID_CARD = "id_card"
+    ID_CARD = "id_card",
+    TAX_CODE = "tax_code"
 }
 export declare enum EInsuranceProviderType {
     TMIV = "TMIV",
     MSIG = "MSIG",
-    PVI = "PVI"
+    PVI = "PVI",
+    MIC = "MIC"
 }
+export declare const INSURANCE_PROVIDER_LABELS: Record<EInsuranceProviderType, string>;
 export declare enum EInsuranceType {
     INDIVIDUAL = "individual",
     FAMILY = "family",
@@ -55,6 +62,11 @@ export declare enum EPolicyStatus {
     PENDING = "pending",
     FAILED = "failed"
 }
+export declare enum EApprovalStatus {
+    PENDING_APPROVAL = "pending_approval",
+    APPROVED = "approved",
+    REJECTED = "rejected"
+}
 export declare enum EDestination {
     WORLDWIDE = "worldwide",
     ASIA = "asia",
@@ -62,6 +74,7 @@ export declare enum EDestination {
 }
 export declare enum EPersonType {
     ADULT = "adult",
+    TEENAGER = "teenager",
     CHILDREN = "children"
 }
 export declare enum EPersonValidationStatus {
@@ -69,3 +82,7 @@ export declare enum EPersonValidationStatus {
     NEEDS_CHECK = "needs_check",
     NOT_ENTERED = "not_entered"
 }
+export declare enum EBuyerType {
+    INDIVIDUAL = "individual",
+    COMPANY = "company"
+}

package/types/types/notification.d.ts

@@ -0,0 +1,23 @@
+export declare enum ENotificationType {
+    INSURANCE_PENDING_APPROVAL = "insurance_pending_approval",
+    INSURANCE_APPROVED = "insurance_approved",
+    INSURANCE_REJECTED = "insurance_rejected",
+    INSURANCE_UPDATED = "insurance_updated",
+    MOTOR_INSURANCE_PENDING_APPROVAL = "motor_insurance_pending_approval",
+    MOTOR_INSURANCE_APPROVED = "motor_insurance_approved",
+    MOTOR_INSURANCE_REJECTED = "motor_insurance_rejected",
+    MOTOR_INSURANCE_UPDATED = "motor_insurance_updated"
+}
+export interface INotification {
+    id: number;
+    type: ENotificationType;
+    title: string;
+    message: string;
+    isRead: boolean;
+    readAt: string | null;
+    metadata: {
+        path?: string;
+        publicId?: string;
+    } | null;
+    createdAt: string;
+}

package/types/types/response.dto.d.ts

@@ -1,4 +1,4 @@
-import { ECommissionPolicyType, ESimDomesticServices, EsimTransactionStatus, ETenantType, EUseCaseses, TransactionStatus } from './enum';
+import { ECommissionPolicyType, EPaymentMode, EOrderPaymentType, ESimDomesticServices, EsimTransactionStatus, ETenantType, EUseCaseses, TransactionStatus } from './enum';
 import { EPolicyActionType } from '../constants/policy-enums';
 import { EPermissionKey, EUserRole, EUserStatus } from './user';
 export type LoginRespDto = {
@@ -106,6 +106,20 @@ export type ITransaction = {
     fileUrls?: IFileUrls;
     cancelledAt?: string;
     cancelledResponse?: Record<string, any>;
+    cancelledBy?: string;
+    cancelledUser?: {
+        id: number;
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+    };
+    approvedBy?: string;
+    approvedUser?: {
+        id: number;
+        email?: string;
+        firstName?: string;
+        lastName?: string;
+    };
     assignedUserId?: number;
     assignedUser?: {
         id: number;
@@ -118,6 +132,10 @@ export type IESimTransaction = {
     id: number;
     esimTransactionId: number;
     vndAmount?: number;
+    paymentAmount?: number;
+    couponId?: number;
+    couponCode?: string;
+    couponDiscountAmount?: number;
     originalVndAmount?: number;
     amount?: number;
     packageId?: number;
@@ -126,6 +144,11 @@ export type IESimTransaction = {
     agencyOrderId?: number;
     orderCode?: string;
     status: EsimTransactionStatus;
+    paymentMode?: EPaymentMode;
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
     lastSyncedAt?: Date;
     publicId: string;
     createdResponseLog?: Record<string, any>;
@@ -227,6 +250,7 @@ export interface ITravelAgencyTenantSettings {
         esimInbound: boolean;
         simDomestic: boolean;
         insurance: boolean;
+        motorInsurance: boolean;
     };
     fx: {
         useCases: EUseCaseses[];
@@ -239,6 +263,10 @@ export interface ITravelAgencyTenantSettings {
     insurance: {
         providers: string[];
     };
+    motorInsurance: {
+        providers: string[];
+    };
+    paymentType?: EOrderPaymentType;
 }
 export interface IBankTenantSettings {
     availableCurrencies: string[];
@@ -267,6 +295,25 @@ export type GetESimTransactionListRespDto = {
     page: number;
     limit: number;
 };
+export type BankTransferInfo = {
+    bankAccount: string;
+    accountName: string;
+    amount: number;
+    transferContent: string;
+    bankCode: string;
+};
+export type CreateEsimTransactionBankTransferResponse = {
+    qrCodeUrl: string;
+    transactionPublicId: string;
+    totalAmount: number;
+    bankTransferInfo?: BankTransferInfo;
+};
+export type DebtPaymentQrResponse = {
+    qrCodeUrl: string;
+    transactionPublicId: string;
+    totalAmount: number;
+    bankTransferInfo?: BankTransferInfo;
+};
 export type GetUserListRespDto = {
     users: IUser[];
     total: number;
@@ -352,6 +399,7 @@ export type IUser = {
     departments?: IDepartment[];
     roles?: IRole[];
     tenant?: ITenant;
+    tenantId?: number;
     permissions?: EPermissionKey[];
     balance?: {
         amount: number;
@@ -511,7 +559,9 @@ export declare enum EDebtReportStatus {
 }
 export declare enum ETransactionReportType {
     FX = "fx",
-    ESIM = "esim"
+    ESIM = "esim",
+    INSURANCE = "insurance",
+    MOTOR_INSURANCE = "motor_insurance"
 }
 export declare enum ESimType {
     ESIM = "esim",
@@ -529,10 +579,13 @@ export type IDebtReportTransaction = {
     customerEmail?: string;
     amount: number;
     amountVnd: number;
-    currency: string;
-    bankName: string;
-    publicId: string;
+    currency?: string;
+    bankName?: string;
+    publicId?: string;
     bankTransactionId?: string;
+    insuranceProvider?: string;
+    insuranceType?: string;
+    policyId?: string;
     createdAt: string;
     commissionAmount: number;
 };
@@ -544,6 +597,7 @@ export type IDebtReport = {
     endDate: string;
     transactionType: ETransactionReportType;
     totalCommissionVnd: number;
+    totalAmountVnd: number;
     totalCommissionByBank: Record<string, number>;
     numSuccessfulTransactions: number;
     status: EDebtReportStatus;

package/types/types/sdk.d.ts

@@ -1,4 +1,11 @@
 export declare enum ESdkFormType {
     FX = "fx",
-    INSURANCE = "insurance"
+    INTERNATIONAL_INSURANCE = "international_insurance",
+    DOMESTIC_INSURANCE = "domestic_insurance",
+    MOTOR_INSURANCE_CAR = "motor_insurance_car",
+    MOTOR_INSURANCE_BIKE = "motor_insurance_bike",
+    EXCHANGE_RATE_TABLE = "exchange_rate_table",
+    INSURANCE_APPROVAL = "insurance_approval",
+    MOTOR_INSURANCE_CAR_APPROVAL = "motor_insurance_car_approval",
+    MOTOR_INSURANCE_BIKE_APPROVAL = "motor_insurance_bike_approval"
 }

package/types/types/tracking.dto.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Tracking DTO interface for tracking user behavior
+ * This interface can be extended with additional tracking fields in the future
+ */
+export interface TrackingDto {
+    /** Anonymous user ID for tracking unauthenticated users */
+    anonymousId?: string;
+    /** Google Click ID for tracking Google Ads campaigns */
+    gclid?: string;
+    /** Facebook Click ID for tracking Facebook Ads campaigns */
+    fbid?: string;
+    /** Campaign identifier */
+    campaign?: string;
+    /** UTM and ad network parameters (utm_source, utm_campaign, gclid, fbclid, ttclid, etc.) */
+    utm?: Record<string, string>;
+}
+/**
+ * Type helper to extend any DTO with tracking fields
+ * Usage: type MyDtoWithTracking = WithTracking<MyDto>
+ */
+export type WithTracking<T> = T & TrackingDto;

package/types/util/booker-display.d.ts

@@ -0,0 +1,6 @@
+import { IUser } from '../types/response.dto';
+export declare function formatBookerHeadingWithEmail(user: IUser): string;
+export declare function getBookerSelectionButtonLabel(selectedUser: IUser | null): string;
+export declare function getSelectedUserDisplay(selectedUser: IUser | null): string;
+/** Clickable hint when admin must pick / re-pick booker */
+export declare const BOOKER_SELECT_GUIDE_VI = "ch\u01B0a ch\u1ECDn ng\u01B0\u1EDDi d\u00F9ng";

package/types/util/couponErrorMessages.d.ts

@@ -0,0 +1,2 @@
+export declare function getBusinessMessageFromCode(code: string | undefined | null): string;
+export declare function getCouponErrorCodeFromAxios(err: unknown): string | undefined;

package/types/util/debt-report-display.d.ts

@@ -0,0 +1,4 @@
+import { ETransactionReportType } from '../types/response.dto';
+export declare const getDebtReportTransactionTypeText: (type: ETransactionReportType) => string;
+export declare const isFxDebtReportType: (type: ETransactionReportType) => boolean;
+export declare const getDebtReportInsuranceTypeText: (insuranceType?: string | null) => string;

package/types/util/formatter.d.ts

@@ -2,3 +2,9 @@ export declare const formatter: Intl.NumberFormat;
 export declare const formatCurrencyWithoutVND: (value: number | string) => string;
 export declare const formatCurrency: (value: number | string) => string;
 export declare const upperFirstLetter: (str: string) => string;
+/**
+ * Parse a locale-formatted number string (e.g. "100,000") to a number for filter/API use.
+ * Returns undefined for empty input or invalid numbers.
+ */
+export declare const parseFilterNumber: (s: string) => number | undefined;
+export declare const formatDate: (date: string | Date | null | undefined, format?: string) => string;

package/types/util/fx-travelling-messages.d.ts

@@ -0,0 +1 @@
+export declare function normalizeSelectingBankMessages(config: string | string[] | null | undefined, fallback: string | null): string[];

package/types/util/fx.d.ts

@@ -0,0 +1,15 @@
+import { IBankFxTravellingSetting } from '../types/app-settings';
+/**
+ * Returns the effective max amount for the given currency and destination country.
+ * If max_amount_by_country is set: visa countries use visa_max_amount, else non_visa_max_amount.
+ * Falls back to max_amount when max_amount_by_country is not configured or has no value for the currency.
+ *
+ * CMS config (use alpha2 codes in visa_countries; form sends alpha2):
+ *   "max_amount_by_country": {
+ *     "visa_countries": ["US", "GB", "FR", "CN", "JP", "KR"],
+ *     "visa_max_amount": 10000,
+ *     "non_visa_max_amount": 2000
+ *   }
+ * Or per-currency: "visa_max_amount": { "USD": 10000, "EUR": 8000 }
+ */
+export declare function getEffectiveConfiguredMaxAmount(travellingConfig: IBankFxTravellingSetting | undefined, currencyKey: string, countryCodeDes: string | undefined): number | null | undefined;

package/types/util/order-payment-display.d.ts

@@ -0,0 +1,16 @@
+import { EOrderPaymentType } from '../types/enum';
+import { EApprovalStatus } from '../types/insurance';
+export declare function getPaymentTypeLabel(paymentType?: EOrderPaymentType | string): string;
+export declare function getApprovalStatusLabel(approvalBypassed?: boolean, approvalStatus?: EApprovalStatus | string | null): string;
+export declare function getOrderPaymentStatusShortLabel(params: {
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
+}): string;
+export declare function getOrderPaymentStatusDetailLabel(params: {
+    paymentTypeApplied?: EOrderPaymentType;
+    paidAmount?: number;
+    unpaidAmount?: number;
+    isBypassed?: boolean;
+}): string;

package/types/util/sim-display.d.ts

@@ -1,7 +1,9 @@
 import { EOrderType } from '../hooks/useSimTransactionGrouped';
+import { EPaymentMode } from '../types/enum';
 export declare const getSimTypeDisplay: (simType?: string) => string;
 export declare const getSimPaymentTypeDisplay: (paymentType?: string) => string;
 export declare const getSimTransactionTypeDisplay: (type?: EOrderType) => string;
+export declare const getEsimPaymentModeDisplay: (mode?: EPaymentMode | string) => string;
 export declare const getSimProviderDisplay: (provider?: string) => string;
 export declare const getSimStatusDisplay: (status?: string) => {
     text: string;

package/types/util/tracking.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Generate a new anonymous user ID (15 chars, url-safe).
+ * @see https://alex7kom.github.io/nano-nanoid-cc/
+ */
+export declare const generateAnonymousUid: (size?: number) => string;
+/**
+ * Save anonymous UID to both cookie and localStorage
+ * This ensures persistence across different storage mechanisms
+ */
+export declare const saveAnonymousUid: (uid: string) => void;
+/**
+ * Get anonymous UID with priority: cookie first, then localStorage
+ * If not found, generates a new one and saves it
+ */
+export declare const getAnonymousUid: () => string;
+/**
+ * Validate tracking data
+ */
+export declare const validateTrackingData: (data: any) => boolean;

package/types/util/transaction.util.d.ts

@@ -1,4 +1,5 @@
 import { ESimPackageDataLimitTimeframe, ESimPackageDataLimitUnit, ESimPackageValidityType, ETransactionType } from '../types/response.dto';
-export declare const getTransactionType: (type: ETransactionType) => ETransactionType.STUDY | "Du học" | "Du lịch" | "Du lịch (Nhóm)" | "Kinh doanh" | "Di trú";
+export declare const getTransactionStatusLabel: (status?: string) => string;
+export declare const getTransactionType: (type: ETransactionType) => ETransactionType.STUDY | "Du học" | "Kinh doanh" | "Du lịch" | "Du lịch (Nhóm)" | "Di trú";
 export declare const formatDataLimit: (dataLimit: number, dataLimitUnit: ESimPackageDataLimitUnit, dataLimitTimeframe: ESimPackageDataLimitTimeframe) => string;
 export declare const formatValidity: (validityPeriod: number, validityType: ESimPackageValidityType) => string;

package/types/utils/bank.d.ts

@@ -0,0 +1,4 @@
+import { BANK_CODES, BANKS_WITH_DEPARTMENT_AND_ZNS_FLOW } from '../constants/tenant';
+export declare const getBankLogoUrl: (bankCodeOrShortName?: string | null) => string | null;
+export declare const isBankWithDepartmentAndZnsFlow: (shortName?: string | null) => shortName is (typeof BANKS_WITH_DEPARTMENT_AND_ZNS_FLOW)[number];
+export { BANK_CODES };

package/types/utils/transaction-confirmation-link.d.ts

@@ -0,0 +1,9 @@
+import { TransactionStatus } from '../types/enum';
+/** Logic cũ — nút "Copy link xác nhận" (link `/confirm/`) */
+export declare const CUSTOMER_CONFIRMATION_LINK_STATUS_VALUES: readonly [TransactionStatus.SENT_CONFIRMATION, TransactionStatus.CUSTOMER_PURCHASE_CONFIRMATION, "sent_confirmation_to_customer", "customer_purchase_confirmation"];
+/** Chỉ nút "Copy link xác nhận mua" (link `/confirm-purchase/`) */
+export declare const CUSTOMER_PURCHASE_CONFIRMATION_LINK_STATUS_VALUES: readonly [TransactionStatus.CUSTOMER_PURCHASE_CONFIRMATION, "customer_purchase_confirmation"];
+export declare const canCopyCustomerConfirmationLink: (status?: TransactionStatus | string | null) => boolean;
+export declare const canCopyCustomerPurchaseConfirmationLink: (status?: TransactionStatus | string | null) => boolean;
+export declare const getCustomerConfirmationLink: (publicId: string) => string;
+export declare const getCustomerPurchaseConfirmationLink: (publicId: string) => string;