@fiado/type-kit 3.120.0 → 3.122.0

package/bin/remittance/dtos/internal/RemittanceCreditBackRequest.d.ts

@@ -0,0 +1,28 @@
+import { RemittanceCancelledByEnum } from "../../enums/RemittanceCancelledByEnum";
+import { RemittanceCancelOutcomeEnum } from "../../enums/RemittanceCancelOutcomeEnum";
+import { FeeAbsorbedByEnum } from "../../enums/FeeAbsorbedByEnum";
+/**
+ * Request del credit-back de cancelacion. Lo emite uniteller-connector (cron F8)
+ * hacia el endpoint privado del processor POST remittance/credit-back, SOLO cuando
+ * UNIR confirma el outcome terminal (fondos de vuelta en el Wlp Wallet).
+ */
+export declare class RemittanceCreditBackRequest {
+    /** Llave de idempotencia del credit-back (= marketplaceTransactionNumber). */
+    idempotencyKey: string;
+    /** Transaction number de UNIR (trazabilidad). */
+    transactionNumber: string;
+    /** Tx del processor; sirve de relatedTransactionId del chargeback + correlacion /trx. */
+    marketplaceTransactionNumber: string;
+    /** Para resolver la cuenta CP del usuario (externalAccountId del chargeback). */
+    directoryId: string;
+    /** Monto principal (siempre se acredita). */
+    principalAmount: number;
+    /** Service fee de la remesa (se acredita solo si feeAbsorbedBy = FIADO). */
+    serviceFeeAmount: number;
+    currencyId: string;
+    cancelledBy: RemittanceCancelledByEnum;
+    cancelOutcome: RemittanceCancelOutcomeEnum;
+    feeAbsorbedBy: FeeAbsorbedByEnum;
+    cancelRequestedAt?: string;
+    cancelConfirmedAt?: string;
+}

package/bin/remittance/dtos/internal/RemittanceCreditBackRequest.js

@@ -0,0 +1,80 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceCreditBackRequest = void 0;
+const class_validator_1 = require("class-validator");
+const RemittanceCancelledByEnum_1 = require("../../enums/RemittanceCancelledByEnum");
+const RemittanceCancelOutcomeEnum_1 = require("../../enums/RemittanceCancelOutcomeEnum");
+const FeeAbsorbedByEnum_1 = require("../../enums/FeeAbsorbedByEnum");
+/**
+ * Request del credit-back de cancelacion. Lo emite uniteller-connector (cron F8)
+ * hacia el endpoint privado del processor POST remittance/credit-back, SOLO cuando
+ * UNIR confirma el outcome terminal (fondos de vuelta en el Wlp Wallet).
+ */
+class RemittanceCreditBackRequest {
+}
+exports.RemittanceCreditBackRequest = RemittanceCreditBackRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "transactionNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "marketplaceTransactionNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], RemittanceCreditBackRequest.prototype, "principalAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], RemittanceCreditBackRequest.prototype, "serviceFeeAmount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "currencyId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(RemittanceCancelledByEnum_1.RemittanceCancelledByEnum),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelledBy", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(RemittanceCancelOutcomeEnum_1.RemittanceCancelOutcomeEnum),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelOutcome", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(FeeAbsorbedByEnum_1.FeeAbsorbedByEnum),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "feeAbsorbedBy", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelRequestedAt", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], RemittanceCreditBackRequest.prototype, "cancelConfirmedAt", void 0);

package/bin/remittance/dtos/internal/RemittanceCreditBackResponse.d.ts

@@ -0,0 +1,12 @@
+import { RemittanceTxStatus } from "../../enums/RemittanceTxStatus";
+/** Respuesta del credit-back: confirma el credito ejecutado en CP + estado final. */
+export declare class RemittanceCreditBackResponse {
+    /** Estado final de la remesa tras el credit-back (CANCELLED si VOID, REFUND si REFUND). */
+    status: RemittanceTxStatus;
+    /** Monto efectivamente acreditado al cliente. */
+    creditedAmount: number;
+    /** Id del credito generado en CP (chargeback) — para auditoria/conciliacion. */
+    cpCreditTransactionId?: string;
+    /** True si el credit-back ya existia (idempotencia) y no se re-ejecuto. */
+    alreadyProcessed: boolean;
+}

