@munchi_oy/core 1.9.98 → 1.9.99

package/dist/generated/api.d.ts

@@ -6813,12 +6813,6 @@ export interface InitiateVivaA2aSessionDto {
      * @memberof InitiateVivaA2aSessionDto
      */
     'splitContext'?: CreateManualSessionDtoSplitContext;
-    /**
-     * Pay-terminal chargeId (from the pay-terminal-protocol relay) for this attempt. Stamped onto the session\'s metadata so the charge-status fallback can address this exact attempt directly, even when other charges are concurrently in flight on the same order (e.g. a split payment dispatched to a different paired terminal).
-     * @type {string}
-     * @memberof InitiateVivaA2aSessionDto
-     */
-    'chargeId'?: string;
 }
 /**
  *
@@ -19302,6 +19296,25 @@ export interface RefundedItemDto {
      */
     'amount': number;
 }
+/**
+ *
+ * @export
+ * @interface RegisterChargeMappingDto
+ */
+export interface RegisterChargeMappingDto {
+    /**
+     * POS-generated id for this charge attempt (from the pay-terminal Ably relay).
+     * @type {string}
+     * @memberof RegisterChargeMappingDto
+     */
+    'chargeId': string;
+    /**
+     * The Viva app-to-app session\'s sessionId (== clientTransactionId). Known on the paying device once the SDK\'s onRequiresInput callback fires, right after the session is created and before the card is tapped. Globally unique per attempt, so this mapping can\'t collide with a concurrent charge on the same order (e.g. a split payment on another terminal).
+     * @type {string}
+     * @memberof RegisterChargeMappingDto
+     */
+    'sessionId': string;
+}
 /**
  *
  * @export
@@ -35448,13 +35461,21 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
      */
     initiateWorldlineSession: (initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
     /**
-     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity. chargeId is stamped onto the session\'s own metadata at /viva/a2a initiate time, so this addresses one specific charge attempt even when other charges are concurrently in flight on the same order (e.g. a split payment across multiple paired terminals).
+     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity.
      * @summary Poll a charge\'s outcome by chargeId.
      * @param {string} chargeId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     paymentSessionGetChargeStatus: (chargeId: string, options?: AxiosRequestConfig) => Promise<RequestArgs>;
+    /**
+     * Called by the paying device (e.g. a paired Munchi Pay terminal) once the Viva app-to-app session is created (sessionId known via the SDK\'s onRequiresInput callback), so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against a Viva session so its outcome can be polled.
+     * @param {RegisterChargeMappingDto} registerChargeMappingDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    paymentSessionRegisterChargeMapping: (registerChargeMappingDto: RegisterChargeMappingDto, options?: AxiosRequestConfig) => Promise<RequestArgs>;
     /**
      * 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.
      * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -35603,13 +35624,21 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
      */
     initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<InitiateWorldlineSessionResponseDto>>;
     /**
-     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity. chargeId is stamped onto the session\'s own metadata at /viva/a2a initiate time, so this addresses one specific charge attempt even when other charges are concurrently in flight on the same order (e.g. a split payment across multiple paired terminals).
+     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity.
      * @summary Poll a charge\'s outcome by chargeId.
      * @param {string} chargeId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     paymentSessionGetChargeStatus(chargeId: string, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<ChargeStatusResponseDto>>;
+    /**
+     * Called by the paying device (e.g. a paired Munchi Pay terminal) once the Viva app-to-app session is created (sessionId known via the SDK\'s onRequiresInput callback), so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against a Viva session so its outcome can be polled.
+     * @param {RegisterChargeMappingDto} registerChargeMappingDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    paymentSessionRegisterChargeMapping(registerChargeMappingDto: RegisterChargeMappingDto, options?: AxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<void>>;
     /**
      * 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.
      * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -35758,13 +35787,21 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
      */
     initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: any): AxiosPromise<InitiateWorldlineSessionResponseDto>;
     /**
-     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity. chargeId is stamped onto the session\'s own metadata at /viva/a2a initiate time, so this addresses one specific charge attempt even when other charges are concurrently in flight on the same order (e.g. a split payment across multiple paired terminals).
+     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity.
      * @summary Poll a charge\'s outcome by chargeId.
      * @param {string} chargeId
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
      */
     paymentSessionGetChargeStatus(chargeId: string, options?: any): AxiosPromise<ChargeStatusResponseDto>;
