@munchi_oy/core 1.9.73 → 1.9.74

package/generated/api.ts

@@ -6677,6 +6677,56 @@ export interface ImageBackgroundConfig {
 }
 
 
+/**
+ * 
+ * @export
+ * @interface InitiateNetsSessionDto
+ */
+export interface InitiateNetsSessionDto {
+    /**
+     * The internal business ID.
+     * @type {number}
+     * @memberof InitiateNetsSessionDto
+     */
+    'businessId': number;
+    /**
+     * The POS order ID this payment session is for.
+     * @type {string}
+     * @memberof InitiateNetsSessionDto
+     */
+    'orderId': string;
+    /**
+     * Amount to charge in smallest currency unit (cents).
+     * @type {number}
+     * @memberof InitiateNetsSessionDto
+     */
+    'amount': number;
+    /**
+     * 
+     * @type {InitiateVivaSessionDtoSplitContext}
+     * @memberof InitiateNetsSessionDto
+     */
+    'splitContext'?: InitiateVivaSessionDtoSplitContext;
+}
+/**
+ * 
+ * @export
+ * @interface InitiateNetsSessionResponseDto
+ */
+export interface InitiateNetsSessionResponseDto {
+    /**
+     * Opaque token returned to the client. Used by the client to poll/sync the session. Never sent to Nets.
+     * @type {string}
+     * @memberof InitiateNetsSessionResponseDto
+     */
+    'clientToken': string;
+    /**
+     * Internal session ID — the Nets ConnectCloud request id the webhook resolves against.
+     * @type {string}
+     * @memberof InitiateNetsSessionResponseDto
+     */
+    'sessionId': string;
+}
 /**
  * 
  * @export
@@ -10147,6 +10197,65 @@ export interface NetsPaymentMessageDtoData {
      */
     'storeboxToken'?: string;
 }