package/bin/remittance/dtos/internal/RemittanceCreditBackResponse.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceCreditBackResponse = void 0;
+/** Respuesta del credit-back: confirma el credito ejecutado en CP + estado final. */
+class RemittanceCreditBackResponse {
+}
+exports.RemittanceCreditBackResponse = RemittanceCreditBackResponse;

package/bin/remittance/enums/FeeAbsorbedByEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum FeeAbsorbedByEnum {
+    CLIENT = "CLIENT",// User Cancel: el cliente pierde el service fee
+    FIADO = "FIADO"
+}

package/bin/remittance/enums/FeeAbsorbedByEnum.js

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

package/bin/remittance/enums/RemittanceCancelOutcomeEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum RemittanceCancelOutcomeEnum {
+    VOID = "VOID",// pre-settlement UNIR → se muestra CANCELLED
+    REFUND = "REFUND"
+}

package/bin/remittance/enums/RemittanceCancelOutcomeEnum.js

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

package/bin/remittance/enums/RemittanceCancelledByEnum.d.ts

@@ -0,0 +1,4 @@
+export declare enum RemittanceCancelledByEnum {
+    USER = "USER",
+    SYSTEM = "SYSTEM"
+}

package/bin/remittance/enums/RemittanceCancelledByEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemittanceCancelledByEnum = void 0;
+var RemittanceCancelledByEnum;
+(function (RemittanceCancelledByEnum) {
+    RemittanceCancelledByEnum["USER"] = "USER";
+    RemittanceCancelledByEnum["SYSTEM"] = "SYSTEM";
+    // FIADO_ERROR — diferido a fase posterior (sin flujo Fiado que cancele en v1).
+})(RemittanceCancelledByEnum || (exports.RemittanceCancelledByEnum = RemittanceCancelledByEnum = {}));

package/bin/remittance/enums/RemittanceTxStatus.d.ts

@@ -3,6 +3,7 @@ export declare enum RemittanceTxStatus {
     PAYABLE = "PAYABLE",
     PAID = "PAID",
     HOLD = "HOLD",
+    CANCELLATION_IN_PROGRESS = "CANCELLATION_IN_PROGRESS",// intermedio: cancel aceptado, esperando settlement + credit-back
     CANCELLED = "CANCELLED",
     REFUND = "REFUND"
 }

package/bin/remittance/enums/RemittanceTxStatus.js

@@ -7,6 +7,7 @@ var RemittanceTxStatus;
     RemittanceTxStatus["PAYABLE"] = "PAYABLE";
     RemittanceTxStatus["PAID"] = "PAID";
     RemittanceTxStatus["HOLD"] = "HOLD";
+    RemittanceTxStatus["CANCELLATION_IN_PROGRESS"] = "CANCELLATION_IN_PROGRESS";
     RemittanceTxStatus["CANCELLED"] = "CANCELLED";
     RemittanceTxStatus["REFUND"] = "REFUND";
 })(RemittanceTxStatus || (exports.RemittanceTxStatus = RemittanceTxStatus = {}));

package/bin/remittance/enums/index.d.ts

@@ -2,3 +2,6 @@ export * from "./ReceptionMethod";
 export * from "./RemittanceTxStatus";
 export * from "./RemittanceCountryISO";
 export * from "./RemittanceUserState";
+export * from "./RemittanceCancelledByEnum";
+export * from "./RemittanceCancelOutcomeEnum";
+export * from "./FeeAbsorbedByEnum";

package/bin/remittance/enums/index.js

@@ -18,3 +18,6 @@ __exportStar(require("./ReceptionMethod"), exports);
 __exportStar(require("./RemittanceTxStatus"), exports);
 __exportStar(require("./RemittanceCountryISO"), exports);
 __exportStar(require("./RemittanceUserState"), exports);
+__exportStar(require("./RemittanceCancelledByEnum"), exports);
+__exportStar(require("./RemittanceCancelOutcomeEnum"), exports);
+__exportStar(require("./FeeAbsorbedByEnum"), exports);

package/bin/remittance/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./enums";
 export * from "./dtos";
+export * from "./dtos/internal/RemittanceCreditBackRequest";
+export * from "./dtos/internal/RemittanceCreditBackResponse";

