@fiado/type-kit 3.442.0 → 3.444.0

package/_test_/unit/productCatalog/enums/refund-product-enums.test.ts

@@ -0,0 +1,18 @@
+import 'reflect-metadata';
+import { ProductTypeEnum } from '../../../../src/productCatalog/enums/ProductTypeEnum';
+import { ProductSubtypeEnum } from '../../../../src/productCatalog/enums/ProductSubtypeEnum';
+
+describe('Enums refund PCF', () => {
+  it('agrega REFUND_PCF y REFUND_PCF_REVERSE a ProductTypeEnum', () => {
+    expect(ProductTypeEnum.REFUND_PCF).toBe('REFUND_PCF');
+    expect(ProductTypeEnum.REFUND_PCF_REVERSE).toBe('REFUND_PCF_REVERSE');
+  });
+  it('agrega los 6 subtypes de refund', () => {
+    expect(ProductSubtypeEnum.REFUND_PCF_DICTAMEN_PROCEDE).toBe('DICTAMEN_PROCEDE');
+    expect(ProductSubtypeEnum.REFUND_PCF_AUTO_T2_SIN_2FA).toBe('AUTO_T2_SIN_2FA');
+    expect(ProductSubtypeEnum.REFUND_PCF_ERROR_OPERATIVO).toBe('ERROR_OPERATIVO');
+    expect(ProductSubtypeEnum.REFUND_PCF_DOMICILIACION_T1_60D).toBe('DOMICILIACION_T1_60D');
+    expect(ProductSubtypeEnum.REFUND_PCF_DOMICILIACION_T1_61_90D).toBe('DOMICILIACION_T1_61_90D');
+    expect(ProductSubtypeEnum.REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO).toBe('DICTAMEN_CON_2FA_TARDIO');
+  });
+});

package/_test_/unit/transaction/RefundChannelEnum.test.ts

@@ -0,0 +1,15 @@
+import 'reflect-metadata';
+import { RefundChannelEnum } from '../../../src/transaction';
+
+describe('RefundChannelEnum', () => {
+  it('expone INTERNAL_PCF y SPEI_OUT_MANUAL', () => {
+    expect(RefundChannelEnum.INTERNAL_PCF).toBe('INTERNAL_PCF');
+    expect(RefundChannelEnum.SPEI_OUT_MANUAL).toBe('SPEI_OUT_MANUAL');
+  });
+
+  it('no tiene valores de más', () => {
+    expect(Object.values(RefundChannelEnum).sort()).toEqual(
+      ['INTERNAL_PCF', 'SPEI_OUT_MANUAL'].sort()
+    );
+  });
+});

package/_test_/unit/transaction/RefundManualExecutionStatus.test.ts

@@ -0,0 +1,16 @@
+import 'reflect-metadata';
+import { RefundManualExecutionStatus } from '../../../src/transaction';
+
+describe('RefundManualExecutionStatus', () => {
+  it('expone PENDING_MANUAL_EXECUTION, EXECUTED, CANCELLED', () => {
+    expect(RefundManualExecutionStatus.PENDING_MANUAL_EXECUTION).toBe('PENDING_MANUAL_EXECUTION');
+    expect(RefundManualExecutionStatus.EXECUTED).toBe('EXECUTED');
+    expect(RefundManualExecutionStatus.CANCELLED).toBe('CANCELLED');
+  });
+
+  it('no tiene valores de más', () => {
+    expect(Object.values(RefundManualExecutionStatus).sort()).toEqual(
+      ['PENDING_MANUAL_EXECUTION', 'EXECUTED', 'CANCELLED'].sort()
+    );
+  });
+});

package/_test_/unit/transaction/RefundPathTypeEnum.test.ts

