@fiado/type-kit 3.461.0 → 3.463.0

package/_test_/unit/loanCredit/customerPaymentDtos.test.ts

@@ -0,0 +1,87 @@
+import 'reflect-metadata';
+import {
+    LoanAdHocChargeKindEnum,
+    LoanAdHocChargeRequested,
+    LoanCustomerPaymentOptions,
+    LoanCustomerPaymentResult,
+    LoanCustomerPaymentTypeEnum,
+    LoanNextInstallmentModeEnum,
+    LoanPaymentOptionUnavailableReasonEnum,
+} from '../../../src/loanCredit/index';
+import { CollectionResultStatus } from '../../../src/collection/enums/CollectionResultStatus';
+
+describe('loanCredit — opciones y resultado del pago del cliente', () => {
+    it('la liquidación trae su cotización y el monto es el de la cotización', () => {
+        const options: LoanCustomerPaymentOptions = {
+            creditId: 'CR-1',
+            nextInstallment: {
+                available: true,
+                amountCents: 105000,
+                mode: LoanNextInstallmentModeEnum.ADVANCE,
+                installmentNumber: 4,
+                dueDate: '2026-10-01',
+            },
+            advance: { available: false, unavailableReason: LoanPaymentOptionUnavailableReasonEnum.NOT_AVAILABLE_YET },
+            settlement: {
+                available: true,
+                amountCents: 912345,
+                quote: {
+                    creditId: 'CR-1',
+                    overdueInstallmentsCents: 0,
+                    outstandingCapitalCents: 890000,
+                    currentPeriodInterestCents: 19263,
+                    currentPeriodInterestIvaCents: 3082,
+                    elapsedDays: 3,
+                    periodDays: 7,
+                    settlementAmountCents: 912345,
+                    quotedAt: '2026-09-24T15:00:00.000Z',
+                },
+                savingsCents: 32655,
+            },
+        };
+
+        expect(options.settlement.quote?.settlementAmountCents).toBe(options.settlement.amountCents);
+        expect(options.pendingCharge).toBeUndefined();
+    });
+
+    it('un cargo en curso se informa con su tipo y su monto', () => {
+        const blocked = { available: false, unavailableReason: LoanPaymentOptionUnavailableReasonEnum.PAYMENT_IN_PROGRESS };
+        const options: LoanCustomerPaymentOptions = {
+            creditId: 'CR-1',
+            pendingCharge: { kind: LoanAdHocChargeKindEnum.ADVANCE, amountCents: 105000 },
+            nextInstallment: blocked,
+            advance: blocked,
+            settlement: blocked,
+        };
+
+        expect(options.pendingCharge?.kind).toBe('ADVANCE');
+        expect(options.nextInstallment.amountCents).toBeUndefined();
+    });
+
+    it('el resultado del pago puede venir sin la respuesta del motor', () => {
+        const result: LoanCustomerPaymentResult = {
+            creditId: 'CR-1',
+            type: LoanCustomerPaymentTypeEnum.NEXT_INSTALLMENT,
+            chargeId: 'CR-1#ADVANCE#1',
+            amountCents: 105000,
+        };
+
+        expect(result.collection).toBeUndefined();
+    });
+
+    it('el 202 del cargo ad hoc suma la respuesta del motor como campo opcional', () => {
+        const withoutCollection: LoanAdHocChargeRequested = {
+            creditId: 'CR-1',
+            chargeKind: LoanAdHocChargeKindEnum.ADVANCE,
+            chargeId: 'CR-1#ADVANCE#1',
+            amountCents: 105000,
+        };
+        const withCollection: LoanAdHocChargeRequested = {
+            ...withoutCollection,
+            collection: { status: CollectionResultStatus.PARTIAL, amountCollectedCents: 50000 },
+        };
+
+        expect(withoutCollection.collection).toBeUndefined();
+        expect(withCollection.collection?.amountCollectedCents).toBe(50000);
+    });
+});

package/_test_/unit/loanCredit/dtos/createCustomerPaymentRequest.test.ts

@@ -0,0 +1,78 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { LoanCredit } from '../../../../src/index';
+import {
+    CreateCustomerPaymentRequest,
+    LoanCustomerPaymentTypeEnum,
+    LoanNextInstallmentModeEnum,
+    LoanPaymentOptionUnavailableReasonEnum,
+} from '../../../../src/loanCredit/index';
+
+const sortedValues = (enumObject: Record<string, string>) => Object.values(enumObject).sort();
+
+const errorProperties = async (body: object): Promise<string[]> => {
+    const dto = plainToInstance(CreateCustomerPaymentRequest, body);
+    const errors = await validate(dto, { whitelist: true, forbidNonWhitelisted: false });
+    return errors.map(error => error.property);
+};
+
+const VALID = {
+    type: LoanCustomerPaymentTypeEnum.SETTLEMENT,
+    expectedAmountCents: 912345,
+    idempotencyKey: '3f1c2a9e-8b7d-4c6e-9f10-2a3b4c5d6e7f',
+};
+
+describe.each([
+    ['LoanCustomerPaymentTypeEnum', LoanCustomerPaymentTypeEnum, ['NEXT_INSTALLMENT', 'SETTLEMENT']],
+    ['LoanNextInstallmentModeEnum', LoanNextInstallmentModeEnum, ['ADVANCE', 'COLLECT_DUE']],
+    [
+        'LoanPaymentOptionUnavailableReasonEnum',
+        LoanPaymentOptionUnavailableReasonEnum,
+        ['PAYMENT_IN_PROGRESS', 'CREDIT_NOT_CURRENT', 'USE_SETTLEMENT', 'NOT_AVAILABLE_YET', 'CREDIT_CLOSED'],
+    ],
+])('%s', (_name, enumObject, expected) => {
+    it('tiene exactamente los valores del contrato', () => {
+        expect(sortedValues(enumObject)).toEqual([...expected].sort());
+    });
+
+    it('cada clave es igual a su valor', () => {
+        for (const [key, value] of Object.entries(enumObject)) {
+            expect(key).toBe(value);
+        }
+    });
+});
+
+describe('CreateCustomerPaymentRequest', () => {
+    it.each([[LoanCustomerPaymentTypeEnum.NEXT_INSTALLMENT], [LoanCustomerPaymentTypeEnum.SETTLEMENT]])(
+        'acepta el tipo %s',
+        async type => {
+            expect(await errorProperties({ ...VALID, type })).toEqual([]);
+        },
+    );
+
+    it('exige tipo, monto esperado y llave de idempotencia', async () => {
+        expect(await errorProperties({})).toEqual(
+            expect.arrayContaining(['type', 'expectedAmountCents', 'idempotencyKey']),
+        );
+    });
+
+    it.each([['ADVANCE'], ['PARTIAL']])('rechaza el tipo %s', async type => {
+        expect(await errorProperties({ ...VALID, type })).toEqual(['type']);
+    });
+
+    it.each([[0], [-100], [10.5], ['912345']])('rechaza el monto %p', async expectedAmountCents => {
+        expect(await errorProperties({ ...VALID, expectedAmountCents })).toEqual(['expectedAmountCents']);
+    });
+
+    it.each([['abc'], [''], [123]])('rechaza la llave %p', async idempotencyKey => {
+        expect(await errorProperties({ ...VALID, idempotencyKey })).toEqual(['idempotencyKey']);
+    });
+});
+
+describe('export por el index raíz', () => {
+    it('expone el request y sus enums en el namespace LoanCredit', () => {
+        expect(LoanCredit.CreateCustomerPaymentRequest).toBeDefined();
+        expect(LoanCredit.LoanCustomerPaymentTypeEnum.SETTLEMENT).toBe('SETTLEMENT');
+    });
+});

