@munchi_oy/core 1.9.73 → 1.9.75

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.
@@ -3556,10 +3556,10 @@ export interface CreateManualSessionDto {
3556
3556
  'tipAmount'?: number;
3557
3557
  /**
3558
3558
  *
3559
- * @type {InitiateVivaSessionDtoSplitContext}
3559
+ * @type {CreateManualSessionDtoSplitContext}
3560
3560
  * @memberof CreateManualSessionDto
3561
3561
  */
3562
- 'splitContext'?: InitiateVivaSessionDtoSplitContext;
3562
+ 'splitContext'?: CreateManualSessionDtoSplitContext;
3563
3563
  /**
3564
3564
  * 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.
3565
3565
  * @type {object}
@@ -3814,6 +3814,31 @@ export interface CreateManualSessionDtoOrder {
3814
3814
  */
3815
3815
  'tableGroupId'?: string | null;
3816
3816
  }
3817
+ /**
3818
+ * Split context. Omit for a full-cart payment, or send { mode, partId|seatId } for a split. Must match the order\'s checkoutModel.
3819
+ * @export
3820
+ * @interface CreateManualSessionDtoSplitContext
3821
+ */
3822
+ export interface CreateManualSessionDtoSplitContext {
3823
+ /**
3824
+ *
3825
+ * @type {CheckoutModelEnum}
3826
+ * @memberof CreateManualSessionDtoSplitContext
3827
+ */
3828
+ 'mode': CheckoutModelEnum;
3829
+ /**
3830
+ * Equal-split part id. Required when mode=EQUAL_SPLIT; ignored otherwise.
3831
+ * @type {string}
3832
+ * @memberof CreateManualSessionDtoSplitContext
3833
+ */
3834
+ 'partId'?: string;
3835
+ /**
3836
+ * Item-split seat id. Required when mode=ITEM_SPLIT; ignored otherwise.
3837
+ * @type {string}
3838
+ * @memberof CreateManualSessionDtoSplitContext
3839
+ */
3840
+ 'seatId'?: string;
3841
+ }
3817
3842
  /**
3818
3843
  *
3819
3844
  * @export
@@ -6465,6 +6490,56 @@ export interface ImageBackgroundConfig {
6465
6490
  */
6466
6491
  'blurRadius'?: number;
6467
6492
  }
6493
+ /**
6494
+ *
6495
+ * @export
6496
+ * @interface InitiateNetsSessionDto
6497
+ */
6498
+ export interface InitiateNetsSessionDto {
6499
+ /**
6500
+ * The internal business ID.
6501
+ * @type {number}
6502
+ * @memberof InitiateNetsSessionDto
6503
+ */
6504
+ 'businessId': number;
6505
+ /**
6506
+ * The POS order ID this payment session is for.
6507
+ * @type {string}
6508
+ * @memberof InitiateNetsSessionDto
6509
+ */
6510
+ 'orderId': string;
6511
+ /**
6512
+ * Amount to charge in smallest currency unit (cents).
6513
+ * @type {number}
6514
+ * @memberof InitiateNetsSessionDto
6515
+ */
6516
+ 'amount': number;
6517
+ /**
6518
+ *
6519
+ * @type {CreateManualSessionDtoSplitContext}
6520
+ * @memberof InitiateNetsSessionDto
6521
+ */
6522
+ 'splitContext'?: CreateManualSessionDtoSplitContext;
6523
+ }
6524
+ /**
6525
+ *
6526
+ * @export
6527
+ * @interface InitiateNetsSessionResponseDto
6528
+ */
6529
+ export interface InitiateNetsSessionResponseDto {
6530
+ /**
6531
+ * Opaque token returned to the client. Used by the client to poll/sync the session. Never sent to Nets.
6532
+ * @type {string}
6533
+ * @memberof InitiateNetsSessionResponseDto
6534
+ */
6535
+ 'clientToken': string;
6536
+ /**
6537
+ * Internal session ID — the Nets ConnectCloud request id the webhook resolves against.
6538
+ * @type {string}
6539
+ * @memberof InitiateNetsSessionResponseDto
6540
+ */
6541
+ 'sessionId': string;
6542
+ }
6468
6543
  /**
6469
6544
  *
6470
6545
  * @export
@@ -6534,10 +6609,10 @@ export interface InitiateVivaA2aSessionDto {
6534
6609
  'showTransactionResult'?: boolean;
6535
6610
  /**
6536
6611
  *
6537
- * @type {InitiateVivaSessionDtoSplitContext}
6612
+ * @type {CreateManualSessionDtoSplitContext}
6538
6613
  * @memberof InitiateVivaA2aSessionDto
6539
6614
  */
6540
- 'splitContext'?: InitiateVivaSessionDtoSplitContext;
6615
+ 'splitContext'?: CreateManualSessionDtoSplitContext;
6541
6616
  }
6542
6617
  /**
6543
6618
  *
@@ -6674,35 +6749,10 @@ export interface InitiateVivaSessionDto {
6674
6749
  'amount': number;
6675
6750
  /**
6676
6751
  *
6677
- * @type {InitiateVivaSessionDtoSplitContext}
6752
+ * @type {CreateManualSessionDtoSplitContext}
6678
6753
  * @memberof InitiateVivaSessionDto
6679
6754
  */
6680
- 'splitContext'?: InitiateVivaSessionDtoSplitContext;
6681
- }
6682
- /**
6683
- * Split context. Omit for a full-cart payment, or send { mode, partId|seatId } for a split. Must match the order\'s checkoutModel.
6684
- * @export
6685
- * @interface InitiateVivaSessionDtoSplitContext
6686
- */
6687
- export interface InitiateVivaSessionDtoSplitContext {
6688
- /**
6689
- *
6690
- * @type {CheckoutModelEnum}
6691
- * @memberof InitiateVivaSessionDtoSplitContext
6692
- */
6693
- 'mode': CheckoutModelEnum;
6694
- /**
6695
- * Equal-split part id. Required when mode=EQUAL_SPLIT; ignored otherwise.
6696
- * @type {string}
6697
- * @memberof InitiateVivaSessionDtoSplitContext
6698
- */
6699
- 'partId'?: string;
6700
- /**
6701
- * Item-split seat id. Required when mode=ITEM_SPLIT; ignored otherwise.
6702
- * @type {string}
6703
- * @memberof InitiateVivaSessionDtoSplitContext
6704
- */
6705
- 'seatId'?: string;
6755
+ 'splitContext'?: CreateManualSessionDtoSplitContext;
6706
6756
  }
6707
6757
  /**
6708
6758
  *
@@ -6814,6 +6864,74 @@ export interface InitiateVivaSessionResponseDtoVivaIntent {
6814
6864
  */
6815
6865
  'skipSurcharge': boolean;
6816
6866
  }
