@munchi_oy/core 1.9.96 → 1.9.97

package/dist/generated/api.d.ts

@@ -2677,6 +2677,42 @@ export interface ChargeDtoPaymentMethodDetails {
      */
     'affirmDetails'?: PaymentMethodDetailsDtoAffirmDetails;
 }
+/**
+ *
+ * @export
+ * @enum {string}
+ */
+export declare const ChargeStatusEnum: {
+    readonly Pending: "pending";
+    readonly Success: "success";
+    readonly Failure: "failure";
+};
+export type ChargeStatusEnum = typeof ChargeStatusEnum[keyof typeof ChargeStatusEnum];
+/**
+ *
+ * @export
+ * @interface ChargeStatusResponseDto
+ */
+export interface ChargeStatusResponseDto {
+    /**
+     *
+     * @type {ChargeStatusEnum}
+     * @memberof ChargeStatusResponseDto
+     */
+    'status': ChargeStatusEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof ChargeStatusResponseDto
+     */
+    'transactionId'?: string | null;
+    /**
+     *
+     * @type {string}
+     * @memberof ChargeStatusResponseDto
+     */
+    'errorCode'?: string | null;
+}
 /**
  *
  * @export
@@ -6917,12 +6953,6 @@ export interface InitiateVivaSessionDto {
      * @memberof InitiateVivaSessionDto
      */
     'splitContext'?: CreateManualSessionDtoSplitContext;
-    /**
-     * Paired Munchi Pay terminal id (from @munchi_oy/pay-terminal-protocol pairing) that should execute this app-to-app charge. Bound onto the session so the paired terminal is discoverable/auditable; the POS still owns polling as source of truth. Distinct from the Viva cloud-terminal hardware id.
-     * @type {string}
-     * @memberof InitiateVivaSessionDto
-     */
-    'payTerminalId'?: string;
 }
 /**
  *
@@ -19266,6 +19296,31 @@ 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 order this charge belongs to (matches the Viva session\'s referenceId).
+     * @type {string}
+     * @memberof RegisterChargeMappingDto
+     */
+    'orderId': string;
+    /**
+     * The business the order belongs to.
+     * @type {number}
+     * @memberof RegisterChargeMappingDto
+     */
+    'businessId': number;
+}
 /**
  *
  * @export
@@ -35411,6 +35466,22 @@ export declare const PaymentSessionApiAxiosParamCreator: (configuration?: Config
      * @throws {RequiredError}
      */
     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.
+     * @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) right as it starts a charge relayed from the POS over Ably, so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against an order 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)
@@ -35558,6 +35629,22 @@ export declare const PaymentSessionApiFp: (configuration?: Configuration) => {
      * @throws {RequiredError}
      */
     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.
+     * @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) right as it starts a charge relayed from the POS over Ably, so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against an order 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)
@@ -35705,6 +35792,22 @@ export declare const PaymentSessionApiFactory: (configuration?: Configuration, b
      * @throws {RequiredError}
      */
     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.
+     * @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) right as it starts a charge relayed from the POS over Ably, so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against an order 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)
@@ -35860,6 +35963,24 @@ export interface PaymentSessionApiInterface {
      * @memberof 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.
+     * @summary Poll a charge\'s outcome by chargeId.
+     * @param {string} chargeId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PaymentSessionApiInterface
+     */
+    paymentSessionGetChargeStatus(chargeId: string, options?: AxiosRequestConfig): AxiosPromise<ChargeStatusResponseDto>;
+    /**
+     * Called by the paying device (e.g. a paired Munchi Pay terminal) right as it starts a charge relayed from the POS over Ably, so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against an order 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)
@@ -36026,6 +36147,24 @@ export declare class PaymentSessionApi extends BaseAPI implements PaymentSession
      * @memberof PaymentSessionApi
      */
     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.
+     * @summary Poll a charge\'s outcome by chargeId.
+     * @param {string} chargeId
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @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) right as it starts a charge relayed from the POS over Ably, so the POS can fall back to polling if the Ably charge_result message never arrives.
+     * @summary Register a POS-generated chargeId against an order 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)