package/_test_/unit/retailLoan/paymentContract.test.ts

@@ -0,0 +1,128 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { RetailLoan } from '../../../src/index';
+import {
+    CreateMyPaymentRequest,
+    CreateMyPaymentResponse,
+    MyCollectionOutcomeEnum,
+    MyNextInstallmentModeEnum,
+    MyPaymentOptions,
+    MyPaymentTypeEnum,
+    MyPaymentUnavailableReasonEnum,
+} from '../../../src/retailLoan/index';
+import { LoanNextInstallmentModeEnum, LoanPaymentOptionUnavailableReasonEnum } from '../../../src/loanCredit/index';
+
+const sortedValues = (enumObject: Record<string, string>) => Object.values(enumObject).sort();
+
+const errorProperties = async (body: object): Promise<string[]> => {
+    const dto = plainToInstance(CreateMyPaymentRequest, body);
+    const errors = await validate(dto, { whitelist: true, forbidNonWhitelisted: false });
+    return errors.map(error => error.property);
+};
+
+describe.each([
+    ['MyPaymentTypeEnum', MyPaymentTypeEnum, ['NEXT_INSTALLMENT', 'ADVANCE', 'SETTLEMENT']],
+    ['MyNextInstallmentModeEnum', MyNextInstallmentModeEnum, ['ADVANCE', 'COLLECT_DUE']],
+    [
+        'MyPaymentUnavailableReasonEnum',
+        MyPaymentUnavailableReasonEnum,
+        ['PAYMENT_IN_PROGRESS', 'CREDIT_NOT_CURRENT', 'USE_SETTLEMENT', 'NOT_AVAILABLE_YET', 'CREDIT_CLOSED'],
+    ],
+    ['MyCollectionOutcomeEnum', MyCollectionOutcomeEnum, ['COLLECTED', 'PARTIAL', 'NOT_COLLECTED', 'UNKNOWN']],
+])('%s', (_name, enumObject, expected) => {
+    it('tiene exactamente los valores del contrato', () => {
+        expect(sortedValues(enumObject)).toEqual([...expected].sort());
+    });
+
+    it('cada clave es igual a su valor', () => {
+        for (const [key, value] of Object.entries(enumObject)) {
+            expect(key).toBe(value);
+        }
+    });
+});
+
+describe('paridad con el contrato privado de loan-credit', () => {
+    it('los motivos de no disponible son los mismos', () => {
+        expect(sortedValues(MyPaymentUnavailableReasonEnum)).toEqual(sortedValues(LoanPaymentOptionUnavailableReasonEnum));
+    });
+
+    it('los modos de la siguiente cuota son los mismos', () => {
+        expect(sortedValues(MyNextInstallmentModeEnum)).toEqual(sortedValues(LoanNextInstallmentModeEnum));
+    });
+});
+
+describe('CreateMyPaymentRequest', () => {
+    it.each([
+        [{ type: MyPaymentTypeEnum.NEXT_INSTALLMENT, expectedAmount: 1050 }],
+        [{ type: MyPaymentTypeEnum.SETTLEMENT, expectedAmount: 9123.45 }],
+        [{ type: MyPaymentTypeEnum.ADVANCE, expectedAmount: 2100.5 }],
+    ])('acepta %j', async body => {
+        expect(await errorProperties(body)).toEqual([]);
+    });
+
+    it('exige tipo y monto esperado', async () => {
+        expect(await errorProperties({})).toEqual(expect.arrayContaining(['type', 'expectedAmount']));
+    });
+
+    it('rechaza un tipo fuera del enum', async () => {
+        expect(await errorProperties({ type: 'PARTIAL', expectedAmount: 1050 })).toEqual(['type']);
+    });
+
+    it.each([[0], [-1050], [10.123], ['1050']])('rechaza el monto %p', async expectedAmount => {
+        expect(await errorProperties({ type: MyPaymentTypeEnum.SETTLEMENT, expectedAmount })).toEqual(['expectedAmount']);
+    });
+});
+
+describe('retailLoan — opciones y respuesta del pago', () => {
+    it('la liquidación trae su desglose y su ahorro en pesos', () => {
+        const options: MyPaymentOptions = {
+            nextInstallment: {
+                available: true,
+                amount: 1050,
+                mode: MyNextInstallmentModeEnum.ADVANCE,
+                installmentNumber: 4,
+                dueDate: '2026-10-01',
+            },
+            advance: { available: false, unavailableReason: MyPaymentUnavailableReasonEnum.NOT_AVAILABLE_YET },
+            settlement: {
+                available: true,
+                amount: 9123.45,
+                breakdown: { overdue: 0, capital: 8900, interest: 192.63, iva: 30.82 },
+                savings: 326.55,
+                quotedAt: '2026-09-24T15:00:00.000Z',
+            },
+        };
+
+        expect(options.settlement.breakdown?.capital).toBe(8900);
+        expect(options.pendingPayment).toBeUndefined();
+    });
+
+    it('un pago en curso se informa con su tipo y su monto', () => {
+        const blocked = { available: false, unavailableReason: MyPaymentUnavailableReasonEnum.PAYMENT_IN_PROGRESS };
+        const options: MyPaymentOptions = {
+            pendingPayment: { type: MyPaymentTypeEnum.NEXT_INSTALLMENT, amount: 1050 },
+            nextInstallment: blocked,
+            advance: blocked,
+            settlement: blocked,
+        };
+
+        expect(options.pendingPayment?.type).toBe('NEXT_INSTALLMENT');
+    });
+
+    it('la respuesta del pago siempre trae el desenlace del cobro', () => {
+        const response: CreateMyPaymentResponse = {
+            creditId: 'CR-1',
+            type: MyPaymentTypeEnum.SETTLEMENT,
+            amount: 9123.45,
+            collection: MyCollectionOutcomeEnum.UNKNOWN,
+        };
+
+        expect(response.collection).toBe('UNKNOWN');
+    });
+
+    it('expone el request en el namespace RetailLoan del index raíz', () => {
+        expect(RetailLoan.CreateMyPaymentRequest).toBeDefined();
+        expect(RetailLoan.MyCollectionOutcomeEnum.NOT_COLLECTED).toBe('NOT_COLLECTED');
+    });
+});

