@fiado/api-invoker 5.91.0 → 5.93.0

package/bin/container.config.js

@@ -75,6 +75,7 @@ import PeopleBusinessApi from "./people-business/api/PeopleBusinessApi.js";
 import PlacesBusinessApi from "./places-business/api/PlacesBusinessApi.js";
 import STPBusinessApi from "./stp-business/api/STPBusinessApi.js";
 import MulticommServicePaymentApi from "./multicommServicePayment/api/MulticommServicePaymentApi.js";
+import MoneyTransferConnectorApi from "./moneyTransferConnector/api/MoneyTransferConnectorApi.js";
 import ProductPaymentApi from "./product-payment/api/ProductPaymentApi.js";
 import { CommissionBusinessApi } from "./commission-business/index.js";
 import { CirculoCreditoApi } from "./circuloCredito/index.js";
@@ -173,6 +174,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind("IStpSpeiApi").to(StpSpeiApi);
     bind("IStpServicePaymentApi").to(StpServicePaymentApi);
     bind("IMulticommServicePaymentApi").to(MulticommServicePaymentApi);
+    bind("IMoneyTransferConnectorApi").to(MoneyTransferConnectorApi);
     bind("IBBVARstApi").to(BBVARstApi);
     bind("IFraudPreventionEngineApi").to(FraudPreventionEngineApi);
     bind("IGroupApi").to(GroupApi);

package/bin/index.d.ts

@@ -67,6 +67,7 @@ export * from "./people-business/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";
+export * from "./moneyTransferConnector/index.js";
 export * from "./product-payment/index.js";
 export * from "./credit-engine/index.js";
 export * from "./credit-payment/index.js";

package/bin/index.js

@@ -67,6 +67,7 @@ export * from "./people-business/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";
+export * from "./moneyTransferConnector/index.js";
 export * from "./product-payment/index.js";
 export * from "./credit-engine/index.js";
 export * from "./credit-payment/index.js";

