@munchi_oy/core 1.9.73 → 1.9.74

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -6465,6 +6465,56 @@ export interface ImageBackgroundConfig {
6465
6465
  */
6466
6466
  'blurRadius'?: number;
6467
6467
  }
6468
+ /**
6469
+ *
6470
+ * @export
6471
+ * @interface InitiateNetsSessionDto
6472
+ */
6473
+ export interface InitiateNetsSessionDto {
6474
+ /**
6475
+ * The internal business ID.
6476
+ * @type {number}
6477
+ * @memberof InitiateNetsSessionDto
6478
+ */
6479
+ 'businessId': number;
6480
+ /**
6481
+ * The POS order ID this payment session is for.
6482
+ * @type {string}
6483
+ * @memberof InitiateNetsSessionDto
6484
+ */
6485
+ 'orderId': string;
6486
+ /**
6487
+ * Amount to charge in smallest currency unit (cents).
6488
+ * @type {number}
6489
+ * @memberof InitiateNetsSessionDto
6490
+ */
6491
+ 'amount': number;
6492
+ /**
6493
+ *
6494
+ * @type {InitiateVivaSessionDtoSplitContext}
6495
+ * @memberof InitiateNetsSessionDto
6496
+ */
6497
+ 'splitContext'?: InitiateVivaSessionDtoSplitContext;
6498
+ }
6499
+ /**
6500
+ *
6501
+ * @export
6502
+ * @interface InitiateNetsSessionResponseDto
6503
+ */
6504
+ export interface InitiateNetsSessionResponseDto {
6505
+ /**
6506
+ * Opaque token returned to the client. Used by the client to poll/sync the session. Never sent to Nets.
6507
+ * @type {string}
6508
+ * @memberof InitiateNetsSessionResponseDto
6509
+ */
6510
+ 'clientToken': string;
6511
+ /**
6512
+ * Internal session ID — the Nets ConnectCloud request id the webhook resolves against.
6513
+ * @type {string}
6514
+ * @memberof InitiateNetsSessionResponseDto
6515
+ */
6516
+ 'sessionId': string;
6517
+ }
6468
6518
  /**
6469
6519
  *
6470
6520
  * @export
@@ -9871,6 +9921,59 @@ export interface NetsPaymentMessageDtoData {
9871
9921
  */
9872
9922
  'storeboxToken'?: string;
9873
9923
  }
9924
+ /**
9925
+ *
9926
+ * @export
9927
+ * @enum {string}
9928
+ */
9929
+ export declare const NetsRevertMethod: {
9930
+ readonly Reversal: "REVERSAL";
9931
+ readonly Refund: "REFUND";
9932
+ };
9933
+ export type NetsRevertMethod = typeof NetsRevertMethod[keyof typeof NetsRevertMethod];
9934
+ /**
9935
+ *
9936
+ * @export
9937
+ * @interface NetsRevertResponseDto
9938
+ */
9939
+ export interface NetsRevertResponseDto {
9940
+ /**
9941
+ *
9942
+ * @type {NetsRevertMethod}
9943
+ * @memberof NetsRevertResponseDto
9944
+ */
9945
+ 'method': NetsRevertMethod;
9946
+ /**
9947
+ * True when the customer must tap their card to complete (REFUND); false for a REVERSAL, which settles without a tap.
9948
+ * @type {boolean}
9949
+ * @memberof NetsRevertResponseDto
9950
+ */
9951
+ 'requiresCardTap': boolean;
9952
+ /**
9953
+ * Opaque token to poll GET /payment-session/:clientToken for the final outcome.
9954
+ * @type {string}
9955
+ * @memberof NetsRevertResponseDto
9956
+ */
9957
+ 'clientToken': string;
9958
+ /**
9959
+ * Internal session id — the Nets connectcloud-request-id the webhook resolves against.
9960
+ * @type {string}
9961
+ * @memberof NetsRevertResponseDto
9962
+ */
9963
+ 'sessionId': string;
9964
+ /**
9965
+ * Amount being reverted, in the smallest currency unit (cents).
9966
+ * @type {number}
9967
+ * @memberof NetsRevertResponseDto
9968
+ */
9969
+ 'amount': number;
9970
+ /**
9971
+ *
9972
+ * @type {PaymentSessionStatus}
9973
+ * @memberof NetsRevertResponseDto
9974
+ */
9975
+ 'status': PaymentSessionStatus;
9976
+ }
9874
9977
  /**
9875
9978
  *
9876
9979
  * @export
@@ -32883,13 +32986,13 @@ export declare class PaymentMethodsApi extends BaseAPI implements PaymentMethods
32883
32986
  */