package/bin/creditEngine/dtos/SettlementQuote.d.ts

@@ -13,4 +13,13 @@ export declare class SettlementQuote {
     total_settlement_mxn: number;
     interest_saved_mxn: number;
     quote_date: string;
+    /**
+     * USD que se cobrarán realmente al pocket del usuario para cubrir
+     * `total_settlement_mxn`. Incluye fee 0.5% + IVA + colchón FX del
+     * collector — es el número que debe aparecer en la UI como
+     * "equivalente USD", no la conversión cruda `total_settlement_mxn / TC`.
+     * Opcional: si el collector no responde a la cotización, el backend
+     * omite el campo y la UI debe caer a "solo MXN".
+     */
+    total_settlement_usd_charge?: number;
 }

package/bin/loanCredit/dtos/requests/CreateCustomerPaymentRequest.d.ts

@@ -0,0 +1,9 @@
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+/** Body de `POST /private/customers/:directoryId/credits/:creditId/payments` (loan-credit-business). */
+export declare class CreateCustomerPaymentRequest {
+    type: LoanCustomerPaymentTypeEnum;
+    /** Monto que vio el cliente; si ya no coincide, responde 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED. */
+    expectedAmountCents: number;
+    /** Llave del reintento: la misma llave con el mismo cuerpo devuelve la misma respuesta. */
+    idempotencyKey: string;
+}

package/bin/loanCredit/dtos/requests/CreateCustomerPaymentRequest.js

@@ -0,0 +1,35 @@
+"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.CreateCustomerPaymentRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const LoanCustomerPaymentTypeEnum_1 = require("../../enums/LoanCustomerPaymentTypeEnum");
+/** Body de `POST /private/customers/:directoryId/credits/:creditId/payments` (loan-credit-business). */
+class CreateCustomerPaymentRequest {
+}
+exports.CreateCustomerPaymentRequest = CreateCustomerPaymentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(LoanCustomerPaymentTypeEnum_1.LoanCustomerPaymentTypeEnum),
+    __metadata("design:type", String)
+], CreateCustomerPaymentRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], CreateCustomerPaymentRequest.prototype, "expectedAmountCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], CreateCustomerPaymentRequest.prototype, "idempotencyKey", void 0);

package/bin/loanCredit/dtos/responses/LoanAdHocChargeRequested.d.ts