package/bin/loanCredit/api/LoanCreditBusinessApi.d.ts

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "./dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "./dtos/CreditLifecycleFact.js";
@@ -45,4 +45,6 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     }): Promise<StandardResponse<LoanPaymentListResponse>>;
     listCustomerCreditContracts(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanContractResponse[]>>;
     getCustomerCreditContractUrl(directoryId: string, creditId: string, contractId: string, tenantId: string): Promise<StandardResponse<LoanContractDownloadUrl>>;
+    getCustomerPaymentOptions(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
+    createCustomerPayment(directoryId: string, creditId: string, tenantId: string, body: CreateCustomerPaymentRequest): Promise<StandardResponse<LoanCustomerPaymentResult>>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -114,6 +114,13 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
     async getCustomerCreditContractUrl(directoryId, creditId, contractId, tenantId) {
         return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/contracts/${encodeURIComponent(contractId)}/url?tenantId=${encodeURIComponent(tenantId)}`);
     }
+    // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
+    async getCustomerPaymentOptions(directoryId, creditId, tenantId) {
+        return await this.httpRequest.get(`${this.customerCreditsUrl(directoryId, creditId)}/payment-options?tenantId=${encodeURIComponent(tenantId)}`);
+    }
+    async createCustomerPayment(directoryId, creditId, tenantId, body) {
+        return await this.httpRequest.post(`${this.customerCreditsUrl(directoryId, creditId)}/payments?tenantId=${encodeURIComponent(tenantId)}`, body);
+    }
 };
 LoanCreditBusinessApi = __decorate([
     injectable(),

package/bin/loanCredit/api/interfaces/ILoanCreditBusinessApi.d.ts

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
 import { CustomerCreditHistoryResponse } from "../dtos/CustomerCreditHistory.js";
 import { CreditLifecycleFactRequest, CreditLifecycleFactResponse } from "../dtos/CreditLifecycleFact.js";
@@ -131,4 +131,13 @@ export interface ILoanCreditBusinessApi {
     listCustomerCreditContracts(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanContractResponse[]>>;
     /** URL prefirmada del PDF de un contrato. 404 CONTRACT_NOT_FOUND · 409 CONTRACT_PDF_NOT_READY. */
     getCustomerCreditContractUrl(directoryId: string, creditId: string, contractId: string, tenantId: string): Promise<StandardResponse<LoanContractDownloadUrl>>;
+    /** Opciones de pago de un crédito del cliente, con montos ya calculados. */
+    getCustomerPaymentOptions(directoryId: string, creditId: string, tenantId: string): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
+    /**
+     * Pide el cobro de una opción de pago (202). Misma `idempotencyKey` y mismo cuerpo devuelven la
+     * misma respuesta. 404 CREDIT_NOT_FOUND · 409 AD_HOC_CHARGE_PENDING · 409 CREDIT_NOT_CURRENT ·
+     * 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED · 422 PAYMENT_OPTION_UNAVAILABLE · 422 IDEMPOTENCY_KEY_MISMATCH ·
+     * 5xx si el motor de cobro no contesta.
+     */
+    createCustomerPayment(directoryId: string, creditId: string, tenantId: string, body: CreateCustomerPaymentRequest): Promise<StandardResponse<LoanCustomerPaymentResult>>;
 }

package/bin/moneyTransferConnector/api/MoneyTransferConnectorApi.d.ts

@@ -0,0 +1,21 @@
+import { IMoneyTransferConnectorApi } from "./interfaces/IMoneyTransferConnectorApi.js";
+import type { IHttpRequest } from "@fiado/http-client";
+import { BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+/**
+ * Cliente del money-transfer-connector (Centro de Beneficios — envíos de dinero / SPEI consolidado).
+ * Consumido por benefits-marketplace-business.
+ */
+export default class MoneyTransferConnectorApi implements IMoneyTransferConnectorApi {
+    private httpRequest;
+    private readonly baseUrl;
+    constructor(httpRequest: IHttpRequest);
+    getStandardCatalog(params?: {
+        benefitId?: string;
+        includeDisabled?: boolean;
+    }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+    payStandard(request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+    consultStandard(transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+    createService(payload: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+    updateService(idServicio: number, patch: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+}

package/bin/moneyTransferConnector/api/MoneyTransferConnectorApi.js

@@ -0,0 +1,58 @@
+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);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable } from "inversify";
+/**
+ * Cliente del money-transfer-connector (Centro de Beneficios — envíos de dinero / SPEI consolidado).
+ * Consumido por benefits-marketplace-business.
+ */
+let MoneyTransferConnectorApi = class MoneyTransferConnectorApi {
+    httpRequest;
+    baseUrl = process.env.MONEY_TRANSFER_CONNECTOR_LAMBDA_URL || "";
+    constructor(httpRequest) {
+        this.httpRequest = httpRequest;
+    }
+    async getStandardCatalog(params) {
+        let url = `${this.baseUrl}/catalog/standard`;
+        if (params) {
+            const query = Object.keys(params)
+                .filter(key => params[key] !== undefined)
+                .map(key => `${key}=${encodeURIComponent(String(params[key]))}`)
+                .join('&');
+            if (query)
+                url += `?${query}`;
+        }
+        return await this.httpRequest.get(url);
+    }
+    async payStandard(request) {
+        const url = `${this.baseUrl}/pay/standard`;
+        return await this.httpRequest.post(url, request);
+    }
+    async consultStandard(transactionNumber) {
+        const url = `${this.baseUrl}/pay/standard/transactions/${encodeURIComponent(transactionNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+    async createService(payload) {
+        const url = `${this.baseUrl}/internal/services`;
+        return await this.httpRequest.post(url, payload);
+    }
+    async updateService(idServicio, patch) {
+        const url = `${this.baseUrl}/internal/services/${idServicio}`;
+        return await this.httpRequest.put(url, patch);
+    }
+};
+MoneyTransferConnectorApi = __decorate([
+    injectable(),
+    __param(0, inject("IHttpRequest")),
+    __metadata("design:paramtypes", [Object])
+], MoneyTransferConnectorApi);
+export default MoneyTransferConnectorApi;

package/bin/moneyTransferConnector/api/interfaces/IMoneyTransferConnectorApi.d.ts

@@ -0,0 +1,17 @@
+import { BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+/**
+ * Contrato del money-transfer-connector (Centro de Beneficios — envíos de dinero / SPEI consolidado).
+ * Mismo shape que los métodos "standard" de IMulticommServicePaymentApi para que el
+ * PaymentRouter / CatalogTreeBuilder de benefits-marketplace-business lo consuman sin adaptar.
+ */
+export interface IMoneyTransferConnectorApi {
+    getStandardCatalog(params?: {
+        benefitId?: string;
+        includeDisabled?: boolean;
+    }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+    payStandard(request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+    consultStandard(transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+    createService(payload: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+    updateService(idServicio: number, patch: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+}

package/bin/moneyTransferConnector/api/interfaces/IMoneyTransferConnectorApi.js

@@ -0,0 +1 @@
+export {};

package/bin/moneyTransferConnector/index.d.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IMoneyTransferConnectorApi.js';
+export * from './api/MoneyTransferConnectorApi.js';

package/bin/moneyTransferConnector/index.js

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IMoneyTransferConnectorApi.js';
+export * from './api/MoneyTransferConnectorApi.js';

package/bin/stpSpei/api/StpSpeiApi.d.ts

@@ -1,5 +1,5 @@
-import { IStpSpeiApi } from "./interfaces/IStpSpeiApi.js";
-import { IHttpRequest } from "@fiado/http-client";
+import { IStpSpeiApi, StpConsultOrderRequest } from "./interfaces/IStpSpeiApi.js";
+import type { IHttpRequest } from "@fiado/http-client";
 import { BusinessNameEnum, PutStpOrderRequest } from "@fiado/type-kit/bin/stpSpei/index.js";
 export declare class StpSpeiApi implements IStpSpeiApi {
     private httpRequest;
@@ -7,4 +7,5 @@ export declare class StpSpeiApi implements IStpSpeiApi {
     constructor(httpRequest: IHttpRequest);
     putStpOrder(request: PutStpOrderRequest): Promise<any>;
     getBusinessAccountBalance(businessName: BusinessNameEnum): Promise<any>;
+    consultOrder(request: StpConsultOrderRequest): Promise<any>;
 }

package/bin/stpSpei/api/StpSpeiApi.js

@@ -36,6 +36,14 @@ let StpSpeiApi = class StpSpeiApi {
         };
         return await this.httpRequest.post(url, request, headers);
     }
+    async consultOrder(request) {
+        const url = `${this.baseUrl}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            operationName: "postOrdersConsult"
+        };
+        return await this.httpRequest.post(url, request, headers);
+    }
 };
 StpSpeiApi = __decorate([
     injectable(),

package/bin/stpSpei/api/interfaces/IStpSpeiApi.d.ts

@@ -1,5 +1,12 @@
-import { BusinessNameEnum, PutStpOrderRequest } from "@fiado/type-kit/bin/stpSpei/index.js";
+import { BusinessNameEnum, ConsultStpOrderRequest, PutStpOrderRequest } from "@fiado/type-kit/bin/stpSpei/index.js";
+/** Alias de compatibilidad: el request de consulta vive en @fiado/type-kit (≥ 3.464.0). */
+export type StpConsultOrderRequest = ConsultStpOrderRequest;
 export interface IStpSpeiApi {
     putStpOrder(request: PutStpOrderRequest): Promise<any>;
     getBusinessAccountBalance(businessName: BusinessNameEnum): Promise<any>;
+    /**
+     * Consulta una orden enviada por claveRastreo (fiado-stp-lambda `postOrdersConsult`).
+     * Agregado para money-transfer-connector (F5', DEC-027/037).
+     */
+    consultOrder(request: StpConsultOrderRequest): Promise<any>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.91.0",
+  "version": "5.93.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "3.461.0",
+    "@fiado/type-kit": "3.464.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/container.config.ts

@@ -113,6 +113,8 @@ import STPBusinessApi from "./stp-business/api/STPBusinessApi.js";
 import { ISTPBusinessApi } from "./stp-business/index.js";
 import { IMulticommServicePaymentApi } from "./multicommServicePayment/index.js";
 import MulticommServicePaymentApi from "./multicommServicePayment/api/MulticommServicePaymentApi.js";
+import { IMoneyTransferConnectorApi } from "./moneyTransferConnector/index.js";
+import MoneyTransferConnectorApi from "./moneyTransferConnector/api/MoneyTransferConnectorApi.js";
 import { IProductPaymentApi } from "./product-payment/index.js";
 import ProductPaymentApi from "./product-payment/api/ProductPaymentApi.js";
 import { CommissionBusinessApi, ICommissionBusinessApi } from "./commission-business/index.js";
@@ -245,6 +247,7 @@ export const apiInvokerBindings = new ContainerModule(({ bind }) => {
     bind<IStpSpeiApi>("IStpSpeiApi").to(StpSpeiApi);
     bind<IStpServicePaymentApi>("IStpServicePaymentApi").to(StpServicePaymentApi);
     bind<IMulticommServicePaymentApi>("IMulticommServicePaymentApi").to(MulticommServicePaymentApi);
+    bind<IMoneyTransferConnectorApi>("IMoneyTransferConnectorApi").to(MoneyTransferConnectorApi);
     bind<IBBVARstApi>("IBBVARstApi").to(BBVARstApi);
     bind<IFraudPreventionEngineApi>("IFraudPreventionEngineApi").to(FraudPreventionEngineApi);
     bind<IGroupApi>("IGroupApi").to(GroupApi);

package/src/index.ts

@@ -67,6 +67,7 @@ export * from "./people-business/index.js";
 export * from "./places-business/index.js";
 export * from "./stp-business/index.js";
 export * from "./multicommServicePayment/index.js";
+export * from "./moneyTransferConnector/index.js";
 export * from "./product-payment/index.js";
 export * from "./credit-engine/index.js";
 export * from "./credit-payment/index.js";

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -25,6 +25,9 @@ import {
     LoanCreditDetail,
     LoanInstallmentResponse,
     LoanPaymentListResponse,
+    CreateCustomerPaymentRequest,
+    LoanCustomerPaymentOptions,
+    LoanCustomerPaymentResult,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     LoanCreditAnalyticsBatchRequest,
@@ -238,4 +241,28 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
             `${this.customerCreditsUrl(directoryId, creditId)}/contracts/${encodeURIComponent(contractId)}/url?tenantId=${encodeURIComponent(tenantId)}`,
         );
     }
+
+    // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
+
+    async getCustomerPaymentOptions(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerPaymentOptions>> {
+        return await this.httpRequest.get(
+            `${this.customerCreditsUrl(directoryId, creditId)}/payment-options?tenantId=${encodeURIComponent(tenantId)}`,
+        );
+    }
+
+    async createCustomerPayment(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+        body: CreateCustomerPaymentRequest,
+    ): Promise<StandardResponse<LoanCustomerPaymentResult>> {
+        return await this.httpRequest.post(
+            `${this.customerCreditsUrl(directoryId, creditId)}/payments?tenantId=${encodeURIComponent(tenantId)}`,
+            body,
+        );
+    }
 }

package/src/loanCredit/api/interfaces/ILoanCreditBusinessApi.ts

@@ -23,6 +23,9 @@ import {
     LoanCreditDetail,
     LoanInstallmentResponse,
     LoanPaymentListResponse,
+    CreateCustomerPaymentRequest,
+    LoanCustomerPaymentOptions,
+    LoanCustomerPaymentResult,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     LoanCreditAnalyticsBatchRequest,
@@ -255,4 +258,26 @@ export interface ILoanCreditBusinessApi {
         contractId: string,
         tenantId: string,
     ): Promise<StandardResponse<LoanContractDownloadUrl>>;
+
+    // ─── Pagos de cliente (retail-loan-business) ────────────────────────────────
+
+    /** Opciones de pago de un crédito del cliente, con montos ya calculados. */
+    getCustomerPaymentOptions(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCustomerPaymentOptions>>;
+
+    /**
+     * Pide el cobro de una opción de pago (202). Misma `idempotencyKey` y mismo cuerpo devuelven la
+     * misma respuesta. 404 CREDIT_NOT_FOUND · 409 AD_HOC_CHARGE_PENDING · 409 CREDIT_NOT_CURRENT ·
+     * 409 CUSTOMER_PAYMENT_AMOUNT_CHANGED · 422 PAYMENT_OPTION_UNAVAILABLE · 422 IDEMPOTENCY_KEY_MISMATCH ·
+     * 5xx si el motor de cobro no contesta.
+     */
+    createCustomerPayment(
+        directoryId: string,
+        creditId: string,
+        tenantId: string,
+        body: CreateCustomerPaymentRequest,
+    ): Promise<StandardResponse<LoanCustomerPaymentResult>>;
 }

package/src/moneyTransferConnector/api/MoneyTransferConnectorApi.ts

@@ -0,0 +1,49 @@
+import {IMoneyTransferConnectorApi} from "./interfaces/IMoneyTransferConnectorApi.js";
+import {inject, injectable} from "inversify";
+import type {IHttpRequest} from "@fiado/http-client";
+import {BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+
+/**
+ * Cliente del money-transfer-connector (Centro de Beneficios — envíos de dinero / SPEI consolidado).
+ * Consumido por benefits-marketplace-business.
+ */
+@injectable()
+export default class MoneyTransferConnectorApi implements IMoneyTransferConnectorApi {
+    private readonly baseUrl = process.env.MONEY_TRANSFER_CONNECTOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {
+    }
+
+    async getStandardCatalog(params?: { benefitId?: string; includeDisabled?: boolean }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>> {
+        let url = `${this.baseUrl}/catalog/standard`;
+        if (params) {
+            const query = Object.keys(params)
+                .filter(key => params[key as keyof typeof params] !== undefined)
+                .map(key => `${key}=${encodeURIComponent(String(params[key as keyof typeof params]))}`)
+                .join('&');
+            if (query) url += `?${query}`;
+        }
+        return await this.httpRequest.get(url);
+    }
+
+    async payStandard(request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
+        const url = `${this.baseUrl}/pay/standard`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async consultStandard(transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>> {
+        const url = `${this.baseUrl}/pay/standard/transactions/${encodeURIComponent(transactionNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async createService(payload: Record<string, unknown>): Promise<ApiGatewayResponse<any>> {
+        const url = `${this.baseUrl}/internal/services`;
+        return await this.httpRequest.post(url, payload);
+    }
+
+    async updateService(idServicio: number, patch: Record<string, unknown>): Promise<ApiGatewayResponse<any>> {
+        const url = `${this.baseUrl}/internal/services/${idServicio}`;
+        return await this.httpRequest.put(url, patch);
+    }
+}

package/src/moneyTransferConnector/api/interfaces/IMoneyTransferConnectorApi.ts

@@ -0,0 +1,24 @@
+import {BenefitPaymentRequest, BenefitPaymentResponse, ConnectorCatalogResponse} from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {ApiGatewayResponse} from "@fiado/gateway-adapter";
+
+/**
+ * Contrato del money-transfer-connector (Centro de Beneficios — envíos de dinero / SPEI consolidado).
+ * Mismo shape que los métodos "standard" de IMulticommServicePaymentApi para que el
+ * PaymentRouter / CatalogTreeBuilder de benefits-marketplace-business lo consuman sin adaptar.
+ */
+export interface IMoneyTransferConnectorApi {
+    // GET /catalog/standard — catálogo estandarizado del conector.
+    getStandardCatalog(params?: { benefitId?: string; includeDisabled?: boolean }): Promise<ApiGatewayResponse<ConnectorCatalogResponse>>;
+
+    // POST /pay/standard — pago con DTO estandarizado.
+    payStandard(request: BenefitPaymentRequest): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+
+    // GET /pay/standard/transactions/{transactionNumber} — estado actual mapeado a BenefitPaymentResponse.
+    consultStandard(transactionNumber: string): Promise<ApiGatewayResponse<BenefitPaymentResponse>>;
+
+    // POST /internal/services — alta manual de un servicio (admin-leaves).
+    createService(payload: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+
+    // PUT /internal/services/{idServicio} — edición editorial in-place (admin-leaves).
+    updateService(idServicio: number, patch: Record<string, unknown>): Promise<ApiGatewayResponse<any>>;
+}

package/src/moneyTransferConnector/index.ts

@@ -0,0 +1,2 @@
+export * from './api/interfaces/IMoneyTransferConnectorApi.js';
+export * from './api/MoneyTransferConnectorApi.js';

package/src/stpSpei/api/StpSpeiApi.ts

@@ -1,6 +1,6 @@
-import {IStpSpeiApi} from "./interfaces/IStpSpeiApi.js";
+import {IStpSpeiApi, StpConsultOrderRequest} from "./interfaces/IStpSpeiApi.js";
 import {inject, injectable} from "inversify";
-import {IHttpRequest} from "@fiado/http-client";
+import type {IHttpRequest} from "@fiado/http-client";
 import {BusinessNameEnum, PutStpOrderRequest} from "@fiado/type-kit/bin/stpSpei/index.js";
 
 @injectable()
@@ -30,4 +30,13 @@ export class StpSpeiApi implements IStpSpeiApi {
         }
         return await this.httpRequest.post(url, request, headers);
     }
+
+    async consultOrder(request: StpConsultOrderRequest): Promise<any> {
+        const url = `${this.baseUrl}`;
+        const headers = {
+            'Content-Type': 'application/json',
+            operationName: "postOrdersConsult"
+        }
+        return await this.httpRequest.post(url, request, headers);
+    }
 }

package/src/stpSpei/api/interfaces/IStpSpeiApi.ts

@@ -1,7 +1,16 @@
-import {BusinessNameEnum, PutStpOrderRequest} from "@fiado/type-kit/bin/stpSpei/index.js";
+import {BusinessNameEnum, ConsultStpOrderRequest, PutStpOrderRequest} from "@fiado/type-kit/bin/stpSpei/index.js";
+
+/** Alias de compatibilidad: el request de consulta vive en @fiado/type-kit (≥ 3.464.0). */
+export type StpConsultOrderRequest = ConsultStpOrderRequest;
 
 export interface IStpSpeiApi {
     putStpOrder(request: PutStpOrderRequest): Promise<any>;
 
     getBusinessAccountBalance(businessName: BusinessNameEnum): Promise<any>;
+
+    /**
+     * Consulta una orden enviada por claveRastreo (fiado-stp-lambda `postOrdersConsult`).
+     * Agregado para money-transfer-connector (F5', DEC-027/037).
+     */
+    consultOrder(request: StpConsultOrderRequest): Promise<any>;
 }