32884
32987
  export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Configuration) => {
32885
32988
  /**
32886
- * 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.
32887
- * @summary Cancel an in-flight Viva payment session
32989
+ * 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.
32990
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
32888
32991
  * @param {string} clientToken
32889
32992
  * @param {*} [options] Override http request option.
32890
32993
  * @throws {RequiredError}
32891
32994
  */
32892
- cancelVivaSession: (clientToken: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32995
+ cancelSession: (clientToken: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32893
32996
  /**
32894
32997
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
32895
32998
  * @summary Get payment session status by clientToken
@@ -32898,6 +33001,15 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32898
33001
  * @throws {RequiredError}
32899
33002
  */
32900
33003
  getPaymentSession: (clientToken: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33004
+ /**
33005
+ * 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.
33006
+ * @summary Initiate a Nets terminal payment session
33007
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33008
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33009
+ * @param {*} [options] Override http request option.
33010
+ * @throws {RequiredError}
33011
+ */
33012
+ initiateNetsSession: (initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32901
33013
  /**
32902
33014
  * 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.
32903
33015
  * @summary Initiate a Viva app-to-app payment session
@@ -32931,6 +33043,14 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32931
33043
  * @throws {RequiredError}
32932
33044
  */
32933
33045
  recordManualPayment: (createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33046
+ /**
33047
+ * 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.
33048
+ * @summary Refund a settled Nets payment session (gateway only, async)
33049
+ * @param {ReverseSessionDto} reverseSessionDto
33050
+ * @param {*} [options] Override http request option.
33051
+ * @throws {RequiredError}
33052
+ */
33053
+ refundNetsSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32934
33054
  /**
32935
33055
  * 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.
32936
33056
  * @summary Refund a settled Viva payment session (gateway only)
@@ -32939,6 +33059,14 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32939
33059
  * @throws {RequiredError}
32940
33060
  */
32941
33061
  refundVivaSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33062
+ /**
33063
+ * 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.
33064
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33065
+ * @param {ReverseSessionDto} reverseSessionDto
33066
+ * @param {*} [options] Override http request option.
33067
+ * @throws {RequiredError}
33068
+ */
33069
+ revertNetsSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32942
33070
  /**
32943
33071
  * 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.
32944
33072
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -32962,13 +33090,13 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32962
33090
  */
32963
33091
  export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
32964
33092
  /**
32965
- * 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.
32966
- * @summary Cancel an in-flight Viva payment session
33093
+ * 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.
33094
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
32967
33095
  * @param {string} clientToken
32968
33096
  * @param {*} [options] Override http request option.
32969
33097
  * @throws {RequiredError}
32970
33098
  */
32971
- cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33099
+ cancelSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
32972
33100
  /**
32973
33101
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
32974
33102
  * @summary Get payment session status by clientToken
@@ -32977,6 +33105,15 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
32977
33105
  * @throws {RequiredError}
32978
33106
  */
32979
33107
  getPaymentSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33108
+ /**
33109
+ * 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.
33110
+ * @summary Initiate a Nets terminal payment session
33111
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33112
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33113
+ * @param {*} [options] Override http request option.
33114
+ * @throws {RequiredError}
33115
+ */
33116
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InitiateNetsSessionResponseDto>>;
32980
33117
  /**
32981
33118
  * 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.
32982
33119
  * @summary Initiate a Viva app-to-app payment session
@@ -33010,6 +33147,14 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33010
33147
  * @throws {RequiredError}
33011
33148
  */
33012
33149
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<RecordManualPaymentResultDto>>;
33150
+ /**
33151
+ * 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.
33152
+ * @summary Refund a settled Nets payment session (gateway only, async)
33153
+ * @param {ReverseSessionDto} reverseSessionDto
33154
+ * @param {*} [options] Override http request option.
33155
+ * @throws {RequiredError}
33156
+ */
33157
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33013
33158
  /**
33014
33159
  * 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.
33015
33160
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33018,6 +33163,14 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33018
33163
  * @throws {RequiredError}
33019
33164
  */
33020
33165
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33166
+ /**
33167
+ * 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.
33168
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33169
+ * @param {ReverseSessionDto} reverseSessionDto
33170
+ * @param {*} [options] Override http request option.
33171
+ * @throws {RequiredError}
33172
+ */
33173
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NetsRevertResponseDto>>;
33021
33174
  /**
33022
33175
  * 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.
33023
33176
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -33041,13 +33194,13 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33041
33194
  */
33042
33195
  export declare const PaymentSessionApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
33043
33196
  /**
33044
- * 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.
33045
- * @summary Cancel an in-flight Viva payment session
33197
+ * 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.
33198
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
33046
33199
  * @param {string} clientToken
33047
33200
  * @param {*} [options] Override http request option.
33048
33201
  * @throws {RequiredError}
33049
33202
  */
33050
- cancelVivaSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto>;
33203
+ cancelSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto>;
33051
33204
  /**
33052
33205
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
33053
33206
  * @summary Get payment session status by clientToken
@@ -33056,6 +33209,15 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33056
33209
  * @throws {RequiredError}
33057
33210
  */
33058
33211
  getPaymentSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto>;
33212
+ /**
33213
+ * 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.
33214
+ * @summary Initiate a Nets terminal payment session
33215
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33216
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33217
+ * @param {*} [options] Override http request option.
33218
+ * @throws {RequiredError}
33219
+ */
33220
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: any): AxiosPromise<InitiateNetsSessionResponseDto>;
33059
33221
  /**
33060
33222
  * 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.
33061
33223
  * @summary Initiate a Viva app-to-app payment session
@@ -33089,6 +33251,14 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33089
33251
  * @throws {RequiredError}
33090
33252
  */
33091
33253
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: any): AxiosPromise<RecordManualPaymentResultDto>;
33254
+ /**
33255
+ * 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.
33256
+ * @summary Refund a settled Nets payment session (gateway only, async)
33257
+ * @param {ReverseSessionDto} reverseSessionDto
33258
+ * @param {*} [options] Override http request option.
33259
+ * @throws {RequiredError}
33260
+ */
33261
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto>;
33092
33262
  /**
33093
33263
  * 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.
33094
33264
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33097,6 +33267,14 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33097
33267
  * @throws {RequiredError}
33098
33268
  */
33099
33269
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto>;
33270
+ /**
33271
+ * 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.
33272
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33273
+ * @param {ReverseSessionDto} reverseSessionDto
33274
+ * @param {*} [options] Override http request option.
33275
+ * @throws {RequiredError}
33276
+ */
33277
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<NetsRevertResponseDto>;
33100
33278
  /**
33101
33279
  * 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.
33102
33280
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -33121,14 +33299,14 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33121
33299
  */
33122
33300
  export interface PaymentSessionApiInterface {
33123
33301
  /**
33124
- * 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.
33125
- * @summary Cancel an in-flight Viva payment session
33302
+ * 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.
33303
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
33126
33304
  * @param {string} clientToken
33127
33305
  * @param {*} [options] Override http request option.
33128
33306
  * @throws {RequiredError}
33129
33307
  * @memberof PaymentSessionApiInterface
33130
33308
  */
33131
- cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33309
+ cancelSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33132
33310
  /**
33133
33311
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
33134
33312
  * @summary Get payment session status by clientToken
@@ -33138,6 +33316,16 @@ export interface PaymentSessionApiInterface {
33138
33316
  * @memberof PaymentSessionApiInterface
33139
33317
  */
33140
33318
  getPaymentSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33319
+ /**
33320
+ * 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.
33321
+ * @summary Initiate a Nets terminal payment session
33322
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33323
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33324
+ * @param {*} [options] Override http request option.
33325
+ * @throws {RequiredError}
33326
+ * @memberof PaymentSessionApiInterface
33327
+ */
33328
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): AxiosPromise<InitiateNetsSessionResponseDto>;
33141
33329
  /**
33142
33330
  * 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.
33143
33331
  * @summary Initiate a Viva app-to-app payment session
@@ -33175,6 +33363,15 @@ export interface PaymentSessionApiInterface {
33175
33363
  * @memberof PaymentSessionApiInterface
33176
33364
  */
33177
33365
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig): AxiosPromise<RecordManualPaymentResultDto>;
33366
+ /**
33367
+ * 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.
33368
+ * @summary Refund a settled Nets payment session (gateway only, async)
33369
+ * @param {ReverseSessionDto} reverseSessionDto
33370
+ * @param {*} [options] Override http request option.
33371
+ * @throws {RequiredError}
33372
+ * @memberof PaymentSessionApiInterface
33373
+ */
33374
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33178
33375
  /**
33179
33376
  * 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.
33180
33377
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33184,6 +33381,15 @@ export interface PaymentSessionApiInterface {
33184
33381
  * @memberof PaymentSessionApiInterface
33185
33382
  */
33186
33383
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33384
+ /**
33385
+ * 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.
33386
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33387
+ * @param {ReverseSessionDto} reverseSessionDto
33388
+ * @param {*} [options] Override http request option.
33389
+ * @throws {RequiredError}
33390
+ * @memberof PaymentSessionApiInterface
33391
+ */
33392
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<NetsRevertResponseDto>;
33187
33393
  /**
33188
33394
  * 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.
33189
33395
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -33211,14 +33417,14 @@ export interface PaymentSessionApiInterface {
33211
33417
  */
33212
33418
  export declare class PaymentSessionApi extends BaseAPI implements PaymentSessionApiInterface {
33213
33419
  /**
33214
- * 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.
33215
- * @summary Cancel an in-flight Viva payment session
33420
+ * 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.
33421
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
33216
33422
  * @param {string} clientToken
33217
33423
  * @param {*} [options] Override http request option.
33218
33424
  * @throws {RequiredError}
33219
33425
  * @memberof PaymentSessionApi
33220
33426
  */
33221
- cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33427
+ cancelSession(clientToken: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33222
33428
  /**
33223
33429
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
33224
33430
  * @summary Get payment session status by clientToken
@@ -33228,6 +33434,16 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33228
33434
  * @memberof PaymentSessionApi
33229
33435
  */
33230
33436
  getPaymentSession(clientToken: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33437
+ /**
33438
+ * 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.
33439
+ * @summary Initiate a Nets terminal payment session
33440
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33441
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33442
+ * @param {*} [options] Override http request option.
33443
+ * @throws {RequiredError}
33444
+ * @memberof PaymentSessionApi
33445
+ */
33446
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<InitiateNetsSessionResponseDto, any, {}>>;
33231
33447
  /**
33232
33448
  * 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.
33233
33449
  * @summary Initiate a Viva app-to-app payment session
@@ -33265,6 +33481,15 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33265
33481
  * @memberof PaymentSessionApi
33266
33482
  */
33267
33483
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<RecordManualPaymentResultDto, any, {}>>;
33484
+ /**
33485
+ * 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.
33486
+ * @summary Refund a settled Nets payment session (gateway only, async)
33487
+ * @param {ReverseSessionDto} reverseSessionDto
33488
+ * @param {*} [options] Override http request option.
33489
+ * @throws {RequiredError}
33490
+ * @memberof PaymentSessionApi
33491
+ */
33492
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33268
33493
  /**
33269
33494
  * 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.
33270
33495
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33274,6 +33499,15 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33274
33499
  * @memberof PaymentSessionApi
33275
33500
  */
33276
33501
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33502
+ /**
33503
+ * 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.
33504
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33505
+ * @param {ReverseSessionDto} reverseSessionDto
33506
+ * @param {*} [options] Override http request option.
33507
+ * @throws {RequiredError}
33508
+ * @memberof PaymentSessionApi
33509
+ */
33510
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<NetsRevertResponseDto, any, {}>>;
33277
33511
  /**
33278
33512
  * 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.
33279
33513
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -36031,6 +36265,13 @@ export declare const WebhookApiAxiosParamCreator: (configuration?: Configuration
36031
36265
  * @throws {RequiredError}
36032
36266
  */
36033
36267
  handleNetsEventsV2: (options?: AxiosRequestConfig) => Promise<RequestArgs>;
36268
+ /**
36269
+ * 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.
36270
+ * @summary Handle Nets webhook events for the payment-session flow
36271
+ * @param {*} [options] Override http request option.
36272
+ * @throws {RequiredError}
36273
+ */
36274
+ handleNetsSessionEvents: (options?: AxiosRequestConfig) => Promise<RequestArgs>;
36034
36275
  /**
36035
36276
  *
36036
36277
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36060,7 +36301,7 @@ export declare const WebhookApiAxiosParamCreator: (configuration?: Configuration
36060
36301
  */
36061
36302
  handleVivaEvents: (vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
36062
36303
  /**
36063
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36304
+ * 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.
36064
36305
  * @summary Handle Viva webhook events for the payment-session flow
36065
36306
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36066
36307
  * @param {*} [options] Override http request option.
@@ -36163,6 +36404,13 @@ export declare const WebhookApiFp: (configuration?: Configuration) => {
36163
36404
  * @throws {RequiredError}
36164
36405
  */
36165
36406
  handleNetsEventsV2(options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36407
+ /**
36408
+ * 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.
36409
+ * @summary Handle Nets webhook events for the payment-session flow
36410
+ * @param {*} [options] Override http request option.
36411
+ * @throws {RequiredError}
36412
+ */
36413
+ handleNetsSessionEvents(options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36166
36414
  /**
36167
36415
  *
36168
36416
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36192,7 +36440,7 @@ export declare const WebhookApiFp: (configuration?: Configuration) => {
36192
36440
  */
36193
36441
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36194
36442
  /**
36195
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36443
+ * 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.
36196
36444
  * @summary Handle Viva webhook events for the payment-session flow
36197
36445
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36198
36446
  * @param {*} [options] Override http request option.
@@ -36295,6 +36543,13 @@ export declare const WebhookApiFactory: (configuration?: Configuration, basePath
36295
36543
  * @throws {RequiredError}
36296
36544
  */
36297
36545
  handleNetsEventsV2(options?: any): AxiosPromise<void>;
36546
+ /**
36547
+ * 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.
36548
+ * @summary Handle Nets webhook events for the payment-session flow
36549
+ * @param {*} [options] Override http request option.
36550
+ * @throws {RequiredError}
36551
+ */
36552
+ handleNetsSessionEvents(options?: any): AxiosPromise<void>;
36298
36553
  /**
36299
36554
  *
36300
36555
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36324,7 +36579,7 @@ export declare const WebhookApiFactory: (configuration?: Configuration, basePath
36324
36579
  */
36325
36580
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: any): AxiosPromise<void>;
36326
36581
  /**
36327
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36582
+ * 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.
36328
36583
  * @summary Handle Viva webhook events for the payment-session flow
36329
36584
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36330
36585
  * @param {*} [options] Override http request option.
@@ -36434,6 +36689,14 @@ export interface WebhookApiInterface {
36434
36689
  * @memberof WebhookApiInterface
36435
36690
  */
36436
36691
  handleNetsEventsV2(options?: AxiosRequestConfig): AxiosPromise<void>;
36692
+ /**
36693
+ * 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.
36694
+ * @summary Handle Nets webhook events for the payment-session flow
36695
+ * @param {*} [options] Override http request option.
36696
+ * @throws {RequiredError}
36697
+ * @memberof WebhookApiInterface
36698
+ */
36699
+ handleNetsSessionEvents(options?: AxiosRequestConfig): AxiosPromise<void>;
36437
36700
  /**
36438
36701
  *
36439
36702
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36467,7 +36730,7 @@ export interface WebhookApiInterface {
36467
36730
  */
36468
36731
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig): AxiosPromise<void>;
36469
36732
  /**
36470
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36733
+ * 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.
36471
36734
  * @summary Handle Viva webhook events for the payment-session flow
36472
36735
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36473
36736
  * @param {*} [options] Override http request option.
@@ -36587,6 +36850,14 @@ export declare class WebhookApi extends BaseAPI implements WebhookApiInterface {
36587
36850
  * @memberof WebhookApi
36588
36851
  */
36589
36852
  handleNetsEventsV2(options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
36853
+ /**
36854
+ * 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.
36855
+ * @summary Handle Nets webhook events for the payment-session flow
36856
+ * @param {*} [options] Override http request option.
36857
+ * @throws {RequiredError}
36858
+ * @memberof WebhookApi
36859
+ */
36860
+ handleNetsSessionEvents(options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
36590
36861
  /**
36591
36862
  *
36592
36863
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36620,7 +36891,7 @@ export declare class WebhookApi extends BaseAPI implements WebhookApiInterface {
36620
36891
  */
36621
36892
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
36622
36893
  /**
36623
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36894
+ * 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.
36624
36895
  * @summary Handle Viva webhook events for the payment-session flow
36625
36896
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36626
36897
  * @param {*} [options] Override http request option.