@@ -1,3 +1,4 @@
+import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
 import { LoanAdHocChargeKindEnum } from '../../enums/LoanAdHocChargeKindEnum';
 /** Response 202 de recovery-collection, prepayments y advances. El 202 no mueve el libro; lo mueve el apply-result. */
 export interface LoanAdHocChargeRequested {
@@ -6,4 +7,9 @@ export interface LoanAdHocChargeRequested {
     /** `<creditId>#<chargeKind>#<n>`. */
     chargeId: string;
     amountCents: number;
+    /** Respuesta síncrona del motor; ausente si no contestó a tiempo. */
+    collection?: {
+        status: CollectionResultStatus;
+        amountCollectedCents: number;
+    };
 }

package/bin/loanCredit/dtos/responses/LoanCustomerPaymentOptions.d.ts

@@ -0,0 +1,33 @@
+import { LoanAdHocChargeKindEnum } from '../../enums/LoanAdHocChargeKindEnum';
+import { LoanNextInstallmentModeEnum } from '../../enums/LoanNextInstallmentModeEnum';
+import { LoanPaymentOptionUnavailableReasonEnum } from '../../enums/LoanPaymentOptionUnavailableReasonEnum';
+import { LoanSettlementQuote } from './LoanSettlementQuote';
+/** Una opción de pago. `amountCents` solo viene si está disponible. */
+export interface LoanCustomerPaymentOption {
+    available: boolean;
+    unavailableReason?: LoanPaymentOptionUnavailableReasonEnum;
+    amountCents?: number;
+}
+/** Response de `GET /private/customers/:directoryId/credits/:creditId/payment-options`. Montos en cents. */
+export interface LoanCustomerPaymentOptions {
+    creditId: string;
+    /** Cargo ad hoc en curso; mientras exista, ninguna opción está disponible. */
+    pendingCharge?: {
+        kind: LoanAdHocChargeKindEnum;
+        amountCents: number;
+    };
+    nextInstallment: LoanCustomerPaymentOption & {
+        mode?: LoanNextInstallmentModeEnum;
+        installmentNumber?: number;
+        /** `YYYY-MM-DD`. */
+        dueDate?: string;
+    };
+    /** Varias cuotas: hoy siempre `available: false` con `NOT_AVAILABLE_YET`. */
+    advance: LoanCustomerPaymentOption;
+    settlement: LoanCustomerPaymentOption & {
+        /** La cotización de hoy; su `settlementAmountCents` es el `amountCents`. */
+        quote?: LoanSettlementQuote;
+        /** Lo que deben las cuotas abiertas menos `settlementAmountCents`. */
+        savingsCents?: number;
+    };
+}

package/bin/loanCredit/dtos/responses/LoanCustomerPaymentOptions.js

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

package/bin/loanCredit/dtos/responses/LoanCustomerPaymentResult.d.ts

@@ -0,0 +1,14 @@
+import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+/** Response 202 de `POST /private/customers/:directoryId/credits/:creditId/payments`. */
+export interface LoanCustomerPaymentResult {
+    creditId: string;
+    type: LoanCustomerPaymentTypeEnum;
+    chargeId: string;
+    amountCents: number;
+    /** Respuesta síncrona del motor; ausente si no contestó a tiempo. */
+    collection?: {
+        status: CollectionResultStatus;
+        amountCollectedCents: number;
+    };
+}

package/bin/loanCredit/dtos/responses/LoanCustomerPaymentResult.js

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

package/bin/loanCredit/enums/LoanCustomerPaymentTypeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Pago que el cliente puede pedir desde la app. */
+export declare enum LoanCustomerPaymentTypeEnum {
+    NEXT_INSTALLMENT = "NEXT_INSTALLMENT",
+    SETTLEMENT = "SETTLEMENT"
+}

package/bin/loanCredit/enums/LoanCustomerPaymentTypeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoanCustomerPaymentTypeEnum = void 0;
+/** Pago que el cliente puede pedir desde la app. */
+var LoanCustomerPaymentTypeEnum;
+(function (LoanCustomerPaymentTypeEnum) {
+    LoanCustomerPaymentTypeEnum["NEXT_INSTALLMENT"] = "NEXT_INSTALLMENT";
+    LoanCustomerPaymentTypeEnum["SETTLEMENT"] = "SETTLEMENT";
+})(LoanCustomerPaymentTypeEnum || (exports.LoanCustomerPaymentTypeEnum = LoanCustomerPaymentTypeEnum = {}));

package/bin/loanCredit/enums/LoanNextInstallmentModeEnum.d.ts

@@ -0,0 +1,7 @@
+/** Cómo se cobra la siguiente cuota. */
+export declare enum LoanNextInstallmentModeEnum {
+    /** La cuota aún no está registrada en el motor: se adelanta. */
+    ADVANCE = "ADVANCE",
+    /** Vence hoy o hay vencidas: se cobra lo exigible. */
+    COLLECT_DUE = "COLLECT_DUE"
+}

package/bin/loanCredit/enums/LoanNextInstallmentModeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoanNextInstallmentModeEnum = void 0;
+/** Cómo se cobra la siguiente cuota. */
+var LoanNextInstallmentModeEnum;
+(function (LoanNextInstallmentModeEnum) {
+    /** La cuota aún no está registrada en el motor: se adelanta. */
+    LoanNextInstallmentModeEnum["ADVANCE"] = "ADVANCE";
+    /** Vence hoy o hay vencidas: se cobra lo exigible. */
+    LoanNextInstallmentModeEnum["COLLECT_DUE"] = "COLLECT_DUE";
+})(LoanNextInstallmentModeEnum || (exports.LoanNextInstallmentModeEnum = LoanNextInstallmentModeEnum = {}));

package/bin/loanCredit/enums/LoanPaymentOptionUnavailableReasonEnum.d.ts

@@ -0,0 +1,13 @@
+/** Por qué una opción de pago no está disponible. */
+export declare enum LoanPaymentOptionUnavailableReasonEnum {
+    /** Hay un cargo ad hoc en curso. */
+    PAYMENT_IN_PROGRESS = "PAYMENT_IN_PROGRESS",
+    /** El crédito todavía no está activo. */
+    CREDIT_NOT_CURRENT = "CREDIT_NOT_CURRENT",
+    /** Adelantar cubriría todo lo abierto: se liquida. */
+    USE_SETTLEMENT = "USE_SETTLEMENT",
+    /** La opción aún no está habilitada. */
+    NOT_AVAILABLE_YET = "NOT_AVAILABLE_YET",
+    /** SETTLED, WRITTEN_OFF, CANCELLED o DISCARDED. */
+    CREDIT_CLOSED = "CREDIT_CLOSED"
+}

package/bin/loanCredit/enums/LoanPaymentOptionUnavailableReasonEnum.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoanPaymentOptionUnavailableReasonEnum = void 0;
+/** Por qué una opción de pago no está disponible. */
+var LoanPaymentOptionUnavailableReasonEnum;
+(function (LoanPaymentOptionUnavailableReasonEnum) {
+    /** Hay un cargo ad hoc en curso. */
+    LoanPaymentOptionUnavailableReasonEnum["PAYMENT_IN_PROGRESS"] = "PAYMENT_IN_PROGRESS";
+    /** El crédito todavía no está activo. */
+    LoanPaymentOptionUnavailableReasonEnum["CREDIT_NOT_CURRENT"] = "CREDIT_NOT_CURRENT";
+    /** Adelantar cubriría todo lo abierto: se liquida. */
+    LoanPaymentOptionUnavailableReasonEnum["USE_SETTLEMENT"] = "USE_SETTLEMENT";
+    /** La opción aún no está habilitada. */
+    LoanPaymentOptionUnavailableReasonEnum["NOT_AVAILABLE_YET"] = "NOT_AVAILABLE_YET";
+    /** SETTLED, WRITTEN_OFF, CANCELLED o DISCARDED. */
+    LoanPaymentOptionUnavailableReasonEnum["CREDIT_CLOSED"] = "CREDIT_CLOSED";
+})(LoanPaymentOptionUnavailableReasonEnum || (exports.LoanPaymentOptionUnavailableReasonEnum = LoanPaymentOptionUnavailableReasonEnum = {}));

package/bin/loanCredit/index.d.ts

@@ -131,3 +131,9 @@ export * from './dtos/responses/LoanPrepaymentQuote';
 export * from './dtos/responses/LoanPaymentReviewItem';
 export * from './dtos/responses/LoanPaymentReviewListResponse';
 export * from './dtos/responses/LoanPaymentReviewResolution';
+export * from './enums/LoanCustomerPaymentTypeEnum';
+export * from './enums/LoanNextInstallmentModeEnum';
+export * from './enums/LoanPaymentOptionUnavailableReasonEnum';
+export * from './dtos/requests/CreateCustomerPaymentRequest';
+export * from './dtos/responses/LoanCustomerPaymentOptions';
+export * from './dtos/responses/LoanCustomerPaymentResult';

package/bin/loanCredit/index.js

@@ -172,3 +172,10 @@ __exportStar(require("./dtos/responses/LoanPrepaymentQuote"), exports);
 __exportStar(require("./dtos/responses/LoanPaymentReviewItem"), exports);
 __exportStar(require("./dtos/responses/LoanPaymentReviewListResponse"), exports);
 __exportStar(require("./dtos/responses/LoanPaymentReviewResolution"), exports);
+// Pagos del cliente: contrato privado con retail-loan-business
+__exportStar(require("./enums/LoanCustomerPaymentTypeEnum"), exports);
+__exportStar(require("./enums/LoanNextInstallmentModeEnum"), exports);
+__exportStar(require("./enums/LoanPaymentOptionUnavailableReasonEnum"), exports);
+__exportStar(require("./dtos/requests/CreateCustomerPaymentRequest"), exports);
+__exportStar(require("./dtos/responses/LoanCustomerPaymentOptions"), exports);
+__exportStar(require("./dtos/responses/LoanCustomerPaymentResult"), exports);

package/bin/retailLoan/dtos/CreateMyPaymentRequest.d.ts

@@ -0,0 +1,7 @@
+import { MyPaymentTypeEnum } from '../enums/MyPaymentTypeEnum';
+/** Body de `POST /benefits/{benefitId}/credits/{creditId}/payments`. La llave va en el header `Idempotency-Key`. */
+export declare class CreateMyPaymentRequest {
+    type: MyPaymentTypeEnum;
+    /** Monto en pesos que vio el cliente; si ya no coincide, responde PAYMENT_AMOUNT_CHANGED. */
+    expectedAmount: number;
+}

package/bin/retailLoan/dtos/CreateMyPaymentRequest.js

@@ -0,0 +1,30 @@
+"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.CreateMyPaymentRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MyPaymentTypeEnum_1 = require("../enums/MyPaymentTypeEnum");
+/** Body de `POST /benefits/{benefitId}/credits/{creditId}/payments`. La llave va en el header `Idempotency-Key`. */
+class CreateMyPaymentRequest {
+}
+exports.CreateMyPaymentRequest = CreateMyPaymentRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(MyPaymentTypeEnum_1.MyPaymentTypeEnum),
+    __metadata("design:type", String)
+], CreateMyPaymentRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], CreateMyPaymentRequest.prototype, "expectedAmount", void 0);