package/bin/remittance/index.js

@@ -18,3 +18,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enums"), exports);
 // DTOs
 __exportStar(require("./dtos"), exports);
+__exportStar(require("./dtos/internal/RemittanceCreditBackRequest"), exports);
+__exportStar(require("./dtos/internal/RemittanceCreditBackResponse"), exports);

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.d.ts

@@ -0,0 +1,6 @@
+export declare class CancelFundingReferenceRequest {
+    /** Referencia Passport (PK de EqualityFundingReference_GT). */
+    reference: string;
+    directoryId: string;
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js

@@ -0,0 +1,31 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingReferenceRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelFundingReferenceRequest {
+}
+exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelFundingReferenceResponse {
+    reference: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingReferenceResponse = void 0;
+class CancelFundingReferenceResponse {
+}
+exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;

package/bin/walletFunding/dtos/CancelFundingRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `reference` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+export declare class CancelFundingRequest {
+    idempotencyKey: string;
+    providerModuleName: string;
+}

package/bin/walletFunding/dtos/CancelFundingRequest.js

@@ -0,0 +1,33 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `reference` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+class CancelFundingRequest {
+}
+exports.CancelFundingRequest = CancelFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "providerModuleName", void 0);

package/bin/walletFunding/dtos/CancelFundingResponse.d.ts

@@ -0,0 +1,14 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+export declare class CancelFundingResponse {
+    reference: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}

package/bin/walletFunding/dtos/CancelFundingResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingResponse = void 0;
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+class CancelFundingResponse {
+}
+exports.CancelFundingResponse = CancelFundingResponse;

package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts

@@ -0,0 +1,3 @@
+export declare class CancelWalletFundingRequest {
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -0,0 +1,21 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelWalletFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelWalletFundingRequest {
+}
+exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelWalletFundingResponse {
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    reference?: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelWalletFundingResponse = void 0;
+class CancelWalletFundingResponse {
+}
+exports.CancelWalletFundingResponse = CancelWalletFundingResponse;

package/bin/walletFunding/dtos/SettleWalletFundingRequest.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Request del endpoint `POST /settlements` del lambda `wallet-funding-settlement`.
+ *
+ * Ejecuta el WRITE atómico (TransactWriteItems 2 items) que acredita el
+ * balance del wallet Y marca el payment del provider como APPLIED, todo
+ * en una única transacción ACID DDB single-region.
+ *
+ * Idempotente por `ConditionExpression: status = CONSULTED` sobre el
+ * payment row del provider. Si el reintento llega y el row ya está en
+ * APPLIED, el settlement devuelve `alreadySettled=true` con el folio
+ * cacheado sin re-creditar.
+ *
+ * Caller canónico: `equality-connector.WebhookPaymentManager` post
+ * `processor.walletFundingValidate()`. Ver spec 15.
+ */
+export declare class SettleWalletFundingRequest {
+    /** Nombre canónico del provider cash-in. V1: "equality". Futuros: "openpay", etc. */
+    providerName: string;
+    /**
+     * Identificador de la transacción en el provider. Para Equality es
+     * `equalityTransactionNumber` (PK de `EqualityFundingPayment_GT`).
+     */
+    providerTxId: string;
+    /** Referencia del payment row (ej. la `reference` de Equality). */
+    providerReference: string;
+    directoryId: string;
+    /** PK de la cuenta PCF (AccountPagoConfiado_GT.id) destino del crédito. */
+    accountId: string;
+    amount: number;
+    currencyCode: string;
+    /**
+     * Folio del processor (campo Alfanumérico según doc Passport). Pre-generado
+     * por `processor.walletFundingValidate()` y reenviado al settlement para
+     * persistirlo en el payment row como `processorTransactionNumber`.
+     */
+    processorTransactionNumber: string;
+    /**
+     * Snapshot del webhook recibido del provider. Opcional — se persiste en
+     * `webhookResponseRaw` del payment row para auditoría. NO load-bearing
+     * para la idempotencia ni el flow.
+     */
+    webhookEcho?: Record<string, unknown>;
+}

package/bin/walletFunding/dtos/SettleWalletFundingRequest.js

@@ -0,0 +1,76 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettleWalletFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request del endpoint `POST /settlements` del lambda `wallet-funding-settlement`.
+ *
+ * Ejecuta el WRITE atómico (TransactWriteItems 2 items) que acredita el
+ * balance del wallet Y marca el payment del provider como APPLIED, todo
+ * en una única transacción ACID DDB single-region.
+ *
+ * Idempotente por `ConditionExpression: status = CONSULTED` sobre el
+ * payment row del provider. Si el reintento llega y el row ya está en
+ * APPLIED, el settlement devuelve `alreadySettled=true` con el folio
+ * cacheado sin re-creditar.
+ *
+ * Caller canónico: `equality-connector.WebhookPaymentManager` post
+ * `processor.walletFundingValidate()`. Ver spec 15.
+ */
+class SettleWalletFundingRequest {
+}
+exports.SettleWalletFundingRequest = SettleWalletFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(32),
+    __metadata("design:type", String)
+], SettleWalletFundingRequest.prototype, "providerName", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], SettleWalletFundingRequest.prototype, "providerTxId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], SettleWalletFundingRequest.prototype, "providerReference", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], SettleWalletFundingRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], SettleWalletFundingRequest.prototype, "accountId", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], SettleWalletFundingRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 3),
+    __metadata("design:type", String)
+], SettleWalletFundingRequest.prototype, "currencyCode", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], SettleWalletFundingRequest.prototype, "processorTransactionNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], SettleWalletFundingRequest.prototype, "webhookEcho", void 0);