+/**
+ * 
+ * @export
+ * @enum {string}
+ */
+
+export const NetsRevertMethod = {
+    Reversal: 'REVERSAL',
+    Refund: 'REFUND'
+} as const;
+
+export type NetsRevertMethod = typeof NetsRevertMethod[keyof typeof NetsRevertMethod];
+
+
+/**
+ * 
+ * @export
+ * @interface NetsRevertResponseDto
+ */
+export interface NetsRevertResponseDto {
+    /**
+     * 
+     * @type {NetsRevertMethod}
+     * @memberof NetsRevertResponseDto
+     */
+    'method': NetsRevertMethod;
+    /**
+     * True when the customer must tap their card to complete (REFUND); false for a REVERSAL, which settles without a tap.
+     * @type {boolean}
+     * @memberof NetsRevertResponseDto
+     */
+    'requiresCardTap': boolean;
+    /**
+     * Opaque token to poll GET /payment-session/:clientToken for the final outcome.
+     * @type {string}
+     * @memberof NetsRevertResponseDto
+     */
+    'clientToken': string;
+    /**
+     * Internal session id — the Nets connectcloud-request-id the webhook resolves against.
+     * @type {string}
+     * @memberof NetsRevertResponseDto
+     */
+    'sessionId': string;
+    /**
+     * Amount being reverted, in the smallest currency unit (cents).
+     * @type {number}
+     * @memberof NetsRevertResponseDto
+     */
+    'amount': number;
+    /**
+     * 
+     * @type {PaymentSessionStatus}
+     * @memberof NetsRevertResponseDto
+     */
+    'status': PaymentSessionStatus;
+}
+
+
 /**
  * 
  * @export
@@ -40769,15 +40878,15 @@ export class PaymentMethodsApi extends BaseAPI implements PaymentMethodsApiInter
 export const PaymentSessionApiAxiosParamCreator = function (configuration?: Configuration) {
     return {
         /**
-         * Arms cancelRequestedAt + aborts the Viva terminal session. Does not flip status — the webhook/sweep resolves the real outcome, and a late success is auto-voided. Viva card only.
-         * @summary Cancel an in-flight Viva payment session
+         * Arms cancelRequestedAt + aborts at the gateway (Viva session abort / Nets terminal cancelAction, dispatched on the session\'s provider). Does not flip status — the webhook/sweep resolves the real outcome; a late success parks at VOID_PENDING with a dev alert. Card sessions only.
+         * @summary Cancel an in-flight card payment session (Viva or Nets)
          * @param {string} clientToken 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        cancelVivaSession: async (clientToken: string, options: AxiosRequestConfig = {}): Promise<RequestArgs> => {
+        cancelSession: async (clientToken: string, options: AxiosRequestConfig = {}): Promise<RequestArgs> => {
             // verify required parameter 'clientToken' is not null or undefined
-            assertParamExists('cancelVivaSession', 'clientToken', clientToken)
+            assertParamExists('cancelSession', 'clientToken', clientToken)
             const localVarPath = `/api/v1/payment-session/{clientToken}/cancel`
                 .replace(`{${"clientToken"}}`, encodeURIComponent(String(clientToken)));
             // use dummy base URL string because the URL constructor only accepts absolute URLs.
@@ -40836,6 +40945,47 @@ export const PaymentSessionApiAxiosParamCreator = function (configuration?: Conf
                 options: localVarRequestOptions,
             };
         },
+        /**
+         * Creates a PaymentSession row, pushes the transaction to the station\'s Nets terminal (async — the result arrives via the Nets webhook), returns a client-facing token to poll. Idempotent via X-Idempotency-Key header.
+         * @summary Initiate a Nets terminal payment session
+         * @param {InitiateNetsSessionDto} initiateNetsSessionDto 
+         * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        initiateNetsSession: async (initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options: AxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'initiateNetsSessionDto' is not null or undefined
+            assertParamExists('initiateNetsSession', 'initiateNetsSessionDto', initiateNetsSessionDto)
+            const localVarPath = `/api/v1/payment-session/nets/initiate`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+            if (xIdempotencyKey != null) {
+                localVarHeaderParameter['X-Idempotency-Key'] = String(xIdempotencyKey);
+            }
+
+
+    
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(initiateNetsSessionDto, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * Builds the Viva app-to-app launch params (same as the legacy viva/a2a/create-payment) and persists a PaymentSession keyed by the Viva clientTransactionId, so the webhook + reconciliation own the order mutation. Returns the launch params plus a clientToken to poll the session.
          * @summary Initiate a Viva app-to-app payment session
@@ -40985,6 +41135,42 @@ export const PaymentSessionApiAxiosParamCreator = function (configuration?: Conf
                 options: localVarRequestOptions,
             };
         },
+        /**
+         * Starts a terminal-present ReturnOfGoods on the station\'s Nets terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session (status INITIATED) — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
+         * @summary Refund a settled Nets payment session (gateway only, async)
+         * @param {ReverseSessionDto} reverseSessionDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        refundNetsSession: async (reverseSessionDto: ReverseSessionDto, options: AxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'reverseSessionDto' is not null or undefined
+            assertParamExists('refundNetsSession', 'reverseSessionDto', reverseSessionDto)
+            const localVarPath = `/api/v1/payment-session/nets/refund`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+
+    
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(reverseSessionDto, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
         /**
          * Refunds a Viva card payment at the gateway by its sessionId, optionally a partial `amount` (item / cluster refund). Validates the remaining refundable balance and supports multiple partial refunds. Does NOT write a reversal paymentEvent to the order — order-side accounting is handled by the refund plan. For a full reversal that writes the order paymentEvent, use /revert.
          * @summary Refund a settled Viva payment session (gateway only)
@@ -41009,6 +41195,42 @@ export const PaymentSessionApiAxiosParamCreator = function (configuration?: Conf
 
 
     
+            localVarHeaderParameter['Content-Type'] = 'application/json';
+
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+            localVarRequestOptions.data = serializeDataIfNeeded(reverseSessionDto, localVarRequestOptions, configuration)
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Starts a terminal-present ReturnOfGoods for the full remaining amount AND writes a reversal paymentEvent to the order once the refund settles (via reconciliation). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED.
+         * @summary Revert (fully reverse) a settled Nets payment session (async)
+         * @param {ReverseSessionDto} reverseSessionDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        revertNetsSession: async (reverseSessionDto: ReverseSessionDto, options: AxiosRequestConfig = {}): Promise<RequestArgs> => {
+            // verify required parameter 'reverseSessionDto' is not null or undefined
+            assertParamExists('revertNetsSession', 'reverseSessionDto', reverseSessionDto)
+            const localVarPath = `/api/v1/payment-session/nets/revert`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+
+    
             localVarHeaderParameter['Content-Type'] = 'application/json';
 
             setSearchParams(localVarUrlObj, localVarQueryParameter);
@@ -41104,14 +41326,14 @@ export const PaymentSessionApiFp = function(configuration?: Configuration) {
     const localVarAxiosParamCreator = PaymentSessionApiAxiosParamCreator(configuration)
     return {
         /**
-         * Arms cancelRequestedAt + aborts the Viva terminal session. Does not flip status — the webhook/sweep resolves the real outcome, and a late success is auto-voided. Viva card only.
-         * @summary Cancel an in-flight Viva payment session
+         * Arms cancelRequestedAt + aborts at the gateway (Viva session abort / Nets terminal cancelAction, dispatched on the session\'s provider). Does not flip status — the webhook/sweep resolves the real outcome; a late success parks at VOID_PENDING with a dev alert. Card sessions only.
+         * @summary Cancel an in-flight card payment session (Viva or Nets)
          * @param {string} clientToken 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        async cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>> {
-            const localVarAxiosArgs = await localVarAxiosParamCreator.cancelVivaSession(clientToken, options);
+        async cancelSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.cancelSession(clientToken, options);
             return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
         },
         /**
@@ -41125,6 +41347,18 @@ export const PaymentSessionApiFp = function(configuration?: Configuration) {
             const localVarAxiosArgs = await localVarAxiosParamCreator.getPaymentSession(clientToken, options);
             return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
         },
+        /**
+         * Creates a PaymentSession row, pushes the transaction to the station\'s Nets terminal (async — the result arrives via the Nets webhook), returns a client-facing token to poll. Idempotent via X-Idempotency-Key header.
+         * @summary Initiate a Nets terminal payment session
+         * @param {InitiateNetsSessionDto} initiateNetsSessionDto 
+         * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InitiateNetsSessionResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.initiateNetsSession(initiateNetsSessionDto, xIdempotencyKey, options);
+            return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
+        },
         /**
          * Builds the Viva app-to-app launch params (same as the legacy viva/a2a/create-payment) and persists a PaymentSession keyed by the Viva clientTransactionId, so the webhook + reconciliation own the order mutation. Returns the launch params plus a clientToken to poll the session.
          * @summary Initiate a Viva app-to-app payment session
@@ -41170,6 +41404,17 @@ export const PaymentSessionApiFp = function(configuration?: Configuration) {
             const localVarAxiosArgs = await localVarAxiosParamCreator.recordManualPayment(createManualSessionDto, options);
             return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
         },
+        /**
+         * Starts a terminal-present ReturnOfGoods on the station\'s Nets terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session (status INITIATED) — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
+         * @summary Refund a settled Nets payment session (gateway only, async)
+         * @param {ReverseSessionDto} reverseSessionDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.refundNetsSession(reverseSessionDto, options);
+            return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
+        },
         /**
          * Refunds a Viva card payment at the gateway by its sessionId, optionally a partial `amount` (item / cluster refund). Validates the remaining refundable balance and supports multiple partial refunds. Does NOT write a reversal paymentEvent to the order — order-side accounting is handled by the refund plan. For a full reversal that writes the order paymentEvent, use /revert.
          * @summary Refund a settled Viva payment session (gateway only)
@@ -41181,6 +41426,17 @@ export const PaymentSessionApiFp = function(configuration?: Configuration) {
             const localVarAxiosArgs = await localVarAxiosParamCreator.refundVivaSession(reverseSessionDto, options);
             return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
         },
+        /**
+         * Starts a terminal-present ReturnOfGoods for the full remaining amount AND writes a reversal paymentEvent to the order once the refund settles (via reconciliation). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED.
+         * @summary Revert (fully reverse) a settled Nets payment session (async)
+         * @param {ReverseSessionDto} reverseSessionDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NetsRevertResponseDto>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.revertNetsSession(reverseSessionDto, options);
+            return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
+        },
         /**
          * Fully reverses a completed Viva card payment (SUCCESS / CLOSED) by its sessionId: refunds the full amount at the gateway AND writes a reversal paymentEvent to the order via the settlement engine. Idempotent: re-calling a reverted session is a no-op.
          * @summary Revert (fully reverse) a settled Viva payment session
@@ -41214,14 +41470,14 @@ export const PaymentSessionApiFactory = function (configuration?: Configuration,
     const localVarFp = PaymentSessionApiFp(configuration)
     return {
         /**
-         * Arms cancelRequestedAt + aborts the Viva terminal session. Does not flip status — the webhook/sweep resolves the real outcome, and a late success is auto-voided. Viva card only.
-         * @summary Cancel an in-flight Viva payment session
+         * Arms cancelRequestedAt + aborts at the gateway (Viva session abort / Nets terminal cancelAction, dispatched on the session\'s provider). Does not flip status — the webhook/sweep resolves the real outcome; a late success parks at VOID_PENDING with a dev alert. Card sessions only.
+         * @summary Cancel an in-flight card payment session (Viva or Nets)
          * @param {string} clientToken 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
          */