@@ -0,0 +1,18 @@
+import 'reflect-metadata';
+import { RefundPathTypeEnum } from '../../../src/transaction';
+
+describe('RefundPathTypeEnum', () => {
+  it('expone las 5 rutas de reintegro definidas en SP1', () => {
+    expect(RefundPathTypeEnum.DICTAMEN_PROCEDE).toBe('DICTAMEN_PROCEDE');
+    expect(RefundPathTypeEnum.AUTO_T2_SIN_2FA).toBe('AUTO_T2_SIN_2FA');
+    expect(RefundPathTypeEnum.ERROR_OPERATIVO).toBe('ERROR_OPERATIVO');
+    expect(RefundPathTypeEnum.DOMICILIACION_T1_60D).toBe('DOMICILIACION_T1_60D');
+    expect(RefundPathTypeEnum.DOMICILIACION_T1_61_90D).toBe('DOMICILIACION_T1_61_90D');
+  });
+
+  it('no tiene valores de más', () => {
+    expect(Object.values(RefundPathTypeEnum).sort()).toEqual(
+      ['DICTAMEN_PROCEDE', 'AUTO_T2_SIN_2FA', 'ERROR_OPERATIVO', 'DOMICILIACION_T1_60D', 'DOMICILIACION_T1_61_90D'].sort()
+    );
+  });
+});

package/_test_/unit/transaction/refund-dtos.test.ts

@@ -0,0 +1,78 @@
+import 'reflect-metadata';
+import { AuthorizeRefundRequest, ReverseRefundRequest, ConfirmManualExecutionRequest } from '../../../src/transaction';
+import { RefundChannelEnum, RefundPathTypeEnum } from '../../../src/transaction';
+
+describe('Refund DTOs', () => {
+  it('importa AuthorizeRefundRequest, ReverseRefundRequest, ConfirmManualExecutionRequest', () => {
+    // AuthorizeRefundRequest
+    const authRequest: AuthorizeRefundRequest = {
+      idempotencyKey: 'key-123',
+      directoryId: 'dir-456',
+      peopleId: 'person-789',
+      productCatalogId: 'MEX_REFUND_PCF',
+      operation: 'ADD',
+      amount: { total: 1000, currencyId: 'MXN' },
+      refundChannel: RefundChannelEnum.SPEI_OUT_MANUAL,
+      refundChannelData: {
+        targetClabe: '012180001232011635',
+        targetBankId: 'BBVAMXMM',
+        targetName: 'Beneficiario',
+      },
+      refundCase: {
+        pathType: RefundPathTypeEnum.DICTAMEN_PROCEDE,
+        caseFolio: 'FOLIO-001',
+        originalTransactionId: 'TX-123',
+        originalAmount: 1000,
+        originalChannel: 'SPEI_IN',
+      },
+      approval: {
+        makerUserId: 'user-maker-001',
+        checkerUserId: 'user-checker-001',
+        minuteS3Key: 's3://bucket/minute.pdf',
+      },
+      reason: 'Restitución por solicitud del cliente',
+      evidence: {
+        dictamenS3Key: 's3://bucket/dictamen.pdf',
+        incidentReportS3Key: 's3://bucket/incident.pdf',
+        objectionFormS3Key: null,
+      },
+      pldOverrideMinuteS3Key: null,
+    };
+    expect(authRequest.idempotencyKey).toBe('key-123');
+    expect(authRequest.refundChannel).toBe(RefundChannelEnum.SPEI_OUT_MANUAL);
+
+    // ReverseRefundRequest
+    const reverseRequest: ReverseRefundRequest = {
+      idempotencyKey: 'key-456',
+      directoryId: 'dir-456',
+      peopleId: 'person-789',
+      productCatalogId: 'MEX_REFUND_PCF_REVERSE',
+      operation: 'DEBIT',
+      originalRefundTransactionId: 'REFUND-TX-123',
+      originalIdempotencyKey: 'key-123',
+      amount: { total: 1000, currencyId: 'MXN' },
+      reverseReason: {
+        type: 'DICTAMEN_CON_2FA_TARDIO',
+        resolutionS3Key: 's3://bucket/resolution.pdf',
+        dictamenS3Key: 's3://bucket/dictamen-new.pdf',
+      },
+      approval: {
+        makerUserId: 'user-maker-002',
+        checkerUserId: 'user-checker-002',
+      },
+    };
+    expect(reverseRequest.originalRefundTransactionId).toBe('REFUND-TX-123');
+    expect(reverseRequest.reverseReason.type).toBe('DICTAMEN_CON_2FA_TARDIO');
+
+    // ConfirmManualExecutionRequest
+    const confirmRequest: ConfirmManualExecutionRequest = {
+      idempotencyKey: 'key-789',
+      speiTrackingKey: 'SPE-TRACK-001',
+      executedAt: '2026-09-17T22:00:00Z',
+      acuseS3Key: 's3://bucket/acuse.pdf',
+      executedByUserId: 'user-controller-001',
+    };
+    expect(confirmRequest.speiTrackingKey).toBe('SPE-TRACK-001');
+    expect(confirmRequest.executedAt).toBe('2026-09-17T22:00:00Z');
+  });
+});