package/bin/walletFunding/dtos/SettleWalletFundingResponse.d.ts

@@ -0,0 +1,36 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { SettlementErrorCodeEnum } from "../enums/SettlementErrorCodeEnum";
+/**
+ * Response del endpoint `POST /settlements`. Indica si el settlement se
+ * ejecutó exitosamente (APPROVED) o fue rechazado (REJECTED) con un
+ * `errorCode` específico.
+ *
+ * Estado APPROVED:
+ *  - El TransactWriteItems se commiteó atómicamente.
+ *  - Balance acreditado + status del payment en APPLIED.
+ *  - `alreadySettled=false` (primera ejecución) o `alreadySettled=true`
+ *    (reintento idempotent — el row ya estaba en APPLIED).
+ *
+ * Estado REJECTED:
+ *  - El TransactWriteItems NO se ejecutó (pre-check falló) o falló
+ *    irrecuperablemente. Caller debe responder REJECTED al provider y
+ *    marcar el payment en `QUEUED_FOR_REFUND` para gestión manual.
+ *
+ * Ver spec 15.
+ */
+export interface SettleWalletFundingResponse {
+    status: BenefitPaymentStatusEnum;
+    /**
+     * `true` si el TransactWriteItems no se ejecutó porque el row ya estaba
+     * en APPLIED (idempotent fast path). `false` si fue la primera ejecución
+     * que efectivamente movió saldo.
+     */
+    alreadySettled: boolean;
+    /**
+     * Folio del processor devuelto al caller. En idempotent hit es el folio
+     * cacheado del row APPLIED previo (NO el del request actual).
+     */
+    processorTransactionNumber: string;
+    errorCode?: SettlementErrorCodeEnum;
+    message?: string;
+}

package/bin/walletFunding/dtos/SettleWalletFundingResponse.js

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

package/bin/walletFunding/dtos/index.d.ts

@@ -19,3 +19,5 @@ export * from "./ReverseWalletFundingRequest";
 export * from "./ReverseWalletFundingResponse";
 export * from "./AuthorizeFundingRequest";
 export * from "./AuthorizeFundingResponse";
+export * from "./SettleWalletFundingRequest";
+export * from "./SettleWalletFundingResponse";

package/bin/walletFunding/dtos/index.js

@@ -35,3 +35,5 @@ __exportStar(require("./ReverseWalletFundingRequest"), exports);
 __exportStar(require("./ReverseWalletFundingResponse"), exports);
 __exportStar(require("./AuthorizeFundingRequest"), exports);
 __exportStar(require("./AuthorizeFundingResponse"), exports);
+__exportStar(require("./SettleWalletFundingRequest"), exports);
+__exportStar(require("./SettleWalletFundingResponse"), exports);

