@achyutlabsau/vue-payment-gateway 0.16.0 → 0.17.0

package/dist/index.d.ts

@@ -1077,7 +1077,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1108,10 +1109,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/index.js

@@ -1,9 +1,9 @@
 import { d as e, f as t, m as n, p as r, s as i } from "./PairInstructions-BxzivULm.js";
 import { i as a, t as o } from "./tyro-CfOu7q7t.js";
 import { f as s, m as c } from "./mx51-Df356gl0.js";
-import { a as l, i as u, r as d } from "./worldline-B-YkSPMs.js";
+import { a as l, i as u, r as d } from "./worldline-nQDVuEak.js";
 import { n as f } from "./utils-CAwJtwP_.js";
-import { t as p } from "./linkly-BICvJBrk.js";
+import { t as p } from "./linkly-BVBOUjZX.js";
 import { t as m } from "./smartpay-BHnbLa5i.js";
 import { t as h } from "./till-payment-BlnycpPt.js";
 import { t as g } from "./valpay-Co5GhIks.js";

package/dist/{linkly-BICvJBrk.js → linkly-BVBOUjZX.js}

@@ -264,12 +264,16 @@ var z = {
 			TxnRef: l(),
 			TxnType: n,
 			CurrencyCode: q.AustralianDollar,
-			CutReceipt: t.CutReceipt,
-			AmtPurchase: t.AmtPurchase,
-			ReceiptAutoPrint: t.ReceiptAutoPrint,
-			...t.referenceNumber ? { PurchaseAnalysisData: { RFN: t.referenceNumber } } : {}
+			EnableTip: t.isTipEnabled ? "TRUE" : "FALSE",
+			CutReceipt: "1",
+			AmtPurchase: t.amount,
+			ReceiptAutoPrint: t.ReceiptAutoPrint ?? J.ReturnToPOS,
+			PurchaseAnalysisData: {
+				...t.isTipEnabled && t.tipAmount && { TIP: t.tipAmount },
+				...t.originalTransactionId && { RFN: t.originalTransactionId }
+			}
 		} }, i = m({
-			message: `${n === K.Purchase ? "Purchase" : "Refund"} of $${t.AmtPurchase / 100} in progress...`,
+			message: `${n === K.Purchase ? "Purchase" : "Refund"} of $${t.amount / 100} in progress...`,
 			onCancel: () => {
 				i.progress("Trying to cancel transaction..."), e.sendKey(X.Cancel);
 			}

package/dist/linkly.d.ts

@@ -259,6 +259,10 @@ export declare interface PinpadPairResponse {
 }
 
 declare interface PurchaseAnalysisData {
+    /**
+     * Tip amount in cents
+     */
+    TIP?: number;
     OPR?: string;
     AMT?: string;
     PCM?: string;
@@ -330,14 +334,22 @@ export declare enum TransactionOutcome {
     UNKNOWN = "UNKNOWN"
 }
 
-export declare type TransactionPayload = Pick<TransactionPostRequest, "AmtPurchase" | "ReceiptAutoPrint" | "CutReceipt"> & {
+export declare interface TransactionPayload {
+    /**
+     * Left zero filled, amount of sale in cents.
+     */
+    amount: number;
+    /** Tip amount in cents, or `null` when there was no tip. */
+    tipAmount?: number;
+    isTipEnabled?: boolean;
+    ReceiptAutoPrint?: ReceiptAutoPrint;
     /**
      * Reference Number (RFN) from the original purchase this refund relates to.
      * When provided on a refund, Linkly performs a referenced (linked) refund by
      * sending it as `PurchaseAnalysisData.RFN`. Ignored for purchases.
      */
-    referenceNumber?: string;
-};
+    originalTransactionId?: string;
+}
 
 /**
  * View Documentation - https://www.linkly.com.au/apidoc/REST/#purchase
@@ -357,6 +369,10 @@ export declare interface TransactionPostRequest {
      * Left zero filled, amount of sale in cents.
      */
     AmtPurchase: number;
+    /**
+     * Set to TRUE if tipping is to be enabled for this transaction. The default is FALSE
+     */
+    EnableTip?: "TRUE" | "FALSE";
     /**
      * The reference number to attach to the transaction. This will appear on the receipt.
      */
@@ -1483,7 +1499,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1514,10 +1531,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/linkly.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "./linkly-BICvJBrk.js";
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "./linkly-BVBOUjZX.js";
 export { a as CurrencyCodes, n as LinklyKeyType, s as PairLinkly, e as ReceiptAutoPrint, i as ResponseCodes, o as TransactionOutcome, t as TransactionTypes, r as useLinkly };

package/dist/mx51.d.ts

@@ -1122,7 +1122,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1153,10 +1154,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/smartpay.d.ts

@@ -1160,7 +1160,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1191,10 +1192,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/till-payment.d.ts

@@ -1466,7 +1466,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1497,10 +1498,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/tyro.d.ts

@@ -1176,7 +1176,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1207,10 +1208,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/valpay.d.ts

@@ -1857,7 +1857,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1888,10 +1889,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/{worldline-B-YkSPMs.js → worldline-nQDVuEak.js}

@@ -109,7 +109,7 @@ var R = new class extends P {
 	}
 	createTerminal(e, t) {
 		let n = new timapi.TerminalSettings();
-		n.connectionIPString = e, n.connectionIPPort = t, n.persistentState = !0, n.enableKeepAlive = !0, n.autoCommit = !0, n.dcc = !1, n.tipAllowed = !1, n.partialApproval = !1, n.integratorId = this._config.integratorId, n.guides.add(timapi.constants.Guides.retail), this.terminal = new timapi.Terminal(n), this.terminal.setUserId("1"), this.terminal.setPosId(this._config.posId);
+		n.connectionIPString = e, n.connectionIPPort = t, n.persistentState = !0, n.enableKeepAlive = !0, n.autoCommit = !0, n.dcc = !1, n.tipAllowed = !0, n.partialApproval = !1, n.integratorId = this._config.integratorId, n.guides.add(timapi.constants.Guides.retail), n.guides.add(timapi.constants.Guides.gastro), this.terminal = new timapi.Terminal(n), this.terminal.setUserId("1"), this.terminal.setPosId(this._config.posId);
 		let r = new timapi.EcrInfo();
 		return r.type = timapi.constants.EcrInfoType.ecrApplication, r.name = this._config.posName, r.manufacturerName = this._config.posVendorName, r.version = this._config.posVersion, this.terminal.addEcrData(r), this.terminal;
 	}
@@ -160,10 +160,10 @@ var R = new class extends P {
 	actionReconfig() {
 		this.isReady && (this.ensureTerminal().reconfigAsync(), this.requestInProgress = timapi.constants.RequestType.reconfig);
 	}
-	actionPurchase(e) {
+	actionPurchase(e, n) {
 		if (this.isReady) try {
-			let n = new timapi.Amount(e, timapi.constants.Currency.AUD);
-			this.ensureTerminal().transactionAsync(timapi.constants.TransactionType.purchase, n), t.emit("txnStarted", e, "purchase");
+			let r = new timapi.Amount(e, timapi.constants.Currency.AUD), i = new timapi.Amount(n ?? 0, timapi.constants.Currency.AUD);
+			this.ensureTerminal().transactionTipAsync(timapi.constants.TransactionType.purchase, r, i), t.emit("txnStarted", e, "purchase");
 		} catch (e) {
 			t.emit("txnCompleted", {
 				exception: e,

package/dist/worldline.d.ts

@@ -43,7 +43,15 @@ declare class AdvanceEcr {
     actionReceiptRequest(type: string): void;
     actionSoftwareUpdate(): void;
     actionReconfig(): void;
-    actionPurchase(purchaseAmount: number): void;
+    /**
+     * Make a purchase, optionally with a tip.
+     *
+     * Runs a tip-enabled purchase via TimAPI's `transactionTipAsync`, which
+     * requires the `gastro` guide and `tipAllowed` to be set on the terminal
+     * (both configured during terminal setup). `purchaseAmount` and `tipAmount`
+     * are in cents. When `tipAmount` is omitted it defaults to `10` cents.
+     */
+    actionPurchase(purchaseAmount: number, tipAmount?: number): void;
     /**
      * Make a refund.
      *
@@ -1093,7 +1101,8 @@ declare global {
       cancel(): void;
       // TODO:
       setTransactionData(trxData: TransactionData): void;
-      transactionAsync(txnType: EnumValue, amount?: Amount): void;
+      transactionAsync(txnType: EnumValue, amount: Amount): void;
+      transactionTipAsync(txnType: EnumValue, amount: Amount, amountTip?: Amount): void;
       dispose(): void;
       getTransactionData(): TransactionData | undefined;
     }
@@ -1124,10 +1133,96 @@ declare global {
     }
 
     class TransactionData {
-      transSeq: string;
+      /** Whether Dynamic Currency Conversion is allowed for the transaction. */
+      dccAllowed?: boolean;
+      /** Date of the original transaction (used for referenced/follow-up transactions). */
+      trxOriginalDate?: TimeDate;
+      /** ECR sequence counter. */
+      ecrSeqCounter?: number;
+      /** Whether partial approval is allowed. */
+      partialApprovalAllowed?: boolean;
+      /** ECR transaction reference. */
+      transRef?: string;
+      /** Terminal transaction sequence number — references the original sale for a reversal. */
+      transSeq?: string;
+      /** Card reference token. */
+      cardRef?: string;
+      /** Acquirer id. */
+      acqId?: number;
+      /** Acquirer transaction reference. Prefer {@link setAcqTransRef}. */
+      acqTransRef?: string;
+      /** Terminal transaction reference. */
+      trmTransRef?: string;
+      /** Whether tipping is allowed for the transaction. */
+      tipAllowed?: boolean;
+      /** Phone authorization code. */
+      phoneAuthCode?: string;
+      /** Cardholder/terminal language. */
+      language?: string;
+      /** Multi-currency flag. */
+      multiCurrencyFlag?: boolean;
+      /** NGV mode. One of the `Constants.NgvMode` enum values. */
+      ngvMode?: EnumValue;
+      /** NGV clearing delay. */
+      ngvClearingDelay?: number;
+      /** Card verification code (CVC2/CVV2). */
+      cvc2?: string;
+      /** Application expiration date. */
+      appExpirationDate?: TimeDate;
+      /** SIX transaction reference number. Prefer {@link setSixTrxRefNum}. */
+      sixTrxRefNum?: string;
+      /** Whether installment payment is allowed. */
+      installmentAllowed?: boolean;
+      /** Deferred authorization indicator. */
+      deferredAuthInd?: boolean;
+      /** Sub-transactions making up this transaction. */
+      subTransactions: SubTransaction[];
+      /** Allowed account types. Each is a `Constants.AllowedAccounts` enum value. */
+      allowedAccounts?: EnumValue[];
+      /** Tokenized PAN. */
+      tokenPan?: string;
+      /** Token PAN type. One of the `Constants.TokenPanType` enum values. */
+      tokenPanType?: EnumValue;
+      /** Age to verify for age-restricted goods. */
+      ageToCheck?: number;
+      /** Authorization code. */
+      authCode?: string;
+      /** Forced POS entry modes. */
+      forcePosEntryModes?: EnumValue[];
+      /** Allowed application (brand) list. */
+      allowedAppList?: EnumValue[];
+      constructor(copyTrxData?: TransactionData);
+      /** Build {@link acqTransRef} from an acquirer id and transaction reference number. */
+      setAcqTransRef(acqId: number, trxRefNo: number): void;
+      /** Build {@link sixTrxRefNum} from an acquirer id and transaction reference number. */
+      setSixTrxRefNum(acqId: number, trxRefNum: number): void;
+      toString(): string;
+    }
+
+    /** Sub-transaction entry within {@link TransactionData.subTransactions}. */
+    class SubTransaction {
       constructor();
     }
 
+    /** Terminal date/time value used across the API. */
+    class TimeDate {
+      year: number;
+      month: number;
+      day: number;
+      hour: number;
+      minute: number;
+      second: number;
+      constructor();
+      toDate(): Date;
+      toStringRegular(): string;
+      toStringReceiptDate(): string;
+      toStringReceiptTime(): string;
+      toString(): string;
+      static fromDate(date: Date): TimeDate;
+      static fromNow(): TimeDate;
+      static copy(timeDate: TimeDate): TimeDate;
+    }
+
     class LogRecord {
       file: string;
       level: { name: string; _value: number };

package/dist/worldline.js

@@ -1,3 +1,3 @@
 import { t as e } from "./emitter-BNPvJMuc.js";
-import { a as t, i as n, n as r, o as i, r as a, t as o } from "./worldline-B-YkSPMs.js";
+import { a as t, i as n, n as r, o as i, r as a, t as o } from "./worldline-nQDVuEak.js";
 export { a as PairTimapi, r as TimApiDialog, t as TimApiEvents, o as TimApiLogs, i as TransactionTypes, e as emitter, n as timApi };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@achyutlabsau/vue-payment-gateway",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "private": false,
   "homepage": "https://github.com/Achyut-Labs/al-pay-npm-pkg#readme",
   "bugs": {