package/bin/productCatalog/enums/ProductSubtypeEnum.d.ts

@@ -58,5 +58,12 @@ export declare enum ProductSubtypeEnum {
      * de pagos del proveedor.
      */
     SP_CASH_IN_CASH_IN_OXXO = "CASH_IN_OXXO",
-    SUREKEEP_BONUS_MX = "BONUS_MX"
+    SUREKEEP_BONUS_MX = "BONUS_MX",
+    STORE_PHONE = "PHONE",
+    REFUND_PCF_DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    REFUND_PCF_AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    REFUND_PCF_ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    REFUND_PCF_DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    REFUND_PCF_DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D",
+    REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO = "DICTAMEN_CON_2FA_TARDIO"
 }

package/bin/productCatalog/enums/ProductSubtypeEnum.js

@@ -75,4 +75,14 @@ var ProductSubtypeEnum;
     ProductSubtypeEnum["SP_CASH_IN_CASH_IN_OXXO"] = "CASH_IN_OXXO";
     //SUREKEEP
     ProductSubtypeEnum["SUREKEEP_BONUS_MX"] = "BONUS_MX";
+    //STORE
+    ProductSubtypeEnum["STORE_PHONE"] = "PHONE";
+    // REFUND_PCF
+    ProductSubtypeEnum["REFUND_PCF_DICTAMEN_PROCEDE"] = "DICTAMEN_PROCEDE";
+    ProductSubtypeEnum["REFUND_PCF_AUTO_T2_SIN_2FA"] = "AUTO_T2_SIN_2FA";
+    ProductSubtypeEnum["REFUND_PCF_ERROR_OPERATIVO"] = "ERROR_OPERATIVO";
+    ProductSubtypeEnum["REFUND_PCF_DOMICILIACION_T1_60D"] = "DOMICILIACION_T1_60D";
+    ProductSubtypeEnum["REFUND_PCF_DOMICILIACION_T1_61_90D"] = "DOMICILIACION_T1_61_90D";
+    // REFUND_PCF_REVERSE
+    ProductSubtypeEnum["REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO"] = "DICTAMEN_CON_2FA_TARDIO";
 })(ProductSubtypeEnum || (exports.ProductSubtypeEnum = ProductSubtypeEnum = {}));

package/bin/productCatalog/enums/ProductTypeEnum.d.ts

@@ -40,5 +40,23 @@ export declare enum ProductTypeEnum {
      * FUERA del switch de `CreateTransactionManager`: el camino por defecto es el que escribe el par
      * de asientos FiadoTx + PagoConFiadoTx.
      */
-    SUREKEEP = "SUREKEEP"
+    SUREKEEP = "SUREKEEP",
+    /**
+     * Compra de un producto físico en tienda/catálogo Fiado (ej. venta de celulares vía
+     * cell-phone-sales-business). Cobro en crédito (USD, pocket FiadoInc) o débito (MXN,
+     * PagoConfiado) según el país — ambos casos caen en el camino por defecto de
+     * `CreateTransactionManager` (no está en su switch), que ya arma `credit`/`debit` de forma
+     * data-driven por monto, no por este type.
+     */
+    STORE = "STORE",
+    /**
+     * Reembolso a cliente PCF — transacción iniciada desde dashboard de reclamaciones.
+     * Tipología: transfer SPEI out manual con aprobación de maker/checker.
+     */
+    REFUND_PCF = "REFUND_PCF",
+    /**
+     * Reversa de un reembolso anterior — se devuelve el dinero del reembolso al cliente
+     * cuando el dictamen fue incorrecto o se detectó fraude post-reembolso.
+     */
+    REFUND_PCF_REVERSE = "REFUND_PCF_REVERSE"
 }