-        cancelVivaSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto> {
-            return localVarFp.cancelVivaSession(clientToken, options).then((request) => request(axios, basePath));
+        cancelSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto> {
+            return localVarFp.cancelSession(clientToken, options).then((request) => request(axios, basePath));
         },
         /**
          * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
@@ -41233,6 +41489,17 @@ export const PaymentSessionApiFactory = function (configuration?: Configuration,
         getPaymentSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto> {
             return localVarFp.getPaymentSession(clientToken, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Creates a PaymentSession row, pushes the transaction to the station\'s Nets terminal (async — the result arrives via the Nets webhook), returns a client-facing token to poll. Idempotent via X-Idempotency-Key header.
+         * @summary Initiate a Nets terminal payment session
+         * @param {InitiateNetsSessionDto} initiateNetsSessionDto 
+         * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: any): AxiosPromise<InitiateNetsSessionResponseDto> {
+            return localVarFp.initiateNetsSession(initiateNetsSessionDto, xIdempotencyKey, options).then((request) => request(axios, basePath));
+        },
         /**
          * Builds the Viva app-to-app launch params (same as the legacy viva/a2a/create-payment) and persists a PaymentSession keyed by the Viva clientTransactionId, so the webhook + reconciliation own the order mutation. Returns the launch params plus a clientToken to poll the session.
          * @summary Initiate a Viva app-to-app payment session
@@ -41274,6 +41541,16 @@ export const PaymentSessionApiFactory = function (configuration?: Configuration,
         recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: any): AxiosPromise<RecordManualPaymentResultDto> {
             return localVarFp.recordManualPayment(createManualSessionDto, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Starts a terminal-present ReturnOfGoods on the station\'s Nets terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session (status INITIATED) — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
+         * @summary Refund a settled Nets payment session (gateway only, async)
+         * @param {ReverseSessionDto} reverseSessionDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto> {
+            return localVarFp.refundNetsSession(reverseSessionDto, options).then((request) => request(axios, basePath));
+        },
         /**
          * Refunds a Viva card payment at the gateway by its sessionId, optionally a partial `amount` (item / cluster refund). Validates the remaining refundable balance and supports multiple partial refunds. Does NOT write a reversal paymentEvent to the order — order-side accounting is handled by the refund plan. For a full reversal that writes the order paymentEvent, use /revert.
          * @summary Refund a settled Viva payment session (gateway only)
@@ -41284,6 +41561,16 @@ export const PaymentSessionApiFactory = function (configuration?: Configuration,
         refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto> {
             return localVarFp.refundVivaSession(reverseSessionDto, options).then((request) => request(axios, basePath));
         },
+        /**
+         * Starts a terminal-present ReturnOfGoods for the full remaining amount AND writes a reversal paymentEvent to the order once the refund settles (via reconciliation). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED.
+         * @summary Revert (fully reverse) a settled Nets payment session (async)
+         * @param {ReverseSessionDto} reverseSessionDto 
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<NetsRevertResponseDto> {
+            return localVarFp.revertNetsSession(reverseSessionDto, options).then((request) => request(axios, basePath));
+        },
         /**
          * Fully reverses a completed Viva card payment (SUCCESS / CLOSED) by its sessionId: refunds the full amount at the gateway AND writes a reversal paymentEvent to the order via the settlement engine. Idempotent: re-calling a reverted session is a no-op.
          * @summary Revert (fully reverse) a settled Viva payment session
@@ -41314,14 +41601,14 @@ export const PaymentSessionApiFactory = function (configuration?: Configuration,
  */
 export interface PaymentSessionApiInterface {
     /**
-     * Arms cancelRequestedAt + aborts the Viva terminal session. Does not flip status — the webhook/sweep resolves the real outcome, and a late success is auto-voided. Viva card only.
-     * @summary Cancel an in-flight Viva payment session
+     * Arms cancelRequestedAt + aborts at the gateway (Viva session abort / Nets terminal cancelAction, dispatched on the session\'s provider). Does not flip status — the webhook/sweep resolves the real outcome; a late success parks at VOID_PENDING with a dev alert. Card sessions only.
+     * @summary Cancel an in-flight card payment session (Viva or Nets)
      * @param {string} clientToken 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof PaymentSessionApiInterface
      */
-    cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
+    cancelSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
 
     /**
      * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
@@ -41333,6 +41620,17 @@ export interface PaymentSessionApiInterface {
      */
     getPaymentSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
 
+    /**
+     * Creates a PaymentSession row, pushes the transaction to the station\'s Nets terminal (async — the result arrives via the Nets webhook), returns a client-facing token to poll. Idempotent via X-Idempotency-Key header.
+     * @summary Initiate a Nets terminal payment session
+     * @param {InitiateNetsSessionDto} initiateNetsSessionDto 
+     * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApiInterface
+     */
+    initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): AxiosPromise<InitiateNetsSessionResponseDto>;
+
     /**
      * Builds the Viva app-to-app launch params (same as the legacy viva/a2a/create-payment) and persists a PaymentSession keyed by the Viva clientTransactionId, so the webhook + reconciliation own the order mutation. Returns the launch params plus a clientToken to poll the session.
      * @summary Initiate a Viva app-to-app payment session
@@ -41374,6 +41672,16 @@ export interface PaymentSessionApiInterface {
      */
     recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig): AxiosPromise<RecordManualPaymentResultDto>;
 