package/bin/walletFunding/enums/SettlementErrorCodeEnum.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Códigos de error del lambda `wallet-funding-settlement`.
+ *
+ * Distintos a `WalletFundingErrorCodeEnum` — esos son del flow del processor
+ * (validaciones PCF, AML, caps). Estos son específicos del settlement:
+ * estado del payment row + integridad del TransactWriteItems.
+ *
+ * Ver spec 15 §4.5 (flujo interno) + §8 (edge cases).
+ */
+export declare enum SettlementErrorCodeEnum {
+    /** El payment row no existe en la tabla del provider. Bug del caller (debió crear CONSULTED antes). */
+    PAYMENT_NOT_FOUND = "PAYMENT_NOT_FOUND",
+    /** El payment row está en estado terminal (FAILED, QUEUED_FOR_REFUND, REJECTED). No procede acreditar. */
+    PAYMENT_IN_TERMINAL_STATE = "PAYMENT_IN_TERMINAL_STATE",
+    /** La cuenta PCF no existe o no está accesible. */
+    ACCOUNT_NOT_FOUND = "ACCOUNT_NOT_FOUND",
+    /** El TransactWriteItems falló por razón no recuperable (no ConditionalCheckFailed esperado). */
+    TRANSACT_WRITE_FAILED = "TRANSACT_WRITE_FAILED",
+    /** El providerName del request no está registrado en el ProviderRegistry del settlement. */
+    PROVIDER_NOT_SUPPORTED = "PROVIDER_NOT_SUPPORTED",
+    /** El amount del request difiere del paymentAmount persistido en el row CONSULTED. Posible tampering. */
+    AMOUNT_MISMATCH = "AMOUNT_MISMATCH",
+    /** Error interno no clasificado. Caller debe loggear + alarmar. */
+    INTERNAL_ERROR = "INTERNAL_ERROR"
+}

package/bin/walletFunding/enums/SettlementErrorCodeEnum.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SettlementErrorCodeEnum = void 0;
+/**
+ * Códigos de error del lambda `wallet-funding-settlement`.
+ *
+ * Distintos a `WalletFundingErrorCodeEnum` — esos son del flow del processor
+ * (validaciones PCF, AML, caps). Estos son específicos del settlement:
+ * estado del payment row + integridad del TransactWriteItems.
+ *
+ * Ver spec 15 §4.5 (flujo interno) + §8 (edge cases).
+ */
+var SettlementErrorCodeEnum;
+(function (SettlementErrorCodeEnum) {
+    /** El payment row no existe en la tabla del provider. Bug del caller (debió crear CONSULTED antes). */
+    SettlementErrorCodeEnum["PAYMENT_NOT_FOUND"] = "PAYMENT_NOT_FOUND";
+    /** El payment row está en estado terminal (FAILED, QUEUED_FOR_REFUND, REJECTED). No procede acreditar. */
+    SettlementErrorCodeEnum["PAYMENT_IN_TERMINAL_STATE"] = "PAYMENT_IN_TERMINAL_STATE";
+    /** La cuenta PCF no existe o no está accesible. */
+    SettlementErrorCodeEnum["ACCOUNT_NOT_FOUND"] = "ACCOUNT_NOT_FOUND";
+    /** El TransactWriteItems falló por razón no recuperable (no ConditionalCheckFailed esperado). */
+    SettlementErrorCodeEnum["TRANSACT_WRITE_FAILED"] = "TRANSACT_WRITE_FAILED";
+    /** El providerName del request no está registrado en el ProviderRegistry del settlement. */
+    SettlementErrorCodeEnum["PROVIDER_NOT_SUPPORTED"] = "PROVIDER_NOT_SUPPORTED";
+    /** El amount del request difiere del paymentAmount persistido en el row CONSULTED. Posible tampering. */
+    SettlementErrorCodeEnum["AMOUNT_MISMATCH"] = "AMOUNT_MISMATCH";
+    /** Error interno no clasificado. Caller debe loggear + alarmar. */
+    SettlementErrorCodeEnum["INTERNAL_ERROR"] = "INTERNAL_ERROR";
+})(SettlementErrorCodeEnum || (exports.SettlementErrorCodeEnum = SettlementErrorCodeEnum = {}));