@fiado/api-invoker 4.57.0 → 4.59.0

package/src/uniteller-connector/api/UnitellerConnectorApi.ts

@@ -1,304 +1,311 @@
-import { inject, injectable } from "inversify";
-import type { IHttpRequest } from "@fiado/http-client";
-import { ApiGatewayResponse } from "@fiado/gateway-adapter";
-import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
-import {
-    CohortCountRequest,
-    CohortCountResponse,
-    CohortUserMatchRequest,
-    CohortUserMatchResponse,
-    PricingMetricsRequest,
-    PricingMetricsResponse,
-    PromotionReachRequest,
-    PromotionReachResponse,
-    SegmentMetricsRequest,
-    SegmentMetricsResponse,
-    WholesaleRateRequest,
-    WholesaleRateResponse,
-    KycUserDetail,
-    KycUsersListResponse,
-    KycOnboardingAttemptsResponse,
-    RefreshUserProfileResponse,
-    RegisterOnboardingBlockRequest,
-    RegisterOnboardingBlockResponse,
-    RemittanceAddBeneficiaryRequest,
-    RemittanceBackofficeDashboardSummary,
-    RemittanceBackofficeStats,
-    RemittanceBackofficeStatsPeriod,
-    RemittanceBackofficeTransaction,
-    RemittanceBackofficeTxListResponse,
-    RemittanceBackofficeUserDetail,
-    RemittanceBackofficeUserListResponse,
-    RemittanceBeneficiary,
-    RemittanceCancelRequest,
-    RemittanceCancelResponse,
-    RemittanceHomeResponse,
-    RemittanceListBeneficiariesResponse,
-    RemittanceOnboardRequest,
-    RemittanceOnboardResponse,
-    RemittancePayRequest,
-    RemittancePayResponse,
-    RemittancePayerAdditionalFieldDto,
-    RemittancePayerBranchDto,
-    RemittancePayerDto,
-    RemittanceQuoteRequest,
-    RemittanceQuoteResponse,
-    RemittanceSecurityQuestionsResponse,
-    RemittanceSendPreviewRequest,
-    RemittanceSendPreviewResponse,
-    RemittanceSmsRequest,
-    RemittanceStateDto,
-    RemittanceTransactionDetail,
-    RemittanceTransactionReceipt,
-    RemittanceTransactionsListRequest,
-    RemittanceTransactionsListResponse,
-    RemittanceUpdateBeneficiaryRequest,
-    RemittanceUserLimits,
-    RemittanceUserLimitsBatchResponse,
-} from "@fiado/type-kit/bin/remittance/index.js";
-import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi.js";
-
-@injectable()
-export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
-    private readonly baseUrl = process.env.UNITELLER_CONNECTOR_LAMBDA_URL || "";
-
-    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
-
-    async getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>> {
-        const url = `${this.baseUrl}/home`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async getSecurityQuestions(): Promise<ApiGatewayResponse<RemittanceSecurityQuestionsResponse>> {
-        const url = `${this.baseUrl}/onboard/security-questions`;
-        return await this.httpRequest.get(url);
-    }
-
-    async onboard(request: RemittanceOnboardRequest): Promise<ApiGatewayResponse<RemittanceOnboardResponse>> {
-        const url = `${this.baseUrl}/onboard`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async getStandardCatalog(): Promise<ApiGatewayResponse<ConnectorCatalogItem[]>> {
-        const url = `${this.baseUrl}/catalog/standard`;
-        return await this.httpRequest.get(url);
-    }
-
-    async countryStates(countryISO: string): Promise<ApiGatewayResponse<RemittanceStateDto[]>> {
-        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/states`;
-        return await this.httpRequest.get(url);
-    }
-
-    async countryPayers(countryISO: string, currencyISO: string): Promise<ApiGatewayResponse<RemittancePayerDto[]>> {
-        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/payers`;
-        return await this.httpRequest.get(url, { currencyISO });
-    }
-
-    async payerBranches(params: { payerCode: string; receptionMethodName: string; countryISO: string; currencyISO: string; stateISO: string }): Promise<ApiGatewayResponse<RemittancePayerBranchDto[]>> {
-        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/branches`;
-        return await this.httpRequest.get(url, {
-            receptionMethodName: params.receptionMethodName,
-            countryISO: params.countryISO,
-            currencyISO: params.currencyISO,
-            stateISO: params.stateISO,
-        });
-    }
-
-    async payerAdditionalFields(params: { payerCode: string; currencyISO: string; receptionMethodName: string }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>> {
-        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/fields`;
-        return await this.httpRequest.get(url, {
-            currencyISO: params.currencyISO,
-            receptionMethodName: params.receptionMethodName,
-        });
-    }
-
-    async listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>> {
-        const url = `${this.baseUrl}/beneficiaries/list`;
-        return await this.httpRequest.post(url, { directoryId, includeDeactivated });
-    }
-
-    async getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
-        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
-        const url = `${this.baseUrl}/beneficiaries`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
-        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
-        return await this.httpRequest.put(url, { directoryId, ...request });
-    }
-
-    async deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>> {
-        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}/deactivate`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>> {
-        const url = `${this.baseUrl}/quote`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async sendPreview(directoryId: string, request: RemittanceSendPreviewRequest): Promise<ApiGatewayResponse<RemittanceSendPreviewResponse>> {
-        const url = `${this.baseUrl}/send/preview`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>> {
-        const url = `${this.baseUrl}/pay`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async getTransactionByMarketplaceRef(ref: string): Promise<ApiGatewayResponse<RemittancePayResponse>> {
-        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async getTransactionDetailByMarketplaceRef(
-        directoryId: string,
-        ref: string,
-    ): Promise<ApiGatewayResponse<RemittanceTransactionDetail>> {
-        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}/detail`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async getTransactionReceiptByMarketplaceRef(
-        directoryId: string,
-        ref: string,
-    ): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>> {
-        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}/receipt`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async listTransactions(directoryId: string, filters?: RemittanceTransactionsListRequest): Promise<ApiGatewayResponse<RemittanceTransactionsListResponse>> {
-        const url = `${this.baseUrl}/transactions/list`;
-        return await this.httpRequest.post(url, { directoryId, ...(filters ?? {}) });
-    }
-
-    async getTransaction(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionDetail>> {
-        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async getTransactionReceipt(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>> {
-        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/receipt`;
-        return await this.httpRequest.post(url, { directoryId });
-    }
-
-    async cancelTransaction(directoryId: string, txNumber: string, request: RemittanceCancelRequest): Promise<ApiGatewayResponse<RemittanceCancelResponse>> {
-        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/cancel`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async smsTransactionAlert(directoryId: string, txNumber: string, request: RemittanceSmsRequest): Promise<ApiGatewayResponse<{ sent: boolean }>> {
-        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/sms`;
-        return await this.httpRequest.post(url, { directoryId, ...request });
-    }
-
-    async backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>> {
-        const url = `${this.baseUrl}/backoffice/dashboard`;
-        return await this.httpRequest.get(url);
-    }
-
-    async backofficeListUsers(filters?: { status?: string; email?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>> {
-        const url = `${this.baseUrl}/backoffice/users`;
-        return await this.httpRequest.get(url, dropUndefined(filters));
-    }
-
-    async backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>> {
-        const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async backofficeListTransactions(filters?: { txNumber?: string; directoryId?: string; status?: string; countryISO?: string; from?: string; to?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>> {
-        const url = `${this.baseUrl}/backoffice/transactions`;
-        return await this.httpRequest.get(url, dropUndefined(filters));
-    }
-
-    async backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>> {
-        const url = `${this.baseUrl}/backoffice/transactions/${encodeURIComponent(txNumber)}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>> {
-        const url = `${this.baseUrl}/backoffice/stats`;
-        return await this.httpRequest.get(url, { period });
-    }
-
-    async backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>> {
-        const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}/limits`;
-        return await this.httpRequest.get(url);
-    }
-
-    async backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>> {
-        const url = `${this.baseUrl}/backoffice/users/limits`;
-        return await this.httpRequest.get(url, { directoryIds: directoryIds.join(",") });
-    }
-
-    async kycListUsers(filters?: { status?: string; search?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<KycUsersListResponse>> {
-        const url = `${this.baseUrl}/backoffice/kyc/users`;
-        return await this.httpRequest.get(url, dropUndefined(filters));
-    }
-
-    async kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>> {
-        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}`;
-        return await this.httpRequest.get(url);
-    }
-
-    async kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>> {
-        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/refresh`;
-        return await this.httpRequest.post(url, {});
-    }
-
-    async kycOnboardingAttempts(directoryId: string): Promise<ApiGatewayResponse<KycOnboardingAttemptsResponse>> {
-        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/onboarding-attempts`;
-        return await this.httpRequest.get(url);
-    }
-
-    async registerOnboardingBlock(request: RegisterOnboardingBlockRequest): Promise<ApiGatewayResponse<RegisterOnboardingBlockResponse>> {
-        const url = `${this.baseUrl}/onboard/block`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>> {
-        const url = `${this.baseUrl}/backoffice/config/cohorts/count`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>> {
-        const url = `${this.baseUrl}/backoffice/config/cohorts/user-match`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>> {
-        const url = `${this.baseUrl}/backoffice/config/segments/metrics`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>> {
-        const url = `${this.baseUrl}/backoffice/pricing/wholesale`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>> {
-        const url = `${this.baseUrl}/backoffice/config/pricing/metrics`;
-        return await this.httpRequest.post(url, request);
-    }
-
-    async promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>> {
-        const url = `${this.baseUrl}/backoffice/config/promotions/reach`;
-        return await this.httpRequest.post(url, request);
-    }
-}
-
-/** Quita las keys undefined para no mandar query params vacíos. */
-function dropUndefined(params?: Record<string, string | number | undefined>): Record<string, string | number> | undefined {
-    if (!params) return undefined;
-    const clean = Object.fromEntries(
-        Object.entries(params).filter(([, value]) => value !== undefined),
-    ) as Record<string, string | number>;
-    return Object.keys(clean).length > 0 ? clean : undefined;
-}
+import { inject, injectable } from "inversify";
+import type { IHttpRequest } from "@fiado/http-client";
+import { ApiGatewayResponse } from "@fiado/gateway-adapter";
+import { ConnectorCatalogItem } from "@fiado/type-kit/bin/benefitCenter/index.js";
+import {
+    CohortCountRequest,
+    CohortCountResponse,
+    CohortUserMatchRequest,
+    CohortUserMatchResponse,
+    PricingMetricsRequest,
+    PricingMetricsResponse,
+    PromotionReachRequest,
+    PromotionReachResponse,
+    SegmentMetricsRequest,
+    SegmentMetricsResponse,
+    WholesaleRateRequest,
+    WholesaleRateResponse,
+    KycUserDetail,
+    KycUsersListResponse,
+    KycOnboardingAttemptsResponse,
+    RefreshUserProfileResponse,
+    RegisterOnboardingBlockRequest,
+    RegisterOnboardingBlockResponse,
+    RemittanceAddBeneficiaryRequest,
+    RemittanceBackofficeDashboardSummary,
+    RemittanceBackofficeStats,
+    RemittanceBackofficeStatsPeriod,
+    RemittanceBackofficeTransaction,
+    RemittanceBackofficeTxListResponse,
+    RemittanceBackofficeUserDetail,
+    RemittanceBackofficeUserListResponse,
+    RemittanceBeneficiary,
+    RemittanceCancelRequest,
+    RemittanceCancelResponse,
+    RemittanceHomeResponse,
+    RemittanceListBeneficiariesResponse,
+    RemittanceOnboardRequest,
+    RemittanceOnboardResponse,
+    RemittancePayRequest,
+    RemittancePayResponse,
+    RemittancePayerAdditionalFieldDto,
+    RemittancePayerBranchDto,
+    RemittancePayerDto,
+    RemittanceQuoteRequest,
+    RemittanceQuoteResponse,
+    RemittanceSecurityQuestionsResponse,
+    RemittanceSendPreviewRequest,
+    RemittanceSendPreviewResponse,
+    RemittanceSmsRequest,
+    RemittanceStateDto,
+    RemittanceTransactionDetail,
+    RemittanceTransactionReceipt,
+    RemittanceTransactionsListRequest,
+    RemittanceTransactionsListResponse,
+    RemittanceUpdateBeneficiaryRequest,
+    RemittanceUserLimits,
+    RemittanceUserLimitsBatchResponse,
+    RemittanceCorridor,
+    PricingScheduleResponse,
+} from "@fiado/type-kit/bin/remittance/index.js";
+import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi.js";
+
+@injectable()
+export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
+    private readonly baseUrl = process.env.UNITELLER_CONNECTOR_LAMBDA_URL || "";
+
+    constructor(@inject("IHttpRequest") private httpRequest: IHttpRequest) {}
+
+    async getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>> {
+        const url = `${this.baseUrl}/home`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async getSecurityQuestions(): Promise<ApiGatewayResponse<RemittanceSecurityQuestionsResponse>> {
+        const url = `${this.baseUrl}/onboard/security-questions`;
+        return await this.httpRequest.get(url);
+    }
+
+    async onboard(request: RemittanceOnboardRequest): Promise<ApiGatewayResponse<RemittanceOnboardResponse>> {
+        const url = `${this.baseUrl}/onboard`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async getStandardCatalog(): Promise<ApiGatewayResponse<ConnectorCatalogItem[]>> {
+        const url = `${this.baseUrl}/catalog/standard`;
+        return await this.httpRequest.get(url);
+    }
+
+    async countryStates(countryISO: string): Promise<ApiGatewayResponse<RemittanceStateDto[]>> {
+        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/states`;
+        return await this.httpRequest.get(url);
+    }
+
+    async countryPayers(countryISO: string, currencyISO: string): Promise<ApiGatewayResponse<RemittancePayerDto[]>> {
+        const url = `${this.baseUrl}/countries/${encodeURIComponent(countryISO)}/payers`;
+        return await this.httpRequest.get(url, { currencyISO });
+    }
+
+    async payerBranches(params: { payerCode: string; receptionMethodName: string; countryISO: string; currencyISO: string; stateISO: string }): Promise<ApiGatewayResponse<RemittancePayerBranchDto[]>> {
+        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/branches`;
+        return await this.httpRequest.get(url, {
+            receptionMethodName: params.receptionMethodName,
+            countryISO: params.countryISO,
+            currencyISO: params.currencyISO,
+            stateISO: params.stateISO,
+        });
+    }
+
+    async payerAdditionalFields(params: { payerCode: string; currencyISO: string; receptionMethodName: string }): Promise<ApiGatewayResponse<RemittancePayerAdditionalFieldDto[]>> {
+        const url = `${this.baseUrl}/payers/${encodeURIComponent(params.payerCode)}/fields`;
+        return await this.httpRequest.get(url, {
+            currencyISO: params.currencyISO,
+            receptionMethodName: params.receptionMethodName,
+        });
+    }
+
+    async listBeneficiaries(directoryId: string, includeDeactivated?: boolean): Promise<ApiGatewayResponse<RemittanceListBeneficiariesResponse>> {
+        const url = `${this.baseUrl}/beneficiaries/list`;
+        return await this.httpRequest.post(url, { directoryId, includeDeactivated });
+    }
+
+    async getBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+        const url = `${this.baseUrl}/beneficiaries`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest): Promise<ApiGatewayResponse<RemittanceBeneficiary>> {
+        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}`;
+        return await this.httpRequest.put(url, { directoryId, ...request });
+    }
+
+    async deactivateBeneficiary(directoryId: string, beneficiaryId: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>> {
+        const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}/deactivate`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>> {
+        const url = `${this.baseUrl}/pricing/schedule`;
+        return await this.httpRequest.post(url, { directoryId, corridor });
+    }
+
+    async quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>> {
+        const url = `${this.baseUrl}/quote`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async sendPreview(directoryId: string, request: RemittanceSendPreviewRequest): Promise<ApiGatewayResponse<RemittanceSendPreviewResponse>> {
+        const url = `${this.baseUrl}/send/preview`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>> {
+        const url = `${this.baseUrl}/pay`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async getTransactionByMarketplaceRef(ref: string): Promise<ApiGatewayResponse<RemittancePayResponse>> {
+        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async getTransactionDetailByMarketplaceRef(
+        directoryId: string,
+        ref: string,
+    ): Promise<ApiGatewayResponse<RemittanceTransactionDetail>> {
+        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}/detail`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async getTransactionReceiptByMarketplaceRef(
+        directoryId: string,
+        ref: string,
+    ): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>> {
+        const url = `${this.baseUrl}/transactions/by-marketplace-ref/${encodeURIComponent(ref)}/receipt`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async listTransactions(directoryId: string, filters?: RemittanceTransactionsListRequest): Promise<ApiGatewayResponse<RemittanceTransactionsListResponse>> {
+        const url = `${this.baseUrl}/transactions/list`;
+        return await this.httpRequest.post(url, { directoryId, ...(filters ?? {}) });
+    }
+
+    async getTransaction(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionDetail>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async getTransactionReceipt(directoryId: string, txNumber: string): Promise<ApiGatewayResponse<RemittanceTransactionReceipt>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/receipt`;
+        return await this.httpRequest.post(url, { directoryId });
+    }
+
+    async cancelTransaction(directoryId: string, txNumber: string, request: RemittanceCancelRequest): Promise<ApiGatewayResponse<RemittanceCancelResponse>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/cancel`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async smsTransactionAlert(directoryId: string, txNumber: string, request: RemittanceSmsRequest): Promise<ApiGatewayResponse<{ sent: boolean }>> {
+        const url = `${this.baseUrl}/transactions/${encodeURIComponent(txNumber)}/sms`;
+        return await this.httpRequest.post(url, { directoryId, ...request });
+    }
+
+    async backofficeDashboard(): Promise<ApiGatewayResponse<RemittanceBackofficeDashboardSummary>> {
+        const url = `${this.baseUrl}/backoffice/dashboard`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeListUsers(filters?: { status?: string; email?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeUserListResponse>> {
+        const url = `${this.baseUrl}/backoffice/users`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async backofficeUserDetail(directoryId: string): Promise<ApiGatewayResponse<RemittanceBackofficeUserDetail>> {
+        const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeListTransactions(filters?: { txNumber?: string; directoryId?: string; status?: string; countryISO?: string; from?: string; to?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<RemittanceBackofficeTxListResponse>> {
+        const url = `${this.baseUrl}/backoffice/transactions`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async backofficeTransactionDetail(txNumber: string): Promise<ApiGatewayResponse<RemittanceBackofficeTransaction>> {
+        const url = `${this.baseUrl}/backoffice/transactions/${encodeURIComponent(txNumber)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeStats(period: RemittanceBackofficeStatsPeriod): Promise<ApiGatewayResponse<RemittanceBackofficeStats>> {
+        const url = `${this.baseUrl}/backoffice/stats`;
+        return await this.httpRequest.get(url, { period });
+    }
+
+    async backofficeUserLimits(directoryId: string): Promise<ApiGatewayResponse<RemittanceUserLimits>> {
+        const url = `${this.baseUrl}/backoffice/users/${encodeURIComponent(directoryId)}/limits`;
+        return await this.httpRequest.get(url);
+    }
+
+    async backofficeUserLimitsBatch(directoryIds: string[]): Promise<ApiGatewayResponse<RemittanceUserLimitsBatchResponse>> {
+        const url = `${this.baseUrl}/backoffice/users/limits`;
+        return await this.httpRequest.get(url, { directoryIds: directoryIds.join(",") });
+    }
+
+    async kycListUsers(filters?: { status?: string; search?: string; pageSize?: number; index?: string }): Promise<ApiGatewayResponse<KycUsersListResponse>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users`;
+        return await this.httpRequest.get(url, dropUndefined(filters));
+    }
+
+    async kycUserDetail(directoryId: string): Promise<ApiGatewayResponse<KycUserDetail>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}`;
+        return await this.httpRequest.get(url);
+    }
+
+    async kycRefreshUser(directoryId: string): Promise<ApiGatewayResponse<RefreshUserProfileResponse>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/refresh`;
+        return await this.httpRequest.post(url, {});
+    }
+
+    async kycOnboardingAttempts(directoryId: string): Promise<ApiGatewayResponse<KycOnboardingAttemptsResponse>> {
+        const url = `${this.baseUrl}/backoffice/kyc/users/${encodeURIComponent(directoryId)}/onboarding-attempts`;
+        return await this.httpRequest.get(url);
+    }
+
+    async registerOnboardingBlock(request: RegisterOnboardingBlockRequest): Promise<ApiGatewayResponse<RegisterOnboardingBlockResponse>> {
+        const url = `${this.baseUrl}/onboard/block`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async cohortCount(request: CohortCountRequest): Promise<ApiGatewayResponse<CohortCountResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/cohorts/count`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async cohortUserMatch(request: CohortUserMatchRequest): Promise<ApiGatewayResponse<CohortUserMatchResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/cohorts/user-match`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async segmentMetrics(request: SegmentMetricsRequest): Promise<ApiGatewayResponse<SegmentMetricsResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/segments/metrics`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async wholesaleRate(request: WholesaleRateRequest): Promise<ApiGatewayResponse<WholesaleRateResponse>> {
+        const url = `${this.baseUrl}/backoffice/pricing/wholesale`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async pricingMetrics(request: PricingMetricsRequest): Promise<ApiGatewayResponse<PricingMetricsResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/pricing/metrics`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    async promotionReach(request: PromotionReachRequest): Promise<ApiGatewayResponse<PromotionReachResponse>> {
+        const url = `${this.baseUrl}/backoffice/config/promotions/reach`;
+        return await this.httpRequest.post(url, request);
+    }
+}
+
+/** Quita las keys undefined para no mandar query params vacíos. */
+function dropUndefined(params?: Record<string, string | number | undefined>): Record<string, string | number> | undefined {
+    if (!params) return undefined;
+    const clean = Object.fromEntries(
+        Object.entries(params).filter(([, value]) => value !== undefined),
+    ) as Record<string, string | number>;
+    return Object.keys(clean).length > 0 ? clean : undefined;
+}