+    /**
+     * Called by the paying device (e.g. a paired Munchi Pay terminal) once the Viva app-to-app session is created (sessionId known via the SDK\'s onRequiresInput callback), so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against a Viva session so its outcome can be polled.
+     * @param {RegisterChargeMappingDto} registerChargeMappingDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     */
+    paymentSessionRegisterChargeMapping(registerChargeMappingDto: RegisterChargeMappingDto, options?: any): AxiosPromise<void>;
     /**
      * 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.
      * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -35921,7 +35958,7 @@ export interface PaymentSessionApiInterface {
      */
     initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): AxiosPromise<InitiateWorldlineSessionResponseDto>;
     /**
-     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity. chargeId is stamped onto the session\'s own metadata at /viva/a2a initiate time, so this addresses one specific charge attempt even when other charges are concurrently in flight on the same order (e.g. a split payment across multiple paired terminals).
+     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity.
      * @summary Poll a charge\'s outcome by chargeId.
      * @param {string} chargeId
      * @param {*} [options] Override http request option.
@@ -35929,6 +35966,15 @@ export interface PaymentSessionApiInterface {
      * @memberof PaymentSessionApiInterface
      */
     paymentSessionGetChargeStatus(chargeId: string, options?: AxiosRequestConfig): AxiosPromise<ChargeStatusResponseDto>;
+    /**
+     * Called by the paying device (e.g. a paired Munchi Pay terminal) once the Viva app-to-app session is created (sessionId known via the SDK\'s onRequiresInput callback), so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against a Viva session so its outcome can be polled.
+     * @param {RegisterChargeMappingDto} registerChargeMappingDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApiInterface
+     */
+    paymentSessionRegisterChargeMapping(registerChargeMappingDto: RegisterChargeMappingDto, options?: AxiosRequestConfig): AxiosPromise<void>;
     /**
      * 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.
      * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)
@@ -36096,7 +36142,7 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
      */
     initiateWorldlineSession(initiateWorldlineSessionDto: InitiateWorldlineSessionDto, xIdempotencyKey?: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<InitiateWorldlineSessionResponseDto, any, {}>>;
     /**
-     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity. chargeId is stamped onto the session\'s own metadata at /viva/a2a initiate time, so this addresses one specific charge attempt even when other charges are concurrently in flight on the same order (e.g. a split payment across multiple paired terminals).
+     * Fallback for when the pay-terminal Ably charge_result message is lost to a flaky connection. Returns \'pending\' until the backend observes the underlying PaymentSession reach a terminal state, regardless of either device\'s connectivity.
      * @summary Poll a charge\'s outcome by chargeId.
      * @param {string} chargeId
      * @param {*} [options] Override http request option.
@@ -36104,6 +36150,15 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
      * @memberof PaymentSessionApi
      */
     paymentSessionGetChargeStatus(chargeId: string, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<ChargeStatusResponseDto, any, {}>>;
+    /**
+     * Called by the paying device (e.g. a paired Munchi Pay terminal) once the Viva app-to-app session is created (sessionId known via the SDK\'s onRequiresInput callback), so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against a Viva session so its outcome can be polled.
+     * @param {RegisterChargeMappingDto} registerChargeMappingDto
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApi
+     */
+    paymentSessionRegisterChargeMapping(registerChargeMappingDto: RegisterChargeMappingDto, options?: AxiosRequestConfig): Promise<import("axios").AxiosResponse<void, any, {}>>;
     /**
      * 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.
      * @summary Internal: long-poll Viva for a stuck payment session (Cloud Task callback)