package/bin/productCatalog/enums/ProductTypeEnum.js

@@ -45,4 +45,22 @@ var ProductTypeEnum;
      * de asientos FiadoTx + PagoConFiadoTx.
      */
     ProductTypeEnum["SUREKEEP"] = "SUREKEEP";
+    /**
+     * Compra de un producto físico en tienda/catálogo Fiado (ej. venta de celulares vía
+     * cell-phone-sales-business). Cobro en crédito (USD, pocket FiadoInc) o débito (MXN,
+     * PagoConfiado) según el país — ambos casos caen en el camino por defecto de
+     * `CreateTransactionManager` (no está en su switch), que ya arma `credit`/`debit` de forma
+     * data-driven por monto, no por este type.
+     */
+    ProductTypeEnum["STORE"] = "STORE";
+    /**
+     * Reembolso a cliente PCF — transacción iniciada desde dashboard de reclamaciones.
+     * Tipología: transfer SPEI out manual con aprobación de maker/checker.
+     */
+    ProductTypeEnum["REFUND_PCF"] = "REFUND_PCF";
+    /**
+     * Reversa de un reembolso anterior — se devuelve el dinero del reembolso al cliente
+     * cuando el dictamen fue incorrecto o se detectó fraude post-reembolso.
+     */
+    ProductTypeEnum["REFUND_PCF_REVERSE"] = "REFUND_PCF_REVERSE";
 })(ProductTypeEnum || (exports.ProductTypeEnum = ProductTypeEnum = {}));

package/bin/transaction/dtos/AuthorizeRefundRequest.d.ts

@@ -0,0 +1,38 @@
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+import { RefundPathTypeEnum } from '../enums/RefundPathTypeEnum';
+export interface AuthorizeRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF';
+    operation: 'ADD';
+    amount: {
+        total: number;
+        currencyId: 'MXN';
+    };
+    refundChannel: RefundChannelEnum;
+    refundChannelData?: {
+        targetClabe?: string;
+        targetBankId?: string;
+        targetName?: string;
+    };
+    refundCase: {
+        pathType: RefundPathTypeEnum;
+        caseFolio: string;
+        originalTransactionId: string | null;
+        originalAmount: number;
+        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'CARD' | 'DOMICILIATION_FSA';
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+        minuteS3Key: string | null;
+    };
+    reason: string;
+    evidence: {
+        dictamenS3Key: string | null;
+        incidentReportS3Key: string | null;
+        objectionFormS3Key: string | null;
+    };
+    pldOverrideMinuteS3Key: string | null;
+}

package/bin/transaction/dtos/AuthorizeRefundRequest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/transaction/dtos/ConfirmManualExecutionRequest.d.ts

@@ -0,0 +1,7 @@
+export interface ConfirmManualExecutionRequest {
+    idempotencyKey: string;
+    speiTrackingKey: string;
+    executedAt: string;
+    acuseS3Key: string;
+    executedByUserId: string;
+}

package/bin/transaction/dtos/ConfirmManualExecutionRequest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/transaction/dtos/ReverseRefundRequest.d.ts

@@ -0,0 +1,22 @@
+export interface ReverseRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF_REVERSE';
+    operation: 'DEBIT';
+    originalRefundTransactionId: string;
+    originalIdempotencyKey: string;
+    amount: {
+        total: number;
+        currencyId: 'MXN';
+    };
+    reverseReason: {
+        type: 'DICTAMEN_CON_2FA_TARDIO';
+        resolutionS3Key: string;
+        dictamenS3Key: string;
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+    };
+}