package/bin/retailLoan/dtos/CreateMyPaymentResponse.d.ts

@@ -0,0 +1,9 @@
+import { MyCollectionOutcomeEnum } from '../enums/MyCollectionOutcomeEnum';
+import { MyPaymentTypeEnum } from '../enums/MyPaymentTypeEnum';
+/** Response 202 del pago. `amount` en pesos. */
+export interface CreateMyPaymentResponse {
+    creditId: string;
+    type: MyPaymentTypeEnum;
+    amount: number;
+    collection: MyCollectionOutcomeEnum;
+}

package/bin/retailLoan/dtos/CreateMyPaymentResponse.js

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

package/bin/retailLoan/dtos/MyPaymentOptions.d.ts

@@ -0,0 +1,34 @@
+import { MyNextInstallmentModeEnum } from '../enums/MyNextInstallmentModeEnum';
+import { MyPaymentTypeEnum } from '../enums/MyPaymentTypeEnum';
+import { MyPaymentUnavailableReasonEnum } from '../enums/MyPaymentUnavailableReasonEnum';
+/** Una opción de pago. `amount` en pesos, solo si está disponible. */
+export interface MyPaymentOption {
+    available: boolean;
+    unavailableReason?: MyPaymentUnavailableReasonEnum;
+    amount?: number;
+}
+/** Opciones de pago de un crédito (`GET /benefits/{benefitId}/credits/{creditId}/payment-options`). Montos en pesos. */
+export interface MyPaymentOptions {
+    /** Pago en curso; mientras exista, ninguna opción está disponible. */
+    pendingPayment?: {
+        type: MyPaymentTypeEnum;
+        amount: number;
+    };
+    nextInstallment: MyPaymentOption & {
+        mode?: MyNextInstallmentModeEnum;
+        installmentNumber?: number;
+        /** `YYYY-MM-DD`. */
+        dueDate?: string;
+    };
+    advance: MyPaymentOption;
+    settlement: MyPaymentOption & {
+        breakdown?: {
+            overdue: number;
+            capital: number;
+            interest: number;
+            iva: number;
+        };
+        savings?: number;
+        quotedAt?: string;
+    };
+}

package/bin/retailLoan/dtos/MyPaymentOptions.js

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

package/bin/retailLoan/enums/MyCollectionOutcomeEnum.d.ts

@@ -0,0 +1,11 @@
+/** Desenlace del cobro tal como lo contestó el motor. */
+export declare enum MyCollectionOutcomeEnum {
+    /** FULL */
+    COLLECTED = "COLLECTED",
+    /** PARTIAL */
+    PARTIAL = "PARTIAL",
+    /** NONE */
+    NOT_COLLECTED = "NOT_COLLECTED",
+    /** El motor no contestó a tiempo. */
+    UNKNOWN = "UNKNOWN"
+}

package/bin/retailLoan/enums/MyCollectionOutcomeEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MyCollectionOutcomeEnum = void 0;
+/** Desenlace del cobro tal como lo contestó el motor. */
+var MyCollectionOutcomeEnum;
+(function (MyCollectionOutcomeEnum) {
+    /** FULL */
+    MyCollectionOutcomeEnum["COLLECTED"] = "COLLECTED";
+    /** PARTIAL */
+    MyCollectionOutcomeEnum["PARTIAL"] = "PARTIAL";
+    /** NONE */
+    MyCollectionOutcomeEnum["NOT_COLLECTED"] = "NOT_COLLECTED";
+    /** El motor no contestó a tiempo. */
+    MyCollectionOutcomeEnum["UNKNOWN"] = "UNKNOWN";
+})(MyCollectionOutcomeEnum || (exports.MyCollectionOutcomeEnum = MyCollectionOutcomeEnum = {}));