+    /**
+     * Starts a terminal-present ReturnOfGoods on the station\'s Nets terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session (status INITIATED) — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
+     * @summary Refund a settled Nets payment session (gateway only, async)
+     * @param {ReverseSessionDto} reverseSessionDto 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApiInterface
+     */
+    refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
+
     /**
      * Refunds a Viva card payment at the gateway by its sessionId, optionally a partial `amount` (item / cluster refund). Validates the remaining refundable balance and supports multiple partial refunds. Does NOT write a reversal paymentEvent to the order — order-side accounting is handled by the refund plan. For a full reversal that writes the order paymentEvent, use /revert.
      * @summary Refund a settled Viva payment session (gateway only)
@@ -41384,6 +41692,16 @@ export interface PaymentSessionApiInterface {
      */
     refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
 
+    /**
+     * Starts a terminal-present ReturnOfGoods for the full remaining amount AND writes a reversal paymentEvent to the order once the refund settles (via reconciliation). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED.
+     * @summary Revert (fully reverse) a settled Nets payment session (async)
+     * @param {ReverseSessionDto} reverseSessionDto 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApiInterface
+     */
+    revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<NetsRevertResponseDto>;
+
     /**
      * Fully reverses a completed Viva card payment (SUCCESS / CLOSED) by its sessionId: refunds the full amount at the gateway AND writes a reversal paymentEvent to the order via the settlement engine. Idempotent: re-calling a reverted session is a no-op.
      * @summary Revert (fully reverse) a settled Viva payment session
@@ -41414,15 +41732,15 @@ export interface PaymentSessionApiInterface {
  */
 export class PaymentSessionApi extends BaseAPI implements PaymentSessionApiInterface {
     /**
-     * Arms cancelRequestedAt + aborts the Viva terminal session. Does not flip status — the webhook/sweep resolves the real outcome, and a late success is auto-voided. Viva card only.
-     * @summary Cancel an in-flight Viva payment session
+     * Arms cancelRequestedAt + aborts at the gateway (Viva session abort / Nets terminal cancelAction, dispatched on the session\'s provider). Does not flip status — the webhook/sweep resolves the real outcome; a late success parks at VOID_PENDING with a dev alert. Card sessions only.
+     * @summary Cancel an in-flight card payment session (Viva or Nets)
      * @param {string} clientToken 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      * @memberof PaymentSessionApi
      */
-    public cancelVivaSession(clientToken: string, options?: AxiosRequestConfig) {
-        return PaymentSessionApiFp(this.configuration).cancelVivaSession(clientToken, options).then((request) => request(this.axios, this.basePath));
+    public cancelSession(clientToken: string, options?: AxiosRequestConfig) {
+        return PaymentSessionApiFp(this.configuration).cancelSession(clientToken, options).then((request) => request(this.axios, this.basePath));
     }
 
     /**
@@ -41437,6 +41755,19 @@ export class PaymentSessionApi extends BaseAPI implements PaymentSessionApiInter
         return PaymentSessionApiFp(this.configuration).getPaymentSession(clientToken, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Creates a PaymentSession row, pushes the transaction to the station\'s Nets terminal (async — the result arrives via the Nets webhook), returns a client-facing token to poll. Idempotent via X-Idempotency-Key header.
+     * @summary Initiate a Nets terminal payment session
+     * @param {InitiateNetsSessionDto} initiateNetsSessionDto 
+     * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApi
+     */
+    public initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig) {
+        return PaymentSessionApiFp(this.configuration).initiateNetsSession(initiateNetsSessionDto, xIdempotencyKey, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Builds the Viva app-to-app launch params (same as the legacy viva/a2a/create-payment) and persists a PaymentSession keyed by the Viva clientTransactionId, so the webhook + reconciliation own the order mutation. Returns the launch params plus a clientToken to poll the session.
      * @summary Initiate a Viva app-to-app payment session
@@ -41486,6 +41817,18 @@ export class PaymentSessionApi extends BaseAPI implements PaymentSessionApiInter
         return PaymentSessionApiFp(this.configuration).recordManualPayment(createManualSessionDto, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Starts a terminal-present ReturnOfGoods on the station\'s Nets terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session (status INITIATED) — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
+     * @summary Refund a settled Nets payment session (gateway only, async)
+     * @param {ReverseSessionDto} reverseSessionDto 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApi
+     */
+    public refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) {
+        return PaymentSessionApiFp(this.configuration).refundNetsSession(reverseSessionDto, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Refunds a Viva card payment at the gateway by its sessionId, optionally a partial `amount` (item / cluster refund). Validates the remaining refundable balance and supports multiple partial refunds. Does NOT write a reversal paymentEvent to the order — order-side accounting is handled by the refund plan. For a full reversal that writes the order paymentEvent, use /revert.
      * @summary Refund a settled Viva payment session (gateway only)
@@ -41498,6 +41841,18 @@ export class PaymentSessionApi extends BaseAPI implements PaymentSessionApiInter
         return PaymentSessionApiFp(this.configuration).refundVivaSession(reverseSessionDto, options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Starts a terminal-present ReturnOfGoods for the full remaining amount AND writes a reversal paymentEvent to the order once the refund settles (via reconciliation). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED.
+     * @summary Revert (fully reverse) a settled Nets payment session (async)
+     * @param {ReverseSessionDto} reverseSessionDto 
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApi
+     */
+    public revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) {
+        return PaymentSessionApiFp(this.configuration).revertNetsSession(reverseSessionDto, options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * Fully reverses a completed Viva card payment (SUCCESS / CLOSED) by its sessionId: refunds the full amount at the gateway AND writes a reversal paymentEvent to the order via the settlement engine. Idempotent: re-calling a reverted session is a no-op.
      * @summary Revert (fully reverse) a settled Viva payment session
@@ -46666,6 +47021,36 @@ export const WebhookApiAxiosParamCreator = function (configuration?: Configurati
 
 
     
+            setSearchParams(localVarUrlObj, localVarQueryParameter);
+            let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
+            localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
+
+            return {
+                url: toPathString(localVarUrlObj),
+                options: localVarRequestOptions,
+            };
+        },
+        /**
+         * Per-transaction callback registered at initiate (ConnectCloud-Webhook-Address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. Legacy /nets and /v2/nets stay untouched.
+         * @summary Handle Nets webhook events for the payment-session flow
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        handleNetsSessionEvents: async (options: AxiosRequestConfig = {}): Promise<RequestArgs> => {
+            const localVarPath = `/api/webhook/nets/payments`;
+            // use dummy base URL string because the URL constructor only accepts absolute URLs.
+            const localVarUrlObj = new URL(localVarPath, DUMMY_BASE_URL);
+            let baseOptions;
+            if (configuration) {
+                baseOptions = configuration.baseOptions;
+            }
+
+            const localVarRequestOptions = { method: 'POST', ...baseOptions, ...options};
+            const localVarHeaderParameter = {} as any;
+            const localVarQueryParameter = {} as any;
+
+
+    
             setSearchParams(localVarUrlObj, localVarQueryParameter);
             let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
             localVarRequestOptions.headers = {...localVarHeaderParameter, ...headersFromBaseOptions, ...options.headers};
@@ -46806,7 +47191,7 @@ export const WebhookApiAxiosParamCreator = function (configuration?: Configurati
             };
         },
         /**
-         * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
+         * Shared dispatcher: session-backed Viva events -> PaymentSession update + reconciliation, others -> legacy flow. Both /viva/verification and /viva/payments resolve to the same dispatcher so Viva may deliver to either URL.
          * @summary Handle Viva webhook events for the payment-session flow
          * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto 
          * @param {*} [options] Override http request option.
@@ -47151,6 +47536,16 @@ export const WebhookApiFp = function(configuration?: Configuration) {
             const localVarAxiosArgs = await localVarAxiosParamCreator.handleNetsEventsV2(options);
             return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
         },
+        /**
+         * Per-transaction callback registered at initiate (ConnectCloud-Webhook-Address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. Legacy /nets and /v2/nets stay untouched.
+         * @summary Handle Nets webhook events for the payment-session flow
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        async handleNetsSessionEvents(options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>> {
+            const localVarAxiosArgs = await localVarAxiosParamCreator.handleNetsSessionEvents(options);
+            return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
+        },
         /**
          * 
          * @summary Handle preorder reminder (triggered by scheduler)
@@ -47192,7 +47587,7 @@ export const WebhookApiFp = function(configuration?: Configuration) {
             return createRequestFunction(localVarAxiosArgs, globalAxios, BASE_PATH, configuration);
         },
         /**
-         * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
+         * Shared dispatcher: session-backed Viva events -> PaymentSession update + reconciliation, others -> legacy flow. Both /viva/verification and /viva/payments resolve to the same dispatcher so Viva may deliver to either URL.
          * @summary Handle Viva webhook events for the payment-session flow
          * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto 
          * @param {*} [options] Override http request option.
@@ -47338,6 +47733,15 @@ export const WebhookApiFactory = function (configuration?: Configuration, basePa
         handleNetsEventsV2(options?: any): AxiosPromise<void> {
             return localVarFp.handleNetsEventsV2(options).then((request) => request(axios, basePath));
         },
+        /**
+         * Per-transaction callback registered at initiate (ConnectCloud-Webhook-Address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. Legacy /nets and /v2/nets stay untouched.
+         * @summary Handle Nets webhook events for the payment-session flow
+         * @param {*} [options] Override http request option.
+         * @throws {RequiredError}
+         */
+        handleNetsSessionEvents(options?: any): AxiosPromise<void> {
+            return localVarFp.handleNetsSessionEvents(options).then((request) => request(axios, basePath));
+        },
         /**
          * 
          * @summary Handle preorder reminder (triggered by scheduler)
@@ -47375,7 +47779,7 @@ export const WebhookApiFactory = function (configuration?: Configuration, basePa
             return localVarFp.handleVivaEvents(vivaWebhookPayloadDto, options).then((request) => request(axios, basePath));
         },
         /**
-         * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
+         * Shared dispatcher: session-backed Viva events -> PaymentSession update + reconciliation, others -> legacy flow. Both /viva/verification and /viva/payments resolve to the same dispatcher so Viva may deliver to either URL.
          * @summary Handle Viva webhook events for the payment-session flow
          * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto 
          * @param {*} [options] Override http request option.
@@ -47511,6 +47915,15 @@ export interface WebhookApiInterface {
      */
     handleNetsEventsV2(options?: AxiosRequestConfig): AxiosPromise<void>;
 
+    /**
+     * Per-transaction callback registered at initiate (ConnectCloud-Webhook-Address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. Legacy /nets and /v2/nets stay untouched.
+     * @summary Handle Nets webhook events for the payment-session flow
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WebhookApiInterface
+     */
+    handleNetsSessionEvents(options?: AxiosRequestConfig): AxiosPromise<void>;
+
     /**
      * 
      * @summary Handle preorder reminder (triggered by scheduler)
@@ -47548,7 +47961,7 @@ export interface WebhookApiInterface {
     handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig): AxiosPromise<void>;
 
     /**
-     * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
+     * Shared dispatcher: session-backed Viva events -> PaymentSession update + reconciliation, others -> legacy flow. Both /viva/verification and /viva/payments resolve to the same dispatcher so Viva may deliver to either URL.
      * @summary Handle Viva webhook events for the payment-session flow
      * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto 
      * @param {*} [options] Override http request option.
@@ -47696,6 +48109,17 @@ export class WebhookApi extends BaseAPI implements WebhookApiInterface {
         return WebhookApiFp(this.configuration).handleNetsEventsV2(options).then((request) => request(this.axios, this.basePath));
     }
 
+    /**
+     * Per-transaction callback registered at initiate (ConnectCloud-Webhook-Address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. Legacy /nets and /v2/nets stay untouched.
+     * @summary Handle Nets webhook events for the payment-session flow
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof WebhookApi
+     */
+    public handleNetsSessionEvents(options?: AxiosRequestConfig) {
+        return WebhookApiFp(this.configuration).handleNetsSessionEvents(options).then((request) => request(this.axios, this.basePath));
+    }
+
     /**
      * 
      * @summary Handle preorder reminder (triggered by scheduler)
@@ -47741,7 +48165,7 @@ export class WebhookApi extends BaseAPI implements WebhookApiInterface {
     }
 
     /**
-     * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
+     * Shared dispatcher: session-backed Viva events -> PaymentSession update + reconciliation, others -> legacy flow. Both /viva/verification and /viva/payments resolve to the same dispatcher so Viva may deliver to either URL.
      * @summary Handle Viva webhook events for the payment-session flow
      * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto 
      * @param {*} [options] Override http request option.