@munchi_oy/payments 1.6.10 → 1.10.1

package/dist/src/types/payment.d.ts

@@ -1,4 +1,4 @@
-import type { CurrencyCode, PaymentProvider, ProviderEnum, TransactionDto } from "@munchi_oy/core";
+import type { CurrencyCode, PaymentProvider, ProviderEnum, SplitContextDto, TransactionDto } from "@munchi_oy/core";
 export type TransactionDetails = Omit<TransactionDto, "id" | "createdAt" | "provider">;
 export declare enum SdkPaymentStatus {
     PENDING = "PENDING",
@@ -43,6 +43,12 @@ export interface PaymentRequest {
     currency: CurrencyCode;
     displayId: string;
     options?: VivaOptions | NetsOptions | WorldlineOptions;
+    /**
+     * Split context for the payment-session flow. Omit for a full-cart payment,
+     * or send { mode, partId|seatId } for a split. Must match the order's
+     * checkoutModel. Only consumed by VivaSessionStrategy.
+     */
+    splitContext?: SplitContextDto;
 }
 export interface RefundRequest {
     amountCents: number;
@@ -61,9 +67,30 @@ export interface RefundRequest {
     businessId: number;
     options?: VivaRefundOptions | NetsRefundOptions | WorldlineRefundOptions;
 }
+export interface ManualPaymentRequest {
+    orderRef: string;
+    amountCents: number;
+    paymethod: string;
+    tipAmount?: number;
+    splitContext?: SplitContextDto;
+    /**
+     * Arbitrary client metadata persisted on the session (e.g. voucher code,
+     * gift card id, employee id, external reference, notes). Surfaced to
+     * reconciliation when building the order paymentEvent.
+     */
+    metadata?: Record<string, unknown>;
+}
+export interface VoidRequest {
+    orderRef: string;
+    sessionId: string;
+}
+export interface RevertRequest {
+    orderRef: string;
+    originalTransactionId: string;
+}
 export interface PaymentTerminalConfig {
     channel: ProviderEnum;
-    provider?: PaymentProvider | null;
+    provider: PaymentProvider;
     kioskId: string;
     storeId: string;
 }
@@ -112,6 +139,9 @@ export interface IMunchiPaymentSDK {
     initiateTransaction(params: PaymentRequest, options?: TransactionOptions): Promise<PaymentResult>;
     cancel(): Promise<boolean>;
     refund(params: RefundRequest, options?: TransactionOptions): Promise<PaymentResult>;
+    revert(params: RevertRequest, options?: TransactionOptions): Promise<PaymentResult>;
+    recordManualPayment(params: ManualPaymentRequest, options?: TransactionOptions): Promise<PaymentResult>;
+    voidManualPayment(params: VoidRequest, options?: TransactionOptions): Promise<PaymentResult>;
     reset(): void;
 }
 //# sourceMappingURL=payment.d.ts.map

package/dist/src/types/payment.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/types/payment.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"payment.d.ts","sourceRoot":"","sources":["../../../src/types/payment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,EACf,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,kBAAkB,GAAG,IAAI,CACnC,cAAc,EACd,IAAI,GAAG,WAAW,GAAG,UAAU,CAChC,CAAC;AAEF,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,KAAK,UAAU;CAChB;AAED,oBAAY,uBAAuB;IACjC,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,cAAc,mBAAmB;IACjC,UAAU,eAAe;IACzB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,cAAc,mBAAmB;IACjC,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;CAErD;AAED,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;CAE/D;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,gBAAgB,CAAC;IACvD;;;;OAIG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;;OAOG;IACH,qBAAqB,EAAE,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,GAAG,sBAAsB,CAAC;CAC1E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,eAAe,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,cAAc,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,KAAK,IAAI,CAAC;IACX,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,KAAK,IAAI,CAAC;IACX,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,KAAK,IAAI,CAAC;IACX,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,KAAK,IAAI,CAAC;IACX,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KACnC,KAAK,IAAI,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,CAAC,EACT,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,GAC3B,MAAM,IAAI,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAC1E,mBAAmB,CACjB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,MAAM,CACJ,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,MAAM,CACJ,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,mBAAmB,CACjB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,iBAAiB,CACf,MAAM,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/src/types/sdk.d.ts

@@ -59,5 +59,14 @@ export interface SDKOptions {
      */
     autoResetOnPaymentComplete?: AutoResetOptions;
     appToApp?: AppToAppConfig;
+    /**
+     * Routes POS Viva payments through the backend payment-session flow
+     * (VivaSessionStrategy) instead of the legacy v4 VivaStrategy. Kiosk/handheld
+     * leave this unset and stay on the legacy flow.
+     */
+    paymentSession?: PaymentSessionConfig;
+}
+export interface PaymentSessionConfig {
+    enabled: boolean;
 }
 //# sourceMappingURL=sdk.d.ts.map

package/dist/src/types/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/types/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnD,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,aAAa,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvD,aAAa,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,0BAA0B,CAAC,EAAE,gBAAgB,CAAC;IAC9C,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/types/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC7D;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnD,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACnD,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IAClD,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC1C,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACnD;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;AACvD,MAAM,MAAM,2BAA2B,GAAG,UAAU,GAAG,aAAa,CAAC;AAErE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACvD,aAAa,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,2BAA2B,CAAC;IAClD,OAAO,EAAE,eAAe,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,0BAA0B,CAAC,EAAE,gBAAgB,CAAC;IAC9C,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.6.10";
+export declare const VERSION = "1.10.1";
 //# sourceMappingURL=version.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@munchi_oy/payments",
-  "version": "1.6.10",
+  "version": "1.10.1",
   "description": "Munchi Payments SDK - Payment processing utilities",
   "license": "UNLICENSED",
   "publishConfig": {
@@ -32,7 +32,7 @@
     "@types/jest": "^30.0.0",
     "tsup": "^8.0.0",
     "typescript": "^5.0.0",
-    "@munchi_oy/core": "1.9.11"
+    "@munchi_oy/core": "1.9.41"
   },
   "scripts": {
     "test": "jest",

package/src/MunchiPaymentSDK.ts

@@ -4,22 +4,32 @@ import { version } from "../package.json";
 import { PaymentErrorCode, PaymentSDKError } from "./error";
 import type { IPaymentStrategy } from "./strategies/IPaymentStrategy";
 import { StrategyExecutionMode } from "./strategies/IPaymentStrategy";
+import { ManualSessionStrategy } from "./strategies/ManualSessionStrategy";
 import { NetsStrategy } from "./strategies/NetsStrategy";
 import { VivaAppToAppStrategy } from "./strategies/VivaAppToAppStrategy";
+import { VivaSessionStrategy } from "./strategies/VivaSessionStrategy";
 import { VivaStrategy } from "./strategies/VivaStrategy";
 import { WorldlineStrategy } from "./strategies/WorldlineStrategy";
 import {
   type IMessagingAdapter,
   type IMunchiPaymentSDK,
+  type ManualPaymentRequest,
   PaymentInteractionState,
   type PaymentResult,
   type PaymentTerminalConfig,
   type RefundRequest,
+  type RevertRequest,
   type PaymentRequest as SdkPaymentRequest,
   SdkPaymentStatus,
   type TransactionOptions,
+  type VoidRequest,
 } from "./types/payment";
-import type { AppToAppConfig, ILogger, SDKOptions } from "./types/sdk";
+import type {
+  AppToAppConfig,
+  ILogger,
+  PaymentSessionConfig,
+  SDKOptions,
+} from "./types/sdk";
 
 type StateListener = (state: PaymentInteractionState) => void;
 
@@ -36,6 +46,8 @@ export class MunchiPaymentSDK implements IMunchiPaymentSDK {
   private _autoResetTimer: ReturnType<typeof setTimeout> | undefined;
   private autoResetOptions: SDKOptions["autoResetOnPaymentComplete"];
   private appToAppConfig: AppToAppConfig | undefined;
+  private paymentSessionConfig: PaymentSessionConfig | undefined;
+  private manualStrategy: ManualSessionStrategy;
 
   private static readonly TERMINAL_STATES = [
     PaymentInteractionState.SUCCESS,
@@ -61,6 +73,8 @@ export class MunchiPaymentSDK implements IMunchiPaymentSDK {
     this.timeoutMs = options.timeoutMs || 30000;
     this.autoResetOptions = options.autoResetOnPaymentComplete;
     this.appToAppConfig = options.appToApp;
+    this.paymentSessionConfig = options.paymentSession;
+    this.manualStrategy = new ManualSessionStrategy(axios, config);
     this.strategy = strategy ?? this.resolveStrategy(config);
   }
 
@@ -200,6 +214,9 @@ export class MunchiPaymentSDK implements IMunchiPaymentSDK {
             this.appToAppConfig,
           );
         }
+        if (this.paymentSessionConfig?.enabled) {
+          return new VivaSessionStrategy(this.axios, this.messaging, config);
+        }
         return new VivaStrategy(this.axios, this.messaging, config);
 
       default:
@@ -645,4 +662,163 @@ export class MunchiPaymentSDK implements IMunchiPaymentSDK {
       return errorResult;
     }
   };
+
+  public revert = async (
+    params: RevertRequest,
+    options?: TransactionOptions,
+  ): Promise<PaymentResult> => {
+    const callbacks = options ?? {};
+    this.logger?.info("Reverting payment", { orderRef: params.orderRef });
+    this._currentSessionId = params.originalTransactionId;
+    this._cancellationIntent = false;
+
+    if (!MunchiPaymentSDK.RESTING_STATES.includes(this._currentState)) {
+      return this.generateErrorResult(
+        params.orderRef,
+        PaymentErrorCode.UNKNOWN,
+        "A transaction is already in progress",
+      );
+    }
+
+    const revertTransaction = this.strategy.revertTransaction?.bind(
+      this.strategy,
+    );
+    if (!revertTransaction) {
+      return this.generateErrorResult(
+        params.orderRef,
+        PaymentErrorCode.STRATEGY_ERROR,
+        "Revert is not supported by the active payment strategy",
+      );
+    }
+
+    this.transitionTo(PaymentInteractionState.CONNECTING);
+
+    try {
+      const result = await revertTransaction(params);
+      this.settleSingleShot(result, params.orderRef, callbacks);
+      return result;
+    } catch (error) {
+      this.logger?.error("Revert failed", error);
+      return this.failSingleShot(
+        params.orderRef,
+        error,
+        "Revert failed",
+        callbacks,
+      );
+    }
+  };
+
+  public recordManualPayment = async (
+    params: ManualPaymentRequest,
+    options?: TransactionOptions,
+  ): Promise<PaymentResult> => {
+    const callbacks = options ?? {};
+    this.logger?.info("Recording manual payment", {
+      orderRef: params.orderRef,
+    });
+    this._currentSessionId = undefined;
+    this._cancellationIntent = false;
+
+    if (!MunchiPaymentSDK.RESTING_STATES.includes(this._currentState)) {
+      return this.generateErrorResult(
+        params.orderRef,
+        PaymentErrorCode.UNKNOWN,
+        "A transaction is already in progress",
+      );
+    }
+
+    this.transitionTo(PaymentInteractionState.CONNECTING);
+    this.safeFireCallback(() =>
+      callbacks.onConnecting?.({
+        orderRef: params.orderRef,
+        refPaymentId: undefined,
+      }),
+    );
+
+    try {
+      const result = await this.manualStrategy.recordPayment(params);
+      this.settleSingleShot(result, params.orderRef, callbacks);
+      return result;
+    } catch (error) {
+      this.logger?.error("Manual payment failed", error);
+      return this.failSingleShot(
+        params.orderRef,
+        error,
+        "Manual payment failed",
+        callbacks,
+      );
+    }
+  };
+
+  public voidManualPayment = async (
+    params: VoidRequest,
+    options?: TransactionOptions,
+  ): Promise<PaymentResult> => {
+    const callbacks = options ?? {};
+    this.logger?.info("Voiding manual payment", { orderRef: params.orderRef });
+    this._currentSessionId = params.sessionId;
+    this._cancellationIntent = false;
+
+    if (!MunchiPaymentSDK.RESTING_STATES.includes(this._currentState)) {
+      return this.generateErrorResult(
+        params.orderRef,
+        PaymentErrorCode.UNKNOWN,
+        "A transaction is already in progress",
+      );
+    }
+
+    this.transitionTo(PaymentInteractionState.CONNECTING);
+
+    try {
+      const result = await this.manualStrategy.voidPayment(params);
+      this.settleSingleShot(result, params.orderRef, callbacks);
+      return result;
+    } catch (error) {
+      this.logger?.error("Manual void failed", error);
+      return this.failSingleShot(
+        params.orderRef,
+        error,
+        "Void failed",
+        callbacks,
+      );
+    }
+  };
+
+  private settleSingleShot(
+    result: PaymentResult,
+    orderRef: string,
+    callbacks: TransactionOptions,
+  ): void {
+    if (result.success) {
+      this.transitionTo(PaymentInteractionState.SUCCESS);
+      this.safeFireCallback(() => callbacks.onSuccess?.(result));
+    } else if (result.status === SdkPaymentStatus.CANCELLED) {
+      this.transitionTo(PaymentInteractionState.FAILED);
+      this.safeFireCallback(() =>
+        callbacks.onCancelled?.({
+          orderRef,
+          refPaymentId: this._currentSessionId,
+        }),
+      );
+    } else {
+      this.transitionTo(PaymentInteractionState.FAILED);
+      this.safeFireCallback(() => callbacks.onError?.(result));
+    }
+  }
+
+  private failSingleShot(
+    orderRef: string,
+    error: unknown,
+    fallbackMessage: string,
+    callbacks: TransactionOptions,
+  ): PaymentResult {
+    const errorResult = this.generateErrorResult(
+      orderRef,
+      PaymentErrorCode.NETWORK_ERROR,
+      error instanceof Error ? error.message : fallbackMessage,
+    );
+    this.transitionTo(PaymentInteractionState.FAILED);
+    this.safeFireCallback(() => callbacks.onError?.(errorResult));
+    return errorResult;
+  }
 }

package/src/strategies/IPaymentStrategy.ts

@@ -3,6 +3,7 @@ import type {
   PaymentRequest,
   PaymentResult,
   RefundRequest,
+  RevertRequest,
 } from "../types/payment";
 
 export enum StrategyExecutionMode {
@@ -25,5 +26,6 @@ export interface IPaymentStrategy {
     onStateChange: (state: PaymentInteractionState, detail?: { sessionId?: string }) => void,
   ): Promise<PaymentResult>;
   verifyFinalStatus(request: PaymentRequest, sessionId: string): Promise<PaymentResult>;
+  revertTransaction?(request: RevertRequest): Promise<PaymentResult>;
   abort(): void;
 }

package/src/strategies/ManualSessionStrategy.ts

@@ -0,0 +1,93 @@
+import {
+  type CreateManualSessionDto,
+  PaymentSessionApi,
+  PaymentSessionStatus,
+} from "@munchi_oy/core";
+import type { AxiosInstance } from "axios";
+
+import { PaymentErrorCode, PaymentSDKError } from "../error";
+import {
+  type ManualPaymentRequest,
+  type PaymentResult,
+  type PaymentTerminalConfig,
+  SdkPaymentStatus,
+  type VoidRequest,
+} from "../types/payment";
+import { mapSessionResult } from "./sessionResult";
+
+export class ManualSessionStrategy {
+  private sessionApi: PaymentSessionApi;
+
+  constructor(
+    axios: AxiosInstance,
+    private config: PaymentTerminalConfig,
+  ) {
+    this.sessionApi = new PaymentSessionApi(undefined, "", axios);
+  }
+
+  async recordPayment(request: ManualPaymentRequest): Promise<PaymentResult> {
+    try {
+      const payload: CreateManualSessionDto = {
+        businessId: Number(this.config.storeId),
+        orderId: request.orderRef,
+        amount: request.amountCents,
+        paymethod: request.paymethod,
+        provider: this.config.provider,
+      };
+      if (request.tipAmount !== undefined) {
+        payload.tipAmount = request.tipAmount;
+      }
+      if (request.splitContext !== undefined) {
+        payload.splitContext = request.splitContext;
+      }
+      if (request.metadata !== undefined) {
+        payload.metadata = request.metadata;
+      }
+
+      const { data } = await this.sessionApi.recordManualPayment(payload);
+      return mapSessionResult(data, request.orderRef);
+    } catch (error) {
+      throw new PaymentSDKError(
+        PaymentErrorCode.NETWORK_ERROR,
+        "Failed to record manual payment",
+        error,
+      );
+    }
+  }
+
+  async voidPayment(request: VoidRequest): Promise<PaymentResult> {
+    try {
+      const { data } = await this.sessionApi.voidManualPayment({
+        sessionId: request.sessionId,
+      });
+
+      const isVoided =
+        data.status === PaymentSessionStatus.Voided ||
+        data.status === PaymentSessionStatus.Voiding;
+
+      const result: PaymentResult = {
+        success: isVoided,
+        status: isVoided ? SdkPaymentStatus.SUCCESS : SdkPaymentStatus.FAILED,
+        orderId: request.orderRef,
+        transactionId: data.providerTransactionId ?? data.sessionId,
+      };
+
+      if (!isVoided) {
+        if (data.errorCode) {
+          result.errorCode = data.errorCode;
+        }
+        if (data.errorMessage) {
+          result.errorMessage = data.errorMessage;
+        }
+      }
+
+      return result;
+    } catch (error) {
+      throw new PaymentSDKError(
+        PaymentErrorCode.NETWORK_ERROR,
+        "Failed to void manual payment",
+        error,
+      );
+    }
+  }
+}