package/bin/retailLoan/enums/MyNextInstallmentModeEnum.d.ts

@@ -0,0 +1,5 @@
+/** Cómo se cobra la siguiente cuota: se adelanta, o se cobra lo que ya vence o venció. */
+export declare enum MyNextInstallmentModeEnum {
+    ADVANCE = "ADVANCE",
+    COLLECT_DUE = "COLLECT_DUE"
+}

package/bin/retailLoan/enums/MyNextInstallmentModeEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MyNextInstallmentModeEnum = void 0;
+/** Cómo se cobra la siguiente cuota: se adelanta, o se cobra lo que ya vence o venció. */
+var MyNextInstallmentModeEnum;
+(function (MyNextInstallmentModeEnum) {
+    MyNextInstallmentModeEnum["ADVANCE"] = "ADVANCE";
+    MyNextInstallmentModeEnum["COLLECT_DUE"] = "COLLECT_DUE";
+})(MyNextInstallmentModeEnum || (exports.MyNextInstallmentModeEnum = MyNextInstallmentModeEnum = {}));

package/bin/retailLoan/enums/MyPaymentTypeEnum.d.ts

@@ -0,0 +1,6 @@
+/** Pago que el cliente pide desde la app. `ADVANCE` = varias cuotas. */
+export declare enum MyPaymentTypeEnum {
+    NEXT_INSTALLMENT = "NEXT_INSTALLMENT",
+    ADVANCE = "ADVANCE",
+    SETTLEMENT = "SETTLEMENT"
+}

package/bin/retailLoan/enums/MyPaymentTypeEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MyPaymentTypeEnum = void 0;
+/** Pago que el cliente pide desde la app. `ADVANCE` = varias cuotas. */
+var MyPaymentTypeEnum;
+(function (MyPaymentTypeEnum) {
+    MyPaymentTypeEnum["NEXT_INSTALLMENT"] = "NEXT_INSTALLMENT";
+    MyPaymentTypeEnum["ADVANCE"] = "ADVANCE";
+    MyPaymentTypeEnum["SETTLEMENT"] = "SETTLEMENT";
+})(MyPaymentTypeEnum || (exports.MyPaymentTypeEnum = MyPaymentTypeEnum = {}));

package/bin/retailLoan/enums/MyPaymentUnavailableReasonEnum.d.ts

@@ -0,0 +1,8 @@
+/** Por qué una opción de pago no está disponible. Mismos valores que manda loan-credit. */
+export declare enum MyPaymentUnavailableReasonEnum {
+    PAYMENT_IN_PROGRESS = "PAYMENT_IN_PROGRESS",
+    CREDIT_NOT_CURRENT = "CREDIT_NOT_CURRENT",
+    USE_SETTLEMENT = "USE_SETTLEMENT",
+    NOT_AVAILABLE_YET = "NOT_AVAILABLE_YET",
+    CREDIT_CLOSED = "CREDIT_CLOSED"
+}

package/bin/retailLoan/enums/MyPaymentUnavailableReasonEnum.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MyPaymentUnavailableReasonEnum = void 0;
+/** Por qué una opción de pago no está disponible. Mismos valores que manda loan-credit. */
+var MyPaymentUnavailableReasonEnum;
+(function (MyPaymentUnavailableReasonEnum) {
+    MyPaymentUnavailableReasonEnum["PAYMENT_IN_PROGRESS"] = "PAYMENT_IN_PROGRESS";
+    MyPaymentUnavailableReasonEnum["CREDIT_NOT_CURRENT"] = "CREDIT_NOT_CURRENT";
+    MyPaymentUnavailableReasonEnum["USE_SETTLEMENT"] = "USE_SETTLEMENT";
+    MyPaymentUnavailableReasonEnum["NOT_AVAILABLE_YET"] = "NOT_AVAILABLE_YET";
+    MyPaymentUnavailableReasonEnum["CREDIT_CLOSED"] = "CREDIT_CLOSED";
+})(MyPaymentUnavailableReasonEnum || (exports.MyPaymentUnavailableReasonEnum = MyPaymentUnavailableReasonEnum = {}));

package/bin/retailLoan/index.d.ts

@@ -10,3 +10,10 @@ export * from './dtos/MyInstallment';
 export * from './dtos/MyPayment';
 export * from './dtos/MyDocument';
 export * from './dtos/MyDocumentUrl';
+export * from './enums/MyPaymentTypeEnum';
+export * from './enums/MyNextInstallmentModeEnum';
+export * from './enums/MyPaymentUnavailableReasonEnum';
+export * from './enums/MyCollectionOutcomeEnum';
+export * from './dtos/MyPaymentOptions';
+export * from './dtos/CreateMyPaymentRequest';
+export * from './dtos/CreateMyPaymentResponse';

package/bin/retailLoan/index.js

@@ -28,3 +28,11 @@ __exportStar(require("./dtos/MyInstallment"), exports);
 __exportStar(require("./dtos/MyPayment"), exports);
 __exportStar(require("./dtos/MyDocument"), exports);
 __exportStar(require("./dtos/MyDocumentUrl"), exports);
+// Pagos
+__exportStar(require("./enums/MyPaymentTypeEnum"), exports);
+__exportStar(require("./enums/MyNextInstallmentModeEnum"), exports);
+__exportStar(require("./enums/MyPaymentUnavailableReasonEnum"), exports);
+__exportStar(require("./enums/MyCollectionOutcomeEnum"), exports);
+__exportStar(require("./dtos/MyPaymentOptions"), exports);
+__exportStar(require("./dtos/CreateMyPaymentRequest"), exports);
+__exportStar(require("./dtos/CreateMyPaymentResponse"), exports);

package/package.json

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

package/src/creditEngine/dtos/SettlementQuote.ts

@@ -13,4 +13,13 @@ export class SettlementQuote {
     total_settlement_mxn!: number;
     interest_saved_mxn!: number;
     quote_date!: string;
+    /**
+     * USD que se cobrarán realmente al pocket del usuario para cubrir
+     * `total_settlement_mxn`. Incluye fee 0.5% + IVA + colchón FX del
+     * collector — es el número que debe aparecer en la UI como
+     * "equivalente USD", no la conversión cruda `total_settlement_mxn / TC`.
+     * Opcional: si el collector no responde a la cotización, el backend
+     * omite el campo y la UI debe caer a "solo MXN".
+     */
+    total_settlement_usd_charge?: number;
 }