6867
+ /**
6868
+ *
6869
+ * @export
6870
+ * @interface InitiateWorldlineSessionDto
6871
+ */
6872
+ export interface InitiateWorldlineSessionDto {
6873
+ /**
6874
+ * The internal business ID.
6875
+ * @type {number}
6876
+ * @memberof InitiateWorldlineSessionDto
6877
+ */
6878
+ 'businessId': number;
6879
+ /**
6880
+ * The POS order ID this payment session is for.
6881
+ * @type {string}
6882
+ * @memberof InitiateWorldlineSessionDto
6883
+ */
6884
+ 'orderId': string;
6885
+ /**
6886
+ * Amount to charge in smallest currency unit (cents).
6887
+ * @type {number}
6888
+ * @memberof InitiateWorldlineSessionDto
6889
+ */
6890
+ 'amount': number;
6891
+ /**
6892
+ * Optional tip amount in the smallest currency unit (cents).
6893
+ * @type {number}
6894
+ * @memberof InitiateWorldlineSessionDto
6895
+ */
6896
+ 'tipAmount'?: number;
6897
+ /**
6898
+ * Whether the terminal should print the customer receipt.
6899
+ * @type {boolean}
6900
+ * @memberof InitiateWorldlineSessionDto
6901
+ */
6902
+ 'showReceipt'?: boolean;
6903
+ /**
6904
+ *
6905
+ * @type {CreateManualSessionDtoSplitContext}
6906
+ * @memberof InitiateWorldlineSessionDto
6907
+ */
6908
+ 'splitContext'?: CreateManualSessionDtoSplitContext;
6909
+ }
6910
+ /**
6911
+ *
6912
+ * @export
6913
+ * @interface InitiateWorldlineSessionResponseDto
6914
+ */
6915
+ export interface InitiateWorldlineSessionResponseDto {
6916
+ /**
6917
+ * Opaque token returned to the client. Used by the client to poll/sync the session via GET /payment-session/:clientToken.
6918
+ * @type {string}
6919
+ * @memberof InitiateWorldlineSessionResponseDto
6920
+ */
6921
+ 'clientToken': string;
6922
+ /**
6923
+ * Internal session ID — equal to the Worldline operationId the webhook resolves against.
6924
+ * @type {string}
6925
+ * @memberof InitiateWorldlineSessionResponseDto
6926
+ */
6927
+ 'sessionId': string;
6928
+ /**
6929
+ * The Worldline operationId. Same value as sessionId; exposed so the client can correlate terminal/Ably updates during the transition.
6930
+ * @type {string}
6931
+ * @memberof InitiateWorldlineSessionResponseDto
6932
+ */
6933
+ 'operationId': string;
6934
+ }
6817
6935
  /**
6818
6936
  *
6819
6937
  * @export
@@ -9871,6 +9989,59 @@ export interface NetsPaymentMessageDtoData {
9871
9989
  */
9872
9990
  'storeboxToken'?: string;
9873
9991
  }
9992
+ /**
9993
+ *
9994
+ * @export
9995
+ * @enum {string}
9996
+ */
9997
+ export declare const NetsRevertMethod: {
9998
+ readonly Reversal: "REVERSAL";
9999
+ readonly Refund: "REFUND";
10000
+ };
10001
+ export type NetsRevertMethod = typeof NetsRevertMethod[keyof typeof NetsRevertMethod];
10002
+ /**
10003
+ *
10004
+ * @export
10005
+ * @interface NetsRevertResponseDto
10006
+ */
10007
+ export interface NetsRevertResponseDto {
10008
+ /**
10009
+ *
10010
+ * @type {NetsRevertMethod}
10011
+ * @memberof NetsRevertResponseDto
10012
+ */
10013
+ 'method': NetsRevertMethod;
10014
+ /**
10015
+ * True when the customer must tap their card to complete (REFUND); false for a REVERSAL, which settles without a tap.
10016
+ * @type {boolean}
10017
+ * @memberof NetsRevertResponseDto
10018
+ */
10019
+ 'requiresCardTap': boolean;
10020
+ /**
10021
+ * Opaque token to poll GET /payment-session/:clientToken for the final outcome.
10022
+ * @type {string}
10023
+ * @memberof NetsRevertResponseDto
10024
+ */
10025
+ 'clientToken': string;
10026
+ /**
10027
+ * Internal session id — the Nets connectcloud-request-id the webhook resolves against.
10028
+ * @type {string}
10029
+ * @memberof NetsRevertResponseDto
10030
+ */
10031
+ 'sessionId': string;
10032
+ /**
10033
+ * Amount being reverted, in the smallest currency unit (cents).
10034
+ * @type {number}
10035
+ * @memberof NetsRevertResponseDto
10036
+ */
10037
+ 'amount': number;
10038
+ /**
10039
+ *
10040
+ * @type {PaymentSessionStatus}
10041
+ * @memberof NetsRevertResponseDto
10042
+ */
10043
+ 'status': PaymentSessionStatus;
10044
+ }
9874
10045
  /**
9875
10046
  *
9876
10047
  * @export
@@ -13629,6 +13800,19 @@ export interface PollVivaSessionDto {
13629
13800
  */
13630
13801
  'sessionId': string;
13631
13802
  }
13803
+ /**
13804
+ *
13805
+ * @export
13806
+ * @interface PollWorldlineSessionDto
13807
+ */
13808
+ export interface PollWorldlineSessionDto {
13809
+ /**
13810
+ * The Worldline session id (= operationId) to poll.
13811
+ * @type {string}
13812
+ * @memberof PollWorldlineSessionDto
13813
+ */
13814
+ 'sessionId': string;
13815
+ }
13632
13816
  /**
13633
13817
  *
13634
13818
  * @export
@@ -24557,6 +24741,12 @@ export interface WorldlineRefundRequestDataDto {
24557
24741
  * @memberof WorldlineRefundRequestDataDto
24558
24742
  */
24559
24743
  'amounts': WorldlineRefundRequestDataDtoAmounts;
24744
+ /**
24745
+ * Receipt number of the original payment (from PaymentCompleted.receiptNumber). Required for a REVERSAL — it identifies which transaction on the terminal to void. Omit for a ReturnOfGoods refund.
24746
+ * @type {string}
24747
+ * @memberof WorldlineRefundRequestDataDto
24748
+ */
24749
+ 'receiptNumber'?: string;
24560
24750
  /**
24561
24751
  * Cashier identifier
24562
24752
  * @type {string}
@@ -24613,6 +24803,59 @@ export interface WorldlineRefundRequestDataDtoAmounts {
24613
24803
  */
24614
24804
  'tip'?: number;
24615
24805
  }
24806
+ /**
24807
+ *
24808
+ * @export
24809
+ * @enum {string}
24810
+ */
24811
+ export declare const WorldlineRevertMethod: {
24812
+ readonly Reversal: "REVERSAL";
24813
+ readonly Refund: "REFUND";
24814
+ };
24815
+ export type WorldlineRevertMethod = typeof WorldlineRevertMethod[keyof typeof WorldlineRevertMethod];
24816
+ /**
24817
+ *
24818
+ * @export
24819
+ * @interface WorldlineRevertResponseDto
24820
+ */
24821
+ export interface WorldlineRevertResponseDto {
24822
+ /**
24823
+ *
24824
+ * @type {WorldlineRevertMethod}
24825
+ * @memberof WorldlineRevertResponseDto
24826
+ */
24827
+ 'method': WorldlineRevertMethod;
24828
+ /**
24829
+ * True when the customer must tap their card to complete (REFUND); false for a REVERSAL, which settles without a tap.
24830
+ * @type {boolean}
24831
+ * @memberof WorldlineRevertResponseDto
24832
+ */
24833
+ 'requiresCardTap': boolean;
24834
+ /**
24835
+ * Opaque token to poll GET /payment-session/:clientToken for the final outcome.
24836
+ * @type {string}
24837
+ * @memberof WorldlineRevertResponseDto
24838
+ */
24839
+ 'clientToken': string;
24840
+ /**
24841
+ * Internal session id — the Worldline operationId the webhook resolves against.
24842
+ * @type {string}
24843
+ * @memberof WorldlineRevertResponseDto
24844
+ */
24845
+ 'sessionId': string;
24846
+ /**
24847
+ * Amount being reverted, in the smallest currency unit (cents).
24848
+ * @type {number}
24849
+ * @memberof WorldlineRevertResponseDto
24850
+ */
24851
+ 'amount': number;
24852
+ /**
24853
+ *
24854
+ * @type {PaymentSessionStatus}
24855
+ * @memberof WorldlineRevertResponseDto
24856
+ */
24857
+ 'status': PaymentSessionStatus;
24858
+ }
24616
24859
  /**
24617
24860
  * AblyApi - axios parameter creator
24618
24861
  * @export
@@ -32883,13 +33126,13 @@ export declare class PaymentMethodsApi extends BaseAPI implements PaymentMethods
32883
33126
  */