package/bin/transaction/dtos/ReverseRefundRequest.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/transaction/enums/RefundChannelEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum RefundChannelEnum {
+    INTERNAL_PCF = "INTERNAL_PCF",
+    SPEI_OUT_MANUAL = "SPEI_OUT_MANUAL"
+}

package/bin/transaction/enums/RefundChannelEnum.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundChannelEnum = void 0;
+var RefundChannelEnum;
+(function (RefundChannelEnum) {
+    RefundChannelEnum["INTERNAL_PCF"] = "INTERNAL_PCF";
+    RefundChannelEnum["SPEI_OUT_MANUAL"] = "SPEI_OUT_MANUAL";
+})(RefundChannelEnum || (exports.RefundChannelEnum = RefundChannelEnum = {}));

package/bin/transaction/enums/RefundManualExecutionStatus.d.ts

@@ -0,0 +1,5 @@
+export declare enum RefundManualExecutionStatus {
+    PENDING_MANUAL_EXECUTION = "PENDING_MANUAL_EXECUTION",
+    EXECUTED = "EXECUTED",
+    CANCELLED = "CANCELLED"
+}

package/bin/transaction/enums/RefundManualExecutionStatus.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundManualExecutionStatus = void 0;
+var RefundManualExecutionStatus;
+(function (RefundManualExecutionStatus) {
+    RefundManualExecutionStatus["PENDING_MANUAL_EXECUTION"] = "PENDING_MANUAL_EXECUTION";
+    RefundManualExecutionStatus["EXECUTED"] = "EXECUTED";
+    RefundManualExecutionStatus["CANCELLED"] = "CANCELLED";
+})(RefundManualExecutionStatus || (exports.RefundManualExecutionStatus = RefundManualExecutionStatus = {}));

package/bin/transaction/enums/RefundPathTypeEnum.d.ts

@@ -0,0 +1,7 @@
+export declare enum RefundPathTypeEnum {
+    DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D"
+}

package/bin/transaction/enums/RefundPathTypeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RefundPathTypeEnum = void 0;
+var RefundPathTypeEnum;
+(function (RefundPathTypeEnum) {
+    RefundPathTypeEnum["DICTAMEN_PROCEDE"] = "DICTAMEN_PROCEDE";
+    RefundPathTypeEnum["AUTO_T2_SIN_2FA"] = "AUTO_T2_SIN_2FA";
+    RefundPathTypeEnum["ERROR_OPERATIVO"] = "ERROR_OPERATIVO";
+    RefundPathTypeEnum["DOMICILIACION_T1_60D"] = "DOMICILIACION_T1_60D";
+    RefundPathTypeEnum["DOMICILIACION_T1_61_90D"] = "DOMICILIACION_T1_61_90D";
+})(RefundPathTypeEnum || (exports.RefundPathTypeEnum = RefundPathTypeEnum = {}));

package/bin/transaction/index.d.ts

@@ -14,6 +14,9 @@ export * from './dtos/Product';
 export * from './dtos/ProductDetail';
 export * from './dtos/Total';
 export * from './dtos/ActivityProblemGetResponse';
+export * from './dtos/AuthorizeRefundRequest';
+export * from './dtos/ReverseRefundRequest';
+export * from './dtos/ConfirmManualExecutionRequest';
 export * from './dtos/internal/BaseProviderTransaction';
 export * from './dtos/internal/BaseProviderTransactionQueryParams';
 export * from './dtos/internal/CentralPaymentsQueryParams';
@@ -33,3 +36,6 @@ export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
 export * from './enums/ActivityProblemStatusEnum';
+export * from './enums/RefundChannelEnum';
+export * from './enums/RefundPathTypeEnum';
+export * from './enums/RefundManualExecutionStatus';

package/bin/transaction/index.js

@@ -31,6 +31,9 @@ __exportStar(require("./dtos/Product"), exports);
 __exportStar(require("./dtos/ProductDetail"), exports);
 __exportStar(require("./dtos/Total"), exports);
 __exportStar(require("./dtos/ActivityProblemGetResponse"), exports);
+__exportStar(require("./dtos/AuthorizeRefundRequest"), exports);
+__exportStar(require("./dtos/ReverseRefundRequest"), exports);
+__exportStar(require("./dtos/ConfirmManualExecutionRequest"), exports);
 __exportStar(require("./dtos/internal/BaseProviderTransaction"), exports);
 __exportStar(require("./dtos/internal/BaseProviderTransactionQueryParams"), exports);
 __exportStar(require("./dtos/internal/CentralPaymentsQueryParams"), exports);
@@ -51,3 +54,6 @@ __exportStar(require("./enums/TransactionStatusEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudEnum"), exports);
 __exportStar(require("./enums/DisputeOrFraudStatusEnum"), exports);
 __exportStar(require("./enums/ActivityProblemStatusEnum"), exports);
+__exportStar(require("./enums/RefundChannelEnum"), exports);
+__exportStar(require("./enums/RefundPathTypeEnum"), exports);
+__exportStar(require("./enums/RefundManualExecutionStatus"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.442.0",
+  "version": "3.444.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -83,4 +83,17 @@ export enum ProductSubtypeEnum {
 
     //SUREKEEP
     SUREKEEP_BONUS_MX = "BONUS_MX",
+
+    //STORE
+    STORE_PHONE = "PHONE",
+
+    // REFUND_PCF
+    REFUND_PCF_DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    REFUND_PCF_AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    REFUND_PCF_ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    REFUND_PCF_DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    REFUND_PCF_DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D",
+
+    // REFUND_PCF_REVERSE
+    REFUND_PCF_REVERSE_DICTAMEN_CON_2FA_TARDIO = "DICTAMEN_CON_2FA_TARDIO",
 }

package/src/productCatalog/enums/ProductTypeEnum.ts

@@ -40,5 +40,23 @@ export enum ProductTypeEnum {
      * FUERA del switch de `CreateTransactionManager`: el camino por defecto es el que escribe el par
      * de asientos FiadoTx + PagoConFiadoTx.
      */
-    SUREKEEP = "SUREKEEP"
+    SUREKEEP = "SUREKEEP",
+    /**
+     * Compra de un producto físico en tienda/catálogo Fiado (ej. venta de celulares vía
+     * cell-phone-sales-business). Cobro en crédito (USD, pocket FiadoInc) o débito (MXN,
+     * PagoConfiado) según el país — ambos casos caen en el camino por defecto de
+     * `CreateTransactionManager` (no está en su switch), que ya arma `credit`/`debit` de forma
+     * data-driven por monto, no por este type.
+     */
+    STORE = "STORE",
+    /**
+     * Reembolso a cliente PCF — transacción iniciada desde dashboard de reclamaciones.
+     * Tipología: transfer SPEI out manual con aprobación de maker/checker.
+     */
+    REFUND_PCF = "REFUND_PCF",
+    /**
+     * Reversa de un reembolso anterior — se devuelve el dinero del reembolso al cliente
+     * cuando el dictamen fue incorrecto o se detectó fraude post-reembolso.
+     */
+    REFUND_PCF_REVERSE = "REFUND_PCF_REVERSE"
 }

package/src/transaction/dtos/AuthorizeRefundRequest.ts

@@ -0,0 +1,36 @@
+import { RefundChannelEnum } from '../enums/RefundChannelEnum';
+import { RefundPathTypeEnum } from '../enums/RefundPathTypeEnum';
+
+export interface AuthorizeRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF';
+    operation: 'ADD';
+    amount: { total: number; currencyId: 'MXN' };
+    refundChannel: RefundChannelEnum;
+    refundChannelData?: {
+        targetClabe?: string;
+        targetBankId?: string;
+        targetName?: string;
+    };
+    refundCase: {
+        pathType: RefundPathTypeEnum;
+        caseFolio: string;
+        originalTransactionId: string | null;
+        originalAmount: number;
+        originalChannel: 'PCF_P2P' | 'SPEI_IN' | 'SPEI_OUT' | 'CARD' | 'DOMICILIATION_FSA';
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+        minuteS3Key: string | null;
+    };
+    reason: string;
+    evidence: {
+        dictamenS3Key: string | null;
+        incidentReportS3Key: string | null;
+        objectionFormS3Key: string | null;
+    };
+    pldOverrideMinuteS3Key: string | null;
+}

package/src/transaction/dtos/ConfirmManualExecutionRequest.ts

@@ -0,0 +1,7 @@
+export interface ConfirmManualExecutionRequest {
+    idempotencyKey: string;
+    speiTrackingKey: string; // Clave de rastreo Banxico devuelta por BBVA
+    executedAt: string; // ISO 8601
+    acuseS3Key: string; // Comprobante SPEI subido por el Contralor
+    executedByUserId: string; // Contralor que ejecutó el SPEI
+}

package/src/transaction/dtos/ReverseRefundRequest.ts

@@ -0,0 +1,19 @@
+export interface ReverseRefundRequest {
+    idempotencyKey: string;
+    directoryId: string;
+    peopleId: string;
+    productCatalogId: 'MEX_REFUND_PCF_REVERSE';
+    operation: 'DEBIT';
+    originalRefundTransactionId: string;
+    originalIdempotencyKey: string;
+    amount: { total: number; currencyId: 'MXN' };
+    reverseReason: {
+        type: 'DICTAMEN_CON_2FA_TARDIO';
+        resolutionS3Key: string;
+        dictamenS3Key: string;
+    };
+    approval: {
+        makerUserId: string;
+        checkerUserId: string | null;
+    };
+}

package/src/transaction/enums/RefundChannelEnum.ts

@@ -0,0 +1,4 @@
+export enum RefundChannelEnum {
+    INTERNAL_PCF = "INTERNAL_PCF",
+    SPEI_OUT_MANUAL = "SPEI_OUT_MANUAL",
+}

package/src/transaction/enums/RefundManualExecutionStatus.ts

@@ -0,0 +1,5 @@
+export enum RefundManualExecutionStatus {
+    PENDING_MANUAL_EXECUTION = "PENDING_MANUAL_EXECUTION",
+    EXECUTED = "EXECUTED",
+    CANCELLED = "CANCELLED",
+}

package/src/transaction/enums/RefundPathTypeEnum.ts

@@ -0,0 +1,7 @@
+export enum RefundPathTypeEnum {
+    DICTAMEN_PROCEDE = "DICTAMEN_PROCEDE",
+    AUTO_T2_SIN_2FA = "AUTO_T2_SIN_2FA",
+    ERROR_OPERATIVO = "ERROR_OPERATIVO",
+    DOMICILIACION_T1_60D = "DOMICILIACION_T1_60D",
+    DOMICILIACION_T1_61_90D = "DOMICILIACION_T1_61_90D",
+}

package/src/transaction/index.ts

@@ -15,6 +15,9 @@ export * from './dtos/Product';
 export * from './dtos/ProductDetail';
 export * from './dtos/Total';
 export * from './dtos/ActivityProblemGetResponse';
+export * from './dtos/AuthorizeRefundRequest';
+export * from './dtos/ReverseRefundRequest';
+export * from './dtos/ConfirmManualExecutionRequest';
 
 export * from './dtos/internal/BaseProviderTransaction';
 export * from './dtos/internal/BaseProviderTransactionQueryParams';
@@ -38,3 +41,6 @@ export * from './enums/TransactionStatusEnum';
 export * from './enums/DisputeOrFraudEnum';
 export * from './enums/DisputeOrFraudStatusEnum';
 export * from './enums/ActivityProblemStatusEnum';
+export * from './enums/RefundChannelEnum';
+export * from './enums/RefundPathTypeEnum';
+export * from './enums/RefundManualExecutionStatus';