package/src/loanCredit/dtos/requests/CreateCustomerPaymentRequest.ts

@@ -0,0 +1,21 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsInt, IsUUID, Min } from 'class-validator';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+
+/** Body de `POST /private/customers/:directoryId/credits/:creditId/payments` (loan-credit-business). */
+export class CreateCustomerPaymentRequest {
+    @Expose()
+    @IsEnum(LoanCustomerPaymentTypeEnum)
+    type!: LoanCustomerPaymentTypeEnum;
+
+    /** Monto que vio el cliente; si ya no coincide, responde 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    expectedAmountCents!: number;
+
+    /** Llave del reintento: la misma llave con el mismo cuerpo devuelve la misma respuesta. */
+    @Expose()
+    @IsUUID()
+    idempotencyKey!: string;
+}

package/src/loanCredit/dtos/responses/LoanAdHocChargeRequested.ts

@@ -1,3 +1,4 @@
+import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
 import { LoanAdHocChargeKindEnum } from '../../enums/LoanAdHocChargeKindEnum';
 
 /** Response 202 de recovery-collection, prepayments y advances. El 202 no mueve el libro; lo mueve el apply-result. */
@@ -7,4 +8,6 @@ export interface LoanAdHocChargeRequested {
     /** `<creditId>#<chargeKind>#<n>`. */
     chargeId: string;
     amountCents: number;
+    /** Respuesta síncrona del motor; ausente si no contestó a tiempo. */
+    collection?: { status: CollectionResultStatus; amountCollectedCents: number };
 }

package/src/loanCredit/dtos/responses/LoanCustomerPaymentOptions.ts

@@ -0,0 +1,32 @@
+import { LoanAdHocChargeKindEnum } from '../../enums/LoanAdHocChargeKindEnum';
+import { LoanNextInstallmentModeEnum } from '../../enums/LoanNextInstallmentModeEnum';
+import { LoanPaymentOptionUnavailableReasonEnum } from '../../enums/LoanPaymentOptionUnavailableReasonEnum';
+import { LoanSettlementQuote } from './LoanSettlementQuote';
+
+/** Una opción de pago. `amountCents` solo viene si está disponible. */
+export interface LoanCustomerPaymentOption {
+    available: boolean;
+    unavailableReason?: LoanPaymentOptionUnavailableReasonEnum;
+    amountCents?: number;
+}
+
+/** Response de `GET /private/customers/:directoryId/credits/:creditId/payment-options`. Montos en cents. */
+export interface LoanCustomerPaymentOptions {
+    creditId: string;
+    /** Cargo ad hoc en curso; mientras exista, ninguna opción está disponible. */
+    pendingCharge?: { kind: LoanAdHocChargeKindEnum; amountCents: number };
+    nextInstallment: LoanCustomerPaymentOption & {
+        mode?: LoanNextInstallmentModeEnum;
+        installmentNumber?: number;
+        /** `YYYY-MM-DD`. */
+        dueDate?: string;
+    };
+    /** Varias cuotas: hoy siempre `available: false` con `NOT_AVAILABLE_YET`. */
+    advance: LoanCustomerPaymentOption;
+    settlement: LoanCustomerPaymentOption & {
+        /** La cotización de hoy; su `settlementAmountCents` es el `amountCents`. */
+        quote?: LoanSettlementQuote;
+        /** Lo que deben las cuotas abiertas menos `settlementAmountCents`. */
+        savingsCents?: number;
+    };
+}

package/src/loanCredit/dtos/responses/LoanCustomerPaymentResult.ts

@@ -0,0 +1,12 @@
+import { CollectionResultStatus } from '../../../collection/enums/CollectionResultStatus';
+import { LoanCustomerPaymentTypeEnum } from '../../enums/LoanCustomerPaymentTypeEnum';
+
+/** Response 202 de `POST /private/customers/:directoryId/credits/:creditId/payments`. */
+export interface LoanCustomerPaymentResult {
+    creditId: string;
+    type: LoanCustomerPaymentTypeEnum;
+    chargeId: string;
+    amountCents: number;
+    /** Respuesta síncrona del motor; ausente si no contestó a tiempo. */
+    collection?: { status: CollectionResultStatus; amountCollectedCents: number };
+}

package/src/loanCredit/enums/LoanCustomerPaymentTypeEnum.ts

@@ -0,0 +1,5 @@
+/** Pago que el cliente puede pedir desde la app. */
+export enum LoanCustomerPaymentTypeEnum {
+    NEXT_INSTALLMENT = 'NEXT_INSTALLMENT',
+    SETTLEMENT = 'SETTLEMENT',
+}

package/src/loanCredit/enums/LoanNextInstallmentModeEnum.ts

@@ -0,0 +1,7 @@
+/** Cómo se cobra la siguiente cuota. */
+export enum LoanNextInstallmentModeEnum {
+    /** La cuota aún no está registrada en el motor: se adelanta. */
+    ADVANCE = 'ADVANCE',
+    /** Vence hoy o hay vencidas: se cobra lo exigible. */
+    COLLECT_DUE = 'COLLECT_DUE',
+}

package/src/loanCredit/enums/LoanPaymentOptionUnavailableReasonEnum.ts

@@ -0,0 +1,13 @@
+/** Por qué una opción de pago no está disponible. */
+export enum LoanPaymentOptionUnavailableReasonEnum {
+    /** Hay un cargo ad hoc en curso. */
+    PAYMENT_IN_PROGRESS = 'PAYMENT_IN_PROGRESS',
+    /** El crédito todavía no está activo. */
+    CREDIT_NOT_CURRENT = 'CREDIT_NOT_CURRENT',
+    /** Adelantar cubriría todo lo abierto: se liquida. */
+    USE_SETTLEMENT = 'USE_SETTLEMENT',
+    /** La opción aún no está habilitada. */
+    NOT_AVAILABLE_YET = 'NOT_AVAILABLE_YET',
+    /** SETTLED, WRITTEN_OFF, CANCELLED o DISCARDED. */
+    CREDIT_CLOSED = 'CREDIT_CLOSED',
+}

package/src/loanCredit/index.ts

@@ -154,3 +154,11 @@ export * from './dtos/responses/LoanPrepaymentQuote';
 export * from './dtos/responses/LoanPaymentReviewItem';
 export * from './dtos/responses/LoanPaymentReviewListResponse';
 export * from './dtos/responses/LoanPaymentReviewResolution';
+
+// Pagos del cliente: contrato privado con retail-loan-business
+export * from './enums/LoanCustomerPaymentTypeEnum';
+export * from './enums/LoanNextInstallmentModeEnum';
+export * from './enums/LoanPaymentOptionUnavailableReasonEnum';
+export * from './dtos/requests/CreateCustomerPaymentRequest';
+export * from './dtos/responses/LoanCustomerPaymentOptions';
+export * from './dtos/responses/LoanCustomerPaymentResult';

package/src/retailLoan/dtos/CreateMyPaymentRequest.ts

@@ -0,0 +1,16 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsNumber, IsPositive } from 'class-validator';
+import { MyPaymentTypeEnum } from '../enums/MyPaymentTypeEnum';
+
+/** Body de `POST /benefits/{benefitId}/credits/{creditId}/payments`. La llave va en el header `Idempotency-Key`. */
+export class CreateMyPaymentRequest {
+    @Expose()
+    @IsEnum(MyPaymentTypeEnum)
+    type!: MyPaymentTypeEnum;
+
+    /** Monto en pesos que vio el cliente; si ya no coincide, responde PAYMENT_AMOUNT_CHANGED. */
+    @Expose()
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @IsPositive()
+    expectedAmount!: number;
+}

package/src/retailLoan/dtos/CreateMyPaymentResponse.ts

@@ -0,0 +1,10 @@
+import { MyCollectionOutcomeEnum } from '../enums/MyCollectionOutcomeEnum';
+import { MyPaymentTypeEnum } from '../enums/MyPaymentTypeEnum';
+
+/** Response 202 del pago. `amount` en pesos. */
+export interface CreateMyPaymentResponse {
+    creditId: string;
+    type: MyPaymentTypeEnum;
+    amount: number;
+    collection: MyCollectionOutcomeEnum;
+}

package/src/retailLoan/dtos/MyPaymentOptions.ts

@@ -0,0 +1,28 @@
+import { MyNextInstallmentModeEnum } from '../enums/MyNextInstallmentModeEnum';
+import { MyPaymentTypeEnum } from '../enums/MyPaymentTypeEnum';
+import { MyPaymentUnavailableReasonEnum } from '../enums/MyPaymentUnavailableReasonEnum';
+
+/** Una opción de pago. `amount` en pesos, solo si está disponible. */
+export interface MyPaymentOption {
+    available: boolean;
+    unavailableReason?: MyPaymentUnavailableReasonEnum;
+    amount?: number;
+}
+
+/** Opciones de pago de un crédito (`GET /benefits/{benefitId}/credits/{creditId}/payment-options`). Montos en pesos. */
+export interface MyPaymentOptions {
+    /** Pago en curso; mientras exista, ninguna opción está disponible. */
+    pendingPayment?: { type: MyPaymentTypeEnum; amount: number };
+    nextInstallment: MyPaymentOption & {
+        mode?: MyNextInstallmentModeEnum;
+        installmentNumber?: number;
+        /** `YYYY-MM-DD`. */
+        dueDate?: string;
+    };
+    advance: MyPaymentOption;
+    settlement: MyPaymentOption & {
+        breakdown?: { overdue: number; capital: number; interest: number; iva: number };
+        savings?: number;
+        quotedAt?: string;
+    };
+}

package/src/retailLoan/enums/MyCollectionOutcomeEnum.ts

@@ -0,0 +1,11 @@
+/** Desenlace del cobro tal como lo contestó el motor. */
+export enum MyCollectionOutcomeEnum {
+    /** FULL */
+    COLLECTED = 'COLLECTED',
+    /** PARTIAL */
+    PARTIAL = 'PARTIAL',
+    /** NONE */
+    NOT_COLLECTED = 'NOT_COLLECTED',
+    /** El motor no contestó a tiempo. */
+    UNKNOWN = 'UNKNOWN',
+}

package/src/retailLoan/enums/MyNextInstallmentModeEnum.ts

@@ -0,0 +1,5 @@
+/** Cómo se cobra la siguiente cuota: se adelanta, o se cobra lo que ya vence o venció. */
+export enum MyNextInstallmentModeEnum {
+    ADVANCE = 'ADVANCE',
+    COLLECT_DUE = 'COLLECT_DUE',
+}

package/src/retailLoan/enums/MyPaymentTypeEnum.ts

@@ -0,0 +1,6 @@
+/** Pago que el cliente pide desde la app. `ADVANCE` = varias cuotas. */
+export enum MyPaymentTypeEnum {
+    NEXT_INSTALLMENT = 'NEXT_INSTALLMENT',
+    ADVANCE = 'ADVANCE',
+    SETTLEMENT = 'SETTLEMENT',
+}

package/src/retailLoan/enums/MyPaymentUnavailableReasonEnum.ts

@@ -0,0 +1,8 @@
+/** Por qué una opción de pago no está disponible. Mismos valores que manda loan-credit. */
+export enum MyPaymentUnavailableReasonEnum {
+    PAYMENT_IN_PROGRESS = 'PAYMENT_IN_PROGRESS',
+    CREDIT_NOT_CURRENT = 'CREDIT_NOT_CURRENT',
+    USE_SETTLEMENT = 'USE_SETTLEMENT',
+    NOT_AVAILABLE_YET = 'NOT_AVAILABLE_YET',
+    CREDIT_CLOSED = 'CREDIT_CLOSED',
+}

package/src/retailLoan/index.ts

@@ -13,3 +13,12 @@ export * from './dtos/MyInstallment';
 export * from './dtos/MyPayment';
 export * from './dtos/MyDocument';
 export * from './dtos/MyDocumentUrl';
+
+// Pagos
+export * from './enums/MyPaymentTypeEnum';
+export * from './enums/MyNextInstallmentModeEnum';
+export * from './enums/MyPaymentUnavailableReasonEnum';
+export * from './enums/MyCollectionOutcomeEnum';
+export * from './dtos/MyPaymentOptions';
+export * from './dtos/CreateMyPaymentRequest';
+export * from './dtos/CreateMyPaymentResponse';