32884
33127
  export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Configuration) => {
32885
33128
  /**
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
33129
+ * 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.
33130
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
32888
33131
  * @param {string} clientToken
32889
33132
  * @param {*} [options] Override http request option.
32890
33133
  * @throws {RequiredError}
32891
33134
  */
32892
- cancelVivaSession: (clientToken: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33135
+ cancelSession: (clientToken: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32893
33136
  /**
32894
33137
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
32895
33138
  * @summary Get payment session status by clientToken
@@ -32898,6 +33141,15 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32898
33141
  * @throws {RequiredError}
32899
33142
  */
32900
33143
  getPaymentSession: (clientToken: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33144
+ /**
33145
+ * 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.
33146
+ * @summary Initiate a Nets terminal payment session
33147
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33148
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33149
+ * @param {*} [options] Override http request option.
33150
+ * @throws {RequiredError}
33151
+ */
33152
+ initiateNetsSession: (initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32901
33153
  /**
32902
33154
  * 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
33155
  * @summary Initiate a Viva app-to-app payment session
@@ -32915,6 +33167,15 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32915
33167
  * @throws {RequiredError}
32916
33168
  */
32917
33169
  initiateVivaSession: (initiateVivaSessionDto: InitiateVivaSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33170
+ /**
33171
+ * Creates a PaymentSession row and pushes the transaction to the station\'s Worldline terminal via the Worldline microservice (async — the result arrives via the Worldline webhook). Returns a client-facing token to poll. The backend owns the order mutation (webhook → reconciliation), replacing the legacy FE-writes-from-Ably flow. Idempotent via X-Idempotency-Key header.
33172
+ * @summary Initiate a Worldline terminal payment session
33173
+ * @param {InitiateWorldlineSessionDto} initiateWorldlineSessionDto
33174
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33175
+ * @param {*} [options] Override http request option.
33176
+ * @throws {RequiredError}
33177
+ */
33178
+ initiateWorldlineSession: (initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32918
33179
  /**
32919
33180
  * Called by a Cloud Task (not the client). Holds the request open and long-polls Viva by sessionId for up to ~45s. As soon as the transaction is terminal it updates the session status and, on success, triggers order reconciliation — guarded by a CAS claim (tryClose) so a late webhook never double-writes the paymentEvent — so the order closes even if the webhook never arrives.
32920
33181
  * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -32923,6 +33184,14 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32923
33184
  * @throws {RequiredError}
32924
33185
  */
32925
33186
  pollVivaSession: (pollVivaSessionDto: PollVivaSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33187
+ /**
33188
+ * Called by a Cloud Task (not the client). Polls the Worldline microservice by operationId for up to ~45s; as soon as the operation is terminal it finalizes the PaymentSession through the same sweep the webhook uses (CAS-guarded, so a webhook + poll never double-write). Ensures the session resolves even if the webhook is slow or never arrives.
33189
+ * @summary Internal: poll Worldline for a stuck payment session (Cloud Task callback)
33190
+ * @param {PollWorldlineSessionDto} pollWorldlineSessionDto
33191
+ * @param {*} [options] Override http request option.
33192
+ * @throws {RequiredError}
33193
+ */
33194
+ pollWorldlineSession: (pollWorldlineSessionDto: PollWorldlineSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32926
33195
  /**
32927
33196
  * Records a non-gateway payment (cash / voucher / CardManual / gift card / …) through PaymentSession so every device sees it. Card paymethods (Card/Debit/Credit/Edenred) use a gateway initiate. Resolves to SUCCESS immediately; reconciliation writes the paymentEvent.
32928
33197
  * @summary Record a manual payment session
@@ -32931,6 +33200,14 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32931
33200
  * @throws {RequiredError}
32932
33201
  */
32933
33202
  recordManualPayment: (createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33203
+ /**
33204
+ * 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.
33205
+ * @summary Refund a settled Nets payment session (gateway only, async)
33206
+ * @param {ReverseSessionDto} reverseSessionDto
33207
+ * @param {*} [options] Override http request option.
33208
+ * @throws {RequiredError}
33209
+ */
33210
+ refundNetsSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32934
33211
  /**
32935
33212
  * 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
33213
  * @summary Refund a settled Viva payment session (gateway only)
@@ -32939,6 +33216,22 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32939
33216
  * @throws {RequiredError}
32940
33217
  */
32941
33218
  refundVivaSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33219
+ /**
33220
+ * Starts a terminal-present ReturnOfGoods on the station\'s Worldline terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
33221
+ * @summary Refund a settled Worldline payment session (gateway only, async)
33222
+ * @param {ReverseSessionDto} reverseSessionDto
33223
+ * @param {*} [options] Override http request option.
33224
+ * @throws {RequiredError}
33225
+ */
33226
+ refundWorldlineSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33227
+ /**
33228
+ * 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.
33229
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33230
+ * @param {ReverseSessionDto} reverseSessionDto
33231
+ * @param {*} [options] Override http request option.
33232
+ * @throws {RequiredError}
33233
+ */
33234
+ revertNetsSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32942
33235
  /**
32943
33236
  * 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
33237
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -32947,6 +33240,14 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32947
33240
  * @throws {RequiredError}
32948
33241
  */
32949
33242
  revertVivaSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
33243
+ /**
33244
+ * Starts a terminal reversal for the full remaining amount AND writes a reversal paymentEvent to the order once the reversal settles (via reconciliation). Returns a PENDING refund session — poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. A reversal typically settles without a card tap; if the payment is already batched/settled the reversal fails and the client should fall back to /worldline/refund.
33245
+ * @summary Revert (fully reverse) a settled Worldline payment session (async)
33246
+ * @param {ReverseSessionDto} reverseSessionDto
33247
+ * @param {*} [options] Override http request option.
33248
+ * @throws {RequiredError}
33249
+ */
33250
+ revertWorldlineSession: (reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
32950
33251
  /**
32951
33252
  * Reverses a manually-recorded payment (cash / voucher / CardManual / gift card / …) by its sessionId (the order paymentEvent referenceId). Not for card paymethods (Card/Debit/Credit/Edenred) — those use cancel/refund. Idempotent: re-calling a voided session is a no-op.
32952
33253
  * @summary Void a manual payment session
@@ -32962,13 +33263,13 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
32962
33263
  */
32963
33264
  export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
32964
33265
  /**
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
33266
+ * 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.
33267
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
32967
33268
  * @param {string} clientToken
32968
33269
  * @param {*} [options] Override http request option.
32969
33270
  * @throws {RequiredError}
32970
33271
  */
32971
- cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33272
+ cancelSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
32972
33273
  /**
32973
33274
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
32974
33275
  * @summary Get payment session status by clientToken
@@ -32977,6 +33278,15 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
32977
33278
  * @throws {RequiredError}
32978
33279
  */
32979
33280
  getPaymentSession(clientToken: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33281
+ /**
33282
+ * 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.
33283
+ * @summary Initiate a Nets terminal payment session
33284
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33285
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33286
+ * @param {*} [options] Override http request option.
33287
+ * @throws {RequiredError}
33288
+ */
33289
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InitiateNetsSessionResponseDto>>;
32980
33290
  /**
32981
33291
  * 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
33292
  * @summary Initiate a Viva app-to-app payment session
@@ -32994,6 +33304,15 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
32994
33304
  * @throws {RequiredError}
32995
33305
  */
32996
33306
  initiateVivaSession(initiateVivaSessionDto: InitiateVivaSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InitiateVivaSessionResponseDto>>;
33307
+ /**
33308
+ * Creates a PaymentSession row and pushes the transaction to the station\'s Worldline terminal via the Worldline microservice (async — the result arrives via the Worldline webhook). Returns a client-facing token to poll. The backend owns the order mutation (webhook → reconciliation), replacing the legacy FE-writes-from-Ably flow. Idempotent via X-Idempotency-Key header.
33309
+ * @summary Initiate a Worldline terminal payment session
33310
+ * @param {InitiateWorldlineSessionDto} initiateWorldlineSessionDto
33311
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33312
+ * @param {*} [options] Override http request option.
33313
+ * @throws {RequiredError}
33314
+ */
33315
+ initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InitiateWorldlineSessionResponseDto>>;
32997
33316
  /**
32998
33317
  * Called by a Cloud Task (not the client). Holds the request open and long-polls Viva by sessionId for up to ~45s. As soon as the transaction is terminal it updates the session status and, on success, triggers order reconciliation — guarded by a CAS claim (tryClose) so a late webhook never double-writes the paymentEvent — so the order closes even if the webhook never arrives.
32999
33318
  * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -33002,6 +33321,14 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33002
33321
  * @throws {RequiredError}
33003
33322
  */
33004
33323
  pollVivaSession(pollVivaSessionDto: PollVivaSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
33324
+ /**
33325
+ * Called by a Cloud Task (not the client). Polls the Worldline microservice by operationId for up to ~45s; as soon as the operation is terminal it finalizes the PaymentSession through the same sweep the webhook uses (CAS-guarded, so a webhook + poll never double-write). Ensures the session resolves even if the webhook is slow or never arrives.
33326
+ * @summary Internal: poll Worldline for a stuck payment session (Cloud Task callback)
33327
+ * @param {PollWorldlineSessionDto} pollWorldlineSessionDto
33328
+ * @param {*} [options] Override http request option.
33329
+ * @throws {RequiredError}
33330
+ */
33331
+ pollWorldlineSession(pollWorldlineSessionDto: PollWorldlineSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
33005
33332
  /**
33006
33333
  * Records a non-gateway payment (cash / voucher / CardManual / gift card / …) through PaymentSession so every device sees it. Card paymethods (Card/Debit/Credit/Edenred) use a gateway initiate. Resolves to SUCCESS immediately; reconciliation writes the paymentEvent.
33007
33334
  * @summary Record a manual payment session
@@ -33010,6 +33337,14 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33010
33337
  * @throws {RequiredError}
33011
33338
  */
33012
33339
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<RecordManualPaymentResultDto>>;
33340
+ /**
33341
+ * 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.
33342
+ * @summary Refund a settled Nets payment session (gateway only, async)
33343
+ * @param {ReverseSessionDto} reverseSessionDto
33344
+ * @param {*} [options] Override http request option.
33345
+ * @throws {RequiredError}
33346
+ */
33347
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33013
33348
  /**
33014
33349
  * 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
33350
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33018,6 +33353,22 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33018
33353
  * @throws {RequiredError}
33019
33354
  */
33020
33355
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33356
+ /**
33357
+ * Starts a terminal-present ReturnOfGoods on the station\'s Worldline terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
33358
+ * @summary Refund a settled Worldline payment session (gateway only, async)
33359
+ * @param {ReverseSessionDto} reverseSessionDto
33360
+ * @param {*} [options] Override http request option.
33361
+ * @throws {RequiredError}
33362
+ */
33363
+ refundWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33364
+ /**
33365
+ * 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.
33366
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33367
+ * @param {ReverseSessionDto} reverseSessionDto
33368
+ * @param {*} [options] Override http request option.
33369
+ * @throws {RequiredError}
33370
+ */
33371
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<NetsRevertResponseDto>>;
33021
33372
  /**
33022
33373
  * 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
33374
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -33026,6 +33377,14 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33026
33377
  * @throws {RequiredError}
33027
33378
  */
33028
33379
  revertVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<PaymentSessionViewDto>>;
33380
+ /**
33381
+ * Starts a terminal reversal for the full remaining amount AND writes a reversal paymentEvent to the order once the reversal settles (via reconciliation). Returns a PENDING refund session — poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. A reversal typically settles without a card tap; if the payment is already batched/settled the reversal fails and the client should fall back to /worldline/refund.
33382
+ * @summary Revert (fully reverse) a settled Worldline payment session (async)
33383
+ * @param {ReverseSessionDto} reverseSessionDto
33384
+ * @param {*} [options] Override http request option.
33385
+ * @throws {RequiredError}
33386
+ */
33387
+ revertWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<WorldlineRevertResponseDto>>;
33029
33388
  /**
33030
33389
  * Reverses a manually-recorded payment (cash / voucher / CardManual / gift card / …) by its sessionId (the order paymentEvent referenceId). Not for card paymethods (Card/Debit/Credit/Edenred) — those use cancel/refund. Idempotent: re-calling a voided session is a no-op.
33031
33390
  * @summary Void a manual payment session
@@ -33041,13 +33400,13 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
33041
33400
  */
33042
33401
  export declare const PaymentSessionApiFactory: (configuration?: Configuration, basePath?: string, axios?: AxiosInstance) => {
33043
33402
  /**
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
33403
+ * 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.
33404
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
33046
33405
  * @param {string} clientToken
33047
33406
  * @param {*} [options] Override http request option.
33048
33407
  * @throws {RequiredError}
33049
33408
  */
33050
- cancelVivaSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto>;
33409
+ cancelSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto>;
33051
33410
  /**
33052
33411
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
33053
33412
  * @summary Get payment session status by clientToken
@@ -33056,6 +33415,15 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33056
33415
  * @throws {RequiredError}
33057
33416
  */
33058
33417
  getPaymentSession(clientToken: string, options?: any): AxiosPromise<PaymentSessionViewDto>;
33418
+ /**
33419
+ * 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.
33420
+ * @summary Initiate a Nets terminal payment session
33421
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33422
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33423
+ * @param {*} [options] Override http request option.
33424
+ * @throws {RequiredError}
33425
+ */
33426
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: any): AxiosPromise<InitiateNetsSessionResponseDto>;
33059
33427
  /**
33060
33428
  * 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
33429
  * @summary Initiate a Viva app-to-app payment session
@@ -33073,6 +33441,15 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33073
33441
  * @throws {RequiredError}
33074
33442
  */
33075
33443
  initiateVivaSession(initiateVivaSessionDto: InitiateVivaSessionDto, xIdempotencyKey?: string, options?: any): AxiosPromise<InitiateVivaSessionResponseDto>;
33444
+ /**
33445
+ * Creates a PaymentSession row and pushes the transaction to the station\'s Worldline terminal via the Worldline microservice (async — the result arrives via the Worldline webhook). Returns a client-facing token to poll. The backend owns the order mutation (webhook → reconciliation), replacing the legacy FE-writes-from-Ably flow. Idempotent via X-Idempotency-Key header.
33446
+ * @summary Initiate a Worldline terminal payment session
33447
+ * @param {InitiateWorldlineSessionDto} initiateWorldlineSessionDto
33448
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33449
+ * @param {*} [options] Override http request option.
33450
+ * @throws {RequiredError}
33451
+ */
33452
+ initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: any): AxiosPromise<InitiateWorldlineSessionResponseDto>;
33076
33453
  /**
33077
33454
  * Called by a Cloud Task (not the client). Holds the request open and long-polls Viva by sessionId for up to ~45s. As soon as the transaction is terminal it updates the session status and, on success, triggers order reconciliation — guarded by a CAS claim (tryClose) so a late webhook never double-writes the paymentEvent — so the order closes even if the webhook never arrives.
33078
33455
  * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -33081,6 +33458,14 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33081
33458
  * @throws {RequiredError}
33082
33459
  */
33083
33460
  pollVivaSession(pollVivaSessionDto: PollVivaSessionDto, options?: any): AxiosPromise<void>;
33461
+ /**
33462
+ * Called by a Cloud Task (not the client). Polls the Worldline microservice by operationId for up to ~45s; as soon as the operation is terminal it finalizes the PaymentSession through the same sweep the webhook uses (CAS-guarded, so a webhook + poll never double-write). Ensures the session resolves even if the webhook is slow or never arrives.
33463
+ * @summary Internal: poll Worldline for a stuck payment session (Cloud Task callback)
33464
+ * @param {PollWorldlineSessionDto} pollWorldlineSessionDto
33465
+ * @param {*} [options] Override http request option.
33466
+ * @throws {RequiredError}
33467
+ */
33468
+ pollWorldlineSession(pollWorldlineSessionDto: PollWorldlineSessionDto, options?: any): AxiosPromise<void>;
33084
33469
  /**
33085
33470
  * Records a non-gateway payment (cash / voucher / CardManual / gift card / …) through PaymentSession so every device sees it. Card paymethods (Card/Debit/Credit/Edenred) use a gateway initiate. Resolves to SUCCESS immediately; reconciliation writes the paymentEvent.
33086
33471
  * @summary Record a manual payment session
@@ -33089,6 +33474,14 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33089
33474
  * @throws {RequiredError}
33090
33475
  */
33091
33476
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: any): AxiosPromise<RecordManualPaymentResultDto>;
33477
+ /**
33478
+ * 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.
33479
+ * @summary Refund a settled Nets payment session (gateway only, async)
33480
+ * @param {ReverseSessionDto} reverseSessionDto
33481
+ * @param {*} [options] Override http request option.
33482
+ * @throws {RequiredError}
33483
+ */
33484
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto>;
33092
33485
  /**
33093
33486
  * 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
33487
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33097,6 +33490,22 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33097
33490
  * @throws {RequiredError}
33098
33491
  */
33099
33492
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto>;
33493
+ /**
33494
+ * Starts a terminal-present ReturnOfGoods on the station\'s Worldline terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
33495
+ * @summary Refund a settled Worldline payment session (gateway only, async)
33496
+ * @param {ReverseSessionDto} reverseSessionDto
33497
+ * @param {*} [options] Override http request option.
33498
+ * @throws {RequiredError}
33499
+ */
33500
+ refundWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto>;
33501
+ /**
33502
+ * 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.
33503
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33504
+ * @param {ReverseSessionDto} reverseSessionDto
33505
+ * @param {*} [options] Override http request option.
33506
+ * @throws {RequiredError}
33507
+ */
33508
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<NetsRevertResponseDto>;
33100
33509
  /**
33101
33510
  * 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
33511
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -33105,6 +33514,14 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33105
33514
  * @throws {RequiredError}
33106
33515
  */
33107
33516
  revertVivaSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<PaymentSessionViewDto>;
33517
+ /**
33518
+ * Starts a terminal reversal for the full remaining amount AND writes a reversal paymentEvent to the order once the reversal settles (via reconciliation). Returns a PENDING refund session — poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. A reversal typically settles without a card tap; if the payment is already batched/settled the reversal fails and the client should fall back to /worldline/refund.
33519
+ * @summary Revert (fully reverse) a settled Worldline payment session (async)
33520
+ * @param {ReverseSessionDto} reverseSessionDto
33521
+ * @param {*} [options] Override http request option.
33522
+ * @throws {RequiredError}
33523
+ */
33524
+ revertWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: any): AxiosPromise<WorldlineRevertResponseDto>;
33108
33525
  /**
33109
33526
  * Reverses a manually-recorded payment (cash / voucher / CardManual / gift card / …) by its sessionId (the order paymentEvent referenceId). Not for card paymethods (Card/Debit/Credit/Edenred) — those use cancel/refund. Idempotent: re-calling a voided session is a no-op.
33110
33527
  * @summary Void a manual payment session
@@ -33121,14 +33538,14 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
33121
33538
  */
33122
33539
  export interface PaymentSessionApiInterface {
33123
33540
  /**
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
33541
+ * 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.
33542
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
33126
33543
  * @param {string} clientToken
33127
33544
  * @param {*} [options] Override http request option.
33128
33545
  * @throws {RequiredError}
33129
33546
  * @memberof PaymentSessionApiInterface
33130
33547
  */
33131
- cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33548
+ cancelSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33132
33549
  /**
33133
33550
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
33134
33551
  * @summary Get payment session status by clientToken
@@ -33138,6 +33555,16 @@ export interface PaymentSessionApiInterface {
33138
33555
  * @memberof PaymentSessionApiInterface
33139
33556
  */
33140
33557
  getPaymentSession(clientToken: string, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33558
+ /**
33559
+ * 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.
33560
+ * @summary Initiate a Nets terminal payment session
33561
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33562
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33563
+ * @param {*} [options] Override http request option.
33564
+ * @throws {RequiredError}
33565
+ * @memberof PaymentSessionApiInterface
33566
+ */
33567
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): AxiosPromise<InitiateNetsSessionResponseDto>;
33141
33568
  /**
33142
33569
  * 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
33570
  * @summary Initiate a Viva app-to-app payment session
@@ -33157,6 +33584,16 @@ export interface PaymentSessionApiInterface {
33157
33584
  * @memberof PaymentSessionApiInterface
33158
33585
  */
33159
33586
  initiateVivaSession(initiateVivaSessionDto: InitiateVivaSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): AxiosPromise<InitiateVivaSessionResponseDto>;
33587
+ /**
33588
+ * Creates a PaymentSession row and pushes the transaction to the station\'s Worldline terminal via the Worldline microservice (async — the result arrives via the Worldline webhook). Returns a client-facing token to poll. The backend owns the order mutation (webhook → reconciliation), replacing the legacy FE-writes-from-Ably flow. Idempotent via X-Idempotency-Key header.
33589
+ * @summary Initiate a Worldline terminal payment session
33590
+ * @param {InitiateWorldlineSessionDto} initiateWorldlineSessionDto
33591
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33592
+ * @param {*} [options] Override http request option.
33593
+ * @throws {RequiredError}
33594
+ * @memberof PaymentSessionApiInterface
33595
+ */
33596
+ initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): AxiosPromise<InitiateWorldlineSessionResponseDto>;
33160
33597
  /**
33161
33598
  * Called by a Cloud Task (not the client). Holds the request open and long-polls Viva by sessionId for up to ~45s. As soon as the transaction is terminal it updates the session status and, on success, triggers order reconciliation — guarded by a CAS claim (tryClose) so a late webhook never double-writes the paymentEvent — so the order closes even if the webhook never arrives.
33162
33599
  * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -33166,6 +33603,15 @@ export interface PaymentSessionApiInterface {
33166
33603
  * @memberof PaymentSessionApiInterface
33167
33604
  */
33168
33605
  pollVivaSession(pollVivaSessionDto: PollVivaSessionDto, options?: AxiosRequestConfig): AxiosPromise<void>;
33606
+ /**
33607
+ * Called by a Cloud Task (not the client). Polls the Worldline microservice by operationId for up to ~45s; as soon as the operation is terminal it finalizes the PaymentSession through the same sweep the webhook uses (CAS-guarded, so a webhook + poll never double-write). Ensures the session resolves even if the webhook is slow or never arrives.
33608
+ * @summary Internal: poll Worldline for a stuck payment session (Cloud Task callback)
33609
+ * @param {PollWorldlineSessionDto} pollWorldlineSessionDto
33610
+ * @param {*} [options] Override http request option.
33611
+ * @throws {RequiredError}
33612
+ * @memberof PaymentSessionApiInterface
33613
+ */
33614
+ pollWorldlineSession(pollWorldlineSessionDto: PollWorldlineSessionDto, options?: AxiosRequestConfig): AxiosPromise<void>;
33169
33615
  /**
33170
33616
  * Records a non-gateway payment (cash / voucher / CardManual / gift card / …) through PaymentSession so every device sees it. Card paymethods (Card/Debit/Credit/Edenred) use a gateway initiate. Resolves to SUCCESS immediately; reconciliation writes the paymentEvent.
33171
33617
  * @summary Record a manual payment session
@@ -33175,6 +33621,15 @@ export interface PaymentSessionApiInterface {
33175
33621
  * @memberof PaymentSessionApiInterface
33176
33622
  */
33177
33623
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig): AxiosPromise<RecordManualPaymentResultDto>;
33624
+ /**
33625
+ * 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.
33626
+ * @summary Refund a settled Nets payment session (gateway only, async)
33627
+ * @param {ReverseSessionDto} reverseSessionDto
33628
+ * @param {*} [options] Override http request option.
33629
+ * @throws {RequiredError}
33630
+ * @memberof PaymentSessionApiInterface
33631
+ */
33632
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33178
33633
  /**
33179
33634
  * 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
33635
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33184,6 +33639,24 @@ export interface PaymentSessionApiInterface {
33184
33639
  * @memberof PaymentSessionApiInterface
33185
33640
  */
33186
33641
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33642
+ /**
33643
+ * Starts a terminal-present ReturnOfGoods on the station\'s Worldline terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
33644
+ * @summary Refund a settled Worldline payment session (gateway only, async)
33645
+ * @param {ReverseSessionDto} reverseSessionDto
33646
+ * @param {*} [options] Override http request option.
33647
+ * @throws {RequiredError}
33648
+ * @memberof PaymentSessionApiInterface
33649
+ */
33650
+ refundWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33651
+ /**
33652
+ * 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.
33653
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33654
+ * @param {ReverseSessionDto} reverseSessionDto
33655
+ * @param {*} [options] Override http request option.
33656
+ * @throws {RequiredError}
33657
+ * @memberof PaymentSessionApiInterface
33658
+ */
33659
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<NetsRevertResponseDto>;
33187
33660
  /**
33188
33661
  * 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
33662
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -33193,6 +33666,15 @@ export interface PaymentSessionApiInterface {
33193
33666
  * @memberof PaymentSessionApiInterface
33194
33667
  */
33195
33668
  revertVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<PaymentSessionViewDto>;
33669
+ /**
33670
+ * Starts a terminal reversal for the full remaining amount AND writes a reversal paymentEvent to the order once the reversal settles (via reconciliation). Returns a PENDING refund session — poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. A reversal typically settles without a card tap; if the payment is already batched/settled the reversal fails and the client should fall back to /worldline/refund.
33671
+ * @summary Revert (fully reverse) a settled Worldline payment session (async)
33672
+ * @param {ReverseSessionDto} reverseSessionDto
33673
+ * @param {*} [options] Override http request option.
33674
+ * @throws {RequiredError}
33675
+ * @memberof PaymentSessionApiInterface
33676
+ */
33677
+ revertWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): AxiosPromise<WorldlineRevertResponseDto>;
33196
33678
  /**
33197
33679
  * Reverses a manually-recorded payment (cash / voucher / CardManual / gift card / …) by its sessionId (the order paymentEvent referenceId). Not for card paymethods (Card/Debit/Credit/Edenred) — those use cancel/refund. Idempotent: re-calling a voided session is a no-op.
33198
33680
  * @summary Void a manual payment session
@@ -33211,14 +33693,14 @@ export interface PaymentSessionApiInterface {
33211
33693
  */
33212
33694
  export declare class PaymentSessionApi extends BaseAPI implements PaymentSessionApiInterface {
33213
33695
  /**
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
33696
+ * 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.
33697
+ * @summary Cancel an in-flight card payment session (Viva or Nets)
33216
33698
  * @param {string} clientToken
33217
33699
  * @param {*} [options] Override http request option.
33218
33700
  * @throws {RequiredError}
33219
33701
  * @memberof PaymentSessionApi
33220
33702
  */
33221
- cancelVivaSession(clientToken: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33703
+ cancelSession(clientToken: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33222
33704
  /**
33223
33705
  * Reads PaymentSession from Postgres. Use this to poll session lifecycle without hitting the Viva API.
33224
33706
  * @summary Get payment session status by clientToken
@@ -33228,6 +33710,16 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33228
33710
  * @memberof PaymentSessionApi
33229
33711
  */
33230
33712
  getPaymentSession(clientToken: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33713
+ /**
33714
+ * 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.
33715
+ * @summary Initiate a Nets terminal payment session
33716
+ * @param {InitiateNetsSessionDto} initiateNetsSessionDto
33717
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33718
+ * @param {*} [options] Override http request option.
33719
+ * @throws {RequiredError}
33720
+ * @memberof PaymentSessionApi
33721
+ */
33722
+ initiateNetsSession(initiateNetsSessionDto: InitiateNetsSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<InitiateNetsSessionResponseDto, any, {}>>;
33231
33723
  /**
33232
33724
  * 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
33725
  * @summary Initiate a Viva app-to-app payment session
@@ -33247,6 +33739,16 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33247
33739
  * @memberof PaymentSessionApi
33248
33740
  */
33249
33741
  initiateVivaSession(initiateVivaSessionDto: InitiateVivaSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<InitiateVivaSessionResponseDto, any, {}>>;
33742
+ /**
33743
+ * Creates a PaymentSession row and pushes the transaction to the station\'s Worldline terminal via the Worldline microservice (async — the result arrives via the Worldline webhook). Returns a client-facing token to poll. The backend owns the order mutation (webhook → reconciliation), replacing the legacy FE-writes-from-Ably flow. Idempotent via X-Idempotency-Key header.
33744
+ * @summary Initiate a Worldline terminal payment session
33745
+ * @param {InitiateWorldlineSessionDto} initiateWorldlineSessionDto
33746
+ * @param {string} [xIdempotencyKey] Client-generated UUID. If a session already exists for this key, the existing session is returned.
33747
+ * @param {*} [options] Override http request option.
33748
+ * @throws {RequiredError}
33749
+ * @memberof PaymentSessionApi
33750
+ */
33751
+ initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<InitiateWorldlineSessionResponseDto, any, {}>>;
33250
33752
  /**
33251
33753
  * Called by a Cloud Task (not the client). Holds the request open and long-polls Viva by sessionId for up to ~45s. As soon as the transaction is terminal it updates the session status and, on success, triggers order reconciliation — guarded by a CAS claim (tryClose) so a late webhook never double-writes the paymentEvent — so the order closes even if the webhook never arrives.
33252
33754
  * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -33256,6 +33758,15 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33256
33758
  * @memberof PaymentSessionApi
33257
33759
  */
33258
33760
  pollVivaSession(pollVivaSessionDto: PollVivaSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
33761
+ /**
33762
+ * Called by a Cloud Task (not the client). Polls the Worldline microservice by operationId for up to ~45s; as soon as the operation is terminal it finalizes the PaymentSession through the same sweep the webhook uses (CAS-guarded, so a webhook + poll never double-write). Ensures the session resolves even if the webhook is slow or never arrives.
33763
+ * @summary Internal: poll Worldline for a stuck payment session (Cloud Task callback)
33764
+ * @param {PollWorldlineSessionDto} pollWorldlineSessionDto
33765
+ * @param {*} [options] Override http request option.
33766
+ * @throws {RequiredError}
33767
+ * @memberof PaymentSessionApi
33768
+ */
33769
+ pollWorldlineSession(pollWorldlineSessionDto: PollWorldlineSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
33259
33770
  /**
33260
33771
  * Records a non-gateway payment (cash / voucher / CardManual / gift card / …) through PaymentSession so every device sees it. Card paymethods (Card/Debit/Credit/Edenred) use a gateway initiate. Resolves to SUCCESS immediately; reconciliation writes the paymentEvent.
33261
33772
  * @summary Record a manual payment session
@@ -33265,6 +33776,15 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33265
33776
  * @memberof PaymentSessionApi
33266
33777
  */
33267
33778
  recordManualPayment(createManualSessionDto: CreateManualSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<RecordManualPaymentResultDto, any, {}>>;
33779
+ /**
33780
+ * 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.
33781
+ * @summary Refund a settled Nets payment session (gateway only, async)
33782
+ * @param {ReverseSessionDto} reverseSessionDto
33783
+ * @param {*} [options] Override http request option.
33784
+ * @throws {RequiredError}
33785
+ * @memberof PaymentSessionApi
33786
+ */
33787
+ refundNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33268
33788
  /**
33269
33789
  * 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
33790
  * @summary Refund a settled Viva payment session (gateway only)
@@ -33274,6 +33794,24 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33274
33794
  * @memberof PaymentSessionApi
33275
33795
  */
33276
33796
  refundVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33797
+ /**
33798
+ * Starts a terminal-present ReturnOfGoods on the station\'s Worldline terminal for the given sessionId, refunding the payload `amount` (defaults to the full session amount). Returns a PENDING refund session — the customer must tap their card; poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. Does NOT write a reversal paymentEvent to the order.
33799
+ * @summary Refund a settled Worldline payment session (gateway only, async)
33800
+ * @param {ReverseSessionDto} reverseSessionDto
33801
+ * @param {*} [options] Override http request option.
33802
+ * @throws {RequiredError}
33803
+ * @memberof PaymentSessionApi
33804
+ */
33805
+ refundWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33806
+ /**
33807
+ * 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.
33808
+ * @summary Revert (fully reverse) a settled Nets payment session (async)
33809
+ * @param {ReverseSessionDto} reverseSessionDto
33810
+ * @param {*} [options] Override http request option.
33811
+ * @throws {RequiredError}
33812
+ * @memberof PaymentSessionApi
33813
+ */
33814
+ revertNetsSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<NetsRevertResponseDto, any, {}>>;
33277
33815
  /**
33278
33816
  * 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
33817
  * @summary Revert (fully reverse) a settled Viva payment session
@@ -33283,6 +33821,15 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
33283
33821
  * @memberof PaymentSessionApi
33284
33822
  */
33285
33823
  revertVivaSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<PaymentSessionViewDto, any, {}>>;
33824
+ /**
33825
+ * Starts a terminal reversal for the full remaining amount AND writes a reversal paymentEvent to the order once the reversal settles (via reconciliation). Returns a PENDING refund session — poll GET /:clientToken until REFUNDED/FAILED/CANCELLED. A reversal typically settles without a card tap; if the payment is already batched/settled the reversal fails and the client should fall back to /worldline/refund.
33826
+ * @summary Revert (fully reverse) a settled Worldline payment session (async)
33827
+ * @param {ReverseSessionDto} reverseSessionDto
33828
+ * @param {*} [options] Override http request option.
33829
+ * @throws {RequiredError}
33830
+ * @memberof PaymentSessionApi
33831
+ */
33832
+ revertWorldlineSession(reverseSessionDto: ReverseSessionDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<WorldlineRevertResponseDto, any, {}>>;
33286
33833
  /**
33287
33834
  * Reverses a manually-recorded payment (cash / voucher / CardManual / gift card / …) by its sessionId (the order paymentEvent referenceId). Not for card paymethods (Card/Debit/Credit/Edenred) — those use cancel/refund. Idempotent: re-calling a voided session is a no-op.
33288
33835
  * @summary Void a manual payment session
@@ -36031,6 +36578,13 @@ export declare const WebhookApiAxiosParamCreator: (configuration?: Configuration
36031
36578
  * @throws {RequiredError}
36032
36579
  */
36033
36580
  handleNetsEventsV2: (options?: AxiosRequestConfig) => Promise<RequestArgs>;
36581
+ /**
36582
+ * 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.
36583
+ * @summary Handle Nets webhook events for the payment-session flow
36584
+ * @param {*} [options] Override http request option.
36585
+ * @throws {RequiredError}
36586
+ */
36587
+ handleNetsSessionEvents: (options?: AxiosRequestConfig) => Promise<RequestArgs>;
36034
36588
  /**
36035
36589
  *
36036
36590
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36060,7 +36614,7 @@ export declare const WebhookApiAxiosParamCreator: (configuration?: Configuration
36060
36614
  */
36061
36615
  handleVivaEvents: (vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
36062
36616
  /**
36063
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36617
+ * 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
36618
  * @summary Handle Viva webhook events for the payment-session flow
36065
36619
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36066
36620
  * @param {*} [options] Override http request option.
@@ -36092,6 +36646,13 @@ export declare const WebhookApiAxiosParamCreator: (configuration?: Configuration
36092
36646
  * @throws {RequiredError}
36093
36647
  */
36094
36648
  handleWorldlineEvents: (options?: AxiosRequestConfig) => Promise<RequestArgs>;
36649
+ /**
36650
+ * Per-operation callback registered at initiate (x-munchi-webhook-address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. The legacy /worldline/events (FE-writes-from-Ably) stays untouched.
36651
+ * @summary Handle Worldline webhook events for the payment-session flow
36652
+ * @param {*} [options] Override http request option.
36653
+ * @throws {RequiredError}
36654
+ */
36655
+ handleWorldlineSessionEvents: (options?: AxiosRequestConfig) => Promise<RequestArgs>;
36095
36656
  /**
36096
36657
  *
36097
36658
  * @summary Process a queued POS order-actions job (triggered by Cloud Tasks)
@@ -36163,6 +36724,13 @@ export declare const WebhookApiFp: (configuration?: Configuration) => {
36163
36724
  * @throws {RequiredError}
36164
36725
  */
36165
36726
  handleNetsEventsV2(options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36727
+ /**
36728
+ * 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.
36729
+ * @summary Handle Nets webhook events for the payment-session flow
36730
+ * @param {*} [options] Override http request option.
36731
+ * @throws {RequiredError}
36732
+ */
36733
+ handleNetsSessionEvents(options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36166
36734
  /**
36167
36735
  *
36168
36736
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36192,7 +36760,7 @@ export declare const WebhookApiFp: (configuration?: Configuration) => {
36192
36760
  */
36193
36761
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36194
36762
  /**
36195
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36763
+ * 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
36764
  * @summary Handle Viva webhook events for the payment-session flow
36197
36765
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36198
36766
  * @param {*} [options] Override http request option.
@@ -36224,6 +36792,13 @@ export declare const WebhookApiFp: (configuration?: Configuration) => {
36224
36792
  * @throws {RequiredError}
36225
36793
  */
36226
36794
  handleWorldlineEvents(options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36795
+ /**
36796
+ * Per-operation callback registered at initiate (x-munchi-webhook-address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. The legacy /worldline/events (FE-writes-from-Ably) stays untouched.
36797
+ * @summary Handle Worldline webhook events for the payment-session flow
36798
+ * @param {*} [options] Override http request option.
36799
+ * @throws {RequiredError}
36800
+ */
36801
+ handleWorldlineSessionEvents(options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
36227
36802
  /**
36228
36803
  *
36229
36804
  * @summary Process a queued POS order-actions job (triggered by Cloud Tasks)
@@ -36295,6 +36870,13 @@ export declare const WebhookApiFactory: (configuration?: Configuration, basePath
36295
36870
  * @throws {RequiredError}
36296
36871
  */
36297
36872
  handleNetsEventsV2(options?: any): AxiosPromise<void>;
36873
+ /**
36874
+ * 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.
36875
+ * @summary Handle Nets webhook events for the payment-session flow
36876
+ * @param {*} [options] Override http request option.
36877
+ * @throws {RequiredError}
36878
+ */
36879
+ handleNetsSessionEvents(options?: any): AxiosPromise<void>;
36298
36880
  /**
36299
36881
  *
36300
36882
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36324,7 +36906,7 @@ export declare const WebhookApiFactory: (configuration?: Configuration, basePath
36324
36906
  */
36325
36907
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: any): AxiosPromise<void>;
36326
36908
  /**
36327
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
36909
+ * 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
36910
  * @summary Handle Viva webhook events for the payment-session flow
36329
36911
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36330
36912
  * @param {*} [options] Override http request option.
@@ -36356,6 +36938,13 @@ export declare const WebhookApiFactory: (configuration?: Configuration, basePath
36356
36938
  * @throws {RequiredError}
36357
36939
  */
36358
36940
  handleWorldlineEvents(options?: any): AxiosPromise<void>;
36941
+ /**
36942
+ * Per-operation callback registered at initiate (x-munchi-webhook-address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. The legacy /worldline/events (FE-writes-from-Ably) stays untouched.
36943
+ * @summary Handle Worldline webhook events for the payment-session flow
36944
+ * @param {*} [options] Override http request option.
36945
+ * @throws {RequiredError}
36946
+ */
36947
+ handleWorldlineSessionEvents(options?: any): AxiosPromise<void>;
36359
36948
  /**
36360
36949
  *
36361
36950
  * @summary Process a queued POS order-actions job (triggered by Cloud Tasks)
@@ -36434,6 +37023,14 @@ export interface WebhookApiInterface {
36434
37023
  * @memberof WebhookApiInterface
36435
37024
  */
36436
37025
  handleNetsEventsV2(options?: AxiosRequestConfig): AxiosPromise<void>;
37026
+ /**
37027
+ * 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.
37028
+ * @summary Handle Nets webhook events for the payment-session flow
37029
+ * @param {*} [options] Override http request option.
37030
+ * @throws {RequiredError}
37031
+ * @memberof WebhookApiInterface
37032
+ */
37033
+ handleNetsSessionEvents(options?: AxiosRequestConfig): AxiosPromise<void>;
36437
37034
  /**
36438
37035
  *
36439
37036
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36467,7 +37064,7 @@ export interface WebhookApiInterface {
36467
37064
  */
36468
37065
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig): AxiosPromise<void>;
36469
37066
  /**
36470
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
37067
+ * 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
37068
  * @summary Handle Viva webhook events for the payment-session flow
36472
37069
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36473
37070
  * @param {*} [options] Override http request option.
@@ -36504,6 +37101,14 @@ export interface WebhookApiInterface {
36504
37101
  * @memberof WebhookApiInterface
36505
37102
  */
36506
37103
  handleWorldlineEvents(options?: AxiosRequestConfig): AxiosPromise<void>;
37104
+ /**
37105
+ * Per-operation callback registered at initiate (x-munchi-webhook-address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. The legacy /worldline/events (FE-writes-from-Ably) stays untouched.
37106
+ * @summary Handle Worldline webhook events for the payment-session flow
37107
+ * @param {*} [options] Override http request option.
37108
+ * @throws {RequiredError}
37109
+ * @memberof WebhookApiInterface
37110
+ */
37111
+ handleWorldlineSessionEvents(options?: AxiosRequestConfig): AxiosPromise<void>;
36507
37112
  /**
36508
37113
  *
36509
37114
  * @summary Process a queued POS order-actions job (triggered by Cloud Tasks)
@@ -36587,6 +37192,14 @@ export declare class WebhookApi extends BaseAPI implements WebhookApiInterface {
36587
37192
  * @memberof WebhookApi
36588
37193
  */
36589
37194
  handleNetsEventsV2(options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
37195
+ /**
37196
+ * 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.
37197
+ * @summary Handle Nets webhook events for the payment-session flow
37198
+ * @param {*} [options] Override http request option.
37199
+ * @throws {RequiredError}
37200
+ * @memberof WebhookApi
37201
+ */
37202
+ handleNetsSessionEvents(options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
36590
37203
  /**
36591
37204
  *
36592
37205
  * @summary Handle preorder reminder (triggered by scheduler)
@@ -36620,7 +37233,7 @@ export declare class WebhookApi extends BaseAPI implements WebhookApiInterface {
36620
37233
  */
36621
37234
  handleVivaEvents(vivaWebhookPayloadDto: VivaWebhookPayloadDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
36622
37235
  /**
36623
- * Routes Viva ECR events to PaymentSession update + reconciliation. Does not touch the legacy /viva/verification path.
37236
+ * 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
37237
  * @summary Handle Viva webhook events for the payment-session flow
36625
37238
  * @param {VivaWebhookPayloadDto} vivaWebhookPayloadDto
36626
37239
  * @param {*} [options] Override http request option.
@@ -36657,6 +37270,14 @@ export declare class WebhookApi extends BaseAPI implements WebhookApiInterface {
36657
37270
  * @memberof WebhookApi
36658
37271
  */
36659
37272
  handleWorldlineEvents(options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
37273
+ /**
37274
+ * Per-operation callback registered at initiate (x-munchi-webhook-address). Finalizes the PaymentSession to SUCCESS/FAILED/CANCELLED and triggers order reconciliation. The legacy /worldline/events (FE-writes-from-Ably) stays untouched.
37275
+ * @summary Handle Worldline webhook events for the payment-session flow
37276
+ * @param {*} [options] Override http request option.
37277
+ * @throws {RequiredError}
37278
+ * @memberof WebhookApi
37279
+ */
37280
+ handleWorldlineSessionEvents(options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
36660
37281
  /**
36661
37282
  *
36662
37283
  * @summary Process a queued POS order-actions job (triggered by Cloud Tasks)