@fiado/api-invoker 5.147.0 → 5.149.0

package/bin/pomelo/api/PomeloApi.d.ts

@@ -1,7 +1,8 @@
 import { IPomeloApi } from "./interfaces/IPomeloApi.js";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { CreateBankAccountRequest, CreateBankAccountUserRequest, UpdateBankAccountUserRequest } from "@fiado/type-kit/bin/account/index.js";
 import { ActivateBankAccountCardRequest, AssignCardRequest, CreateBankAccountCardShippingRequest, GetBankAccountShippingRequest, UpdateBankAccountCardRequest } from "@fiado/type-kit/bin/card/index.js";
+import { PomeloThreeDSChallengeAnswerRequest, PomeloWalletProvisioningRequest } from "@fiado/type-kit/bin/card/index.js";
 export default class PomeloApi implements IPomeloApi {
     private httpRequest;
     private readonly baseUrl;
@@ -22,4 +23,9 @@ export default class PomeloApi implements IPomeloApi {
     getUserToken(externalUserId: string): Promise<any>;
     createShipment(object: CreateBankAccountCardShippingRequest): Promise<any>;
     getShipment(object: GetBankAccountShippingRequest): Promise<any>;
+    provisionWallet(request: PomeloWalletProvisioningRequest): Promise<any>;
+    getCardTokens(externalCardId: string): Promise<any>;
+    deleteCardToken(externalCardId: string, tokenId: string): Promise<any>;
+    getPendingThreeDSChallenges(externalCardIds: string[]): Promise<any>;
+    answerThreeDSChallenge(threedsTransactionId: string, request: PomeloThreeDSChallengeAnswerRequest): Promise<any>;
 }

package/bin/pomelo/api/PomeloApi.js

@@ -84,6 +84,32 @@ let PomeloApi = class PomeloApi {
         const url = `${this.baseUrl}shipment/${object.externalShippingId}`;
         return await this.httpRequest.get(url);
     }
+    // public async replaceCardByExternalId(object: ExternalReplaceCardRequest): Promise<any> {
+    //     const url: string = `${this.baseUrl}cards/${object.externalCardId}/replace`;
+    //     return await this.httpRequest.put(url, object);
+    // }
+    // //Wallet y 3DS
+    async provisionWallet(request) {
+        const url = `${this.baseUrl}tokenization/provisioning`;
+        return await this.httpRequest.post(url, request);
+    }
+    async getCardTokens(externalCardId) {
+        const url = `${this.baseUrl}cards/${encodeURIComponent(externalCardId)}/tokens`;
+        return await this.httpRequest.get(url);
+    }
+    async deleteCardToken(externalCardId, tokenId) {
+        const url = `${this.baseUrl}tokens/${encodeURIComponent(tokenId)}/deletion`;
+        return await this.httpRequest.post(url, { cardId: externalCardId });
+    }
+    async getPendingThreeDSChallenges(externalCardIds) {
+        const cardIds = externalCardIds.map((id) => encodeURIComponent(id)).join(',');
+        const url = `${this.baseUrl}threeds/challenges/pending?cardIds=${cardIds}`;
+        return await this.httpRequest.get(url);
+    }
+    async answerThreeDSChallenge(threedsTransactionId, request) {
+        const url = `${this.baseUrl}threeds/challenges/${encodeURIComponent(threedsTransactionId)}/answer`;
+        return await this.httpRequest.post(url, request);
+    }
 };
 PomeloApi = __decorate([
     injectable(),

package/bin/pomelo/api/interfaces/IPomeloApi.d.ts

@@ -1,5 +1,6 @@
 import { CreateBankAccountRequest, CreateBankAccountUserRequest, UpdateBankAccountUserRequest } from "@fiado/type-kit/bin/account/index.js";
 import { ActivateBankAccountCardRequest, AssignCardRequest, CreateBankAccountCardShippingRequest, GetBankAccountShippingRequest, UpdateBankAccountCardRequest } from "@fiado/type-kit/bin/card/index.js";
+import { PomeloThreeDSChallengeAnswerRequest, PomeloWalletProvisioningRequest } from "@fiado/type-kit/bin/card/index.js";
 export interface IPomeloApi {
     updateUser(object: UpdateBankAccountUserRequest): Promise<any>;
     getUserById(externalUserId: string): Promise<any>;
@@ -16,4 +17,9 @@ export interface IPomeloApi {
     assignCardToUser(request: AssignCardRequest): Promise<any>;
     createShipment(object: CreateBankAccountCardShippingRequest): Promise<any>;
     getShipment(object: GetBankAccountShippingRequest): Promise<any>;
+    provisionWallet(request: PomeloWalletProvisioningRequest): Promise<any>;
+    getCardTokens(externalCardId: string): Promise<any>;
+    deleteCardToken(externalCardId: string, tokenId: string): Promise<any>;
+    getPendingThreeDSChallenges(externalCardIds: string[]): Promise<any>;
+    answerThreeDSChallenge(threedsTransactionId: string, request: PomeloThreeDSChallengeAnswerRequest): Promise<any>;
 }

package/bin/uniteller-connector/api/UnitellerConnectorApi.d.ts

@@ -1,7 +1,7 @@
 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, RemittanceBackofficeStatsRangeRequest, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, 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 { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, KycUserDetail, KycUsersListResponse, KycOnboardingAttemptsResponse, RefreshUserProfileResponse, RegisterOnboardingBlockRequest, RegisterOnboardingBlockResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsRangeRequest, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, 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, PricingScheduleRequest, PricingScheduleResponse } from "@fiado/type-kit/bin/remittance/index.js";
 import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi.js";
 export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
     private httpRequest;
@@ -33,7 +33,7 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         deactivated: boolean;
         beneficiaryId: string;
     }>>;
-    pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
+    pricingSchedule(directoryId: string, corridor: RemittanceCorridor, costContext?: Pick<PricingScheduleRequest, "payerCode" | "receptionMethod">): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
     quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>>;
     sendPreview(directoryId: string, request: RemittanceSendPreviewRequest): Promise<ApiGatewayResponse<RemittanceSendPreviewResponse>>;
     pay(directoryId: string, request: RemittancePayRequest): Promise<ApiGatewayResponse<RemittancePayResponse>>;

package/bin/uniteller-connector/api/UnitellerConnectorApi.js

@@ -77,9 +77,15 @@ let UnitellerConnectorApi = class UnitellerConnectorApi {
         const url = `${this.baseUrl}/beneficiaries/${encodeURIComponent(beneficiaryId)}/deactivate`;
         return await this.httpRequest.post(url, { directoryId, ...(actor && { actor }) });
     }
-    async pricingSchedule(directoryId, corridor) {
+    async pricingSchedule(directoryId, corridor, costContext) {
         const url = `${this.baseUrl}/pricing/schedule`;
-        return await this.httpRequest.post(url, { directoryId, corridor });
+        // Solo los campos que vienen: sin ellos el body queda igual que antes.
+        return await this.httpRequest.post(url, {
+            directoryId,
+            corridor,
+            ...(costContext?.payerCode && { payerCode: costContext.payerCode }),
+            ...(costContext?.receptionMethod && { receptionMethod: costContext.receptionMethod }),
+        });
     }
     async quote(directoryId, request) {
         const url = `${this.baseUrl}/quote`;

package/bin/uniteller-connector/api/interfaces/IUnitellerConnectorApi.d.ts

@@ -1,6 +1,6 @@
 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, RemittanceCorridor, PricingScheduleResponse, KycUserDetail, KycUsersListResponse, KycOnboardingAttemptsResponse, RefreshUserProfileResponse, RegisterOnboardingBlockRequest, RegisterOnboardingBlockResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsRangeRequest, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, 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 { CohortCountRequest, CohortCountResponse, CohortUserMatchRequest, CohortUserMatchResponse, PricingMetricsRequest, PricingMetricsResponse, PromotionReachRequest, PromotionReachResponse, SegmentMetricsRequest, SegmentMetricsResponse, WholesaleRateRequest, WholesaleRateResponse, RemittanceCorridor, PricingScheduleRequest, PricingScheduleResponse, KycUserDetail, KycUsersListResponse, KycOnboardingAttemptsResponse, RefreshUserProfileResponse, RegisterOnboardingBlockRequest, RegisterOnboardingBlockResponse, RemittanceAddBeneficiaryRequest, RemittanceBackofficeDashboardSummary, RemittanceBackofficeStats, RemittanceBackofficeStatsRangeRequest, RemittanceBackofficeStatsPeriod, RemittanceBackofficeCancelCloseRequest, RemittanceBackofficeCancelCloseResponse, 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";
 export interface IUnitellerConnectorApi {
     /** Estado del módulo remesas para un directoryId. */
     getHome(directoryId: string): Promise<ApiGatewayResponse<RemittanceHomeResponse>>;
@@ -45,8 +45,11 @@ export interface IUnitellerConnectorApi {
         deactivated: boolean;
         beneficiaryId: string;
     }>>;
-    /** Schedule de tramos de service fee + promo automática por corredor (F2 app; passthrough a remittance-business). POST /pricing/schedule. */
-    pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
+    /**
+     * Schedule de tramos de service fee + promo automática por corredor (F2 app; passthrough a remittance-business). POST /pricing/schedule.
+     * Con payer y método (opcionales) cada fee incluye el cobro extra de su grupo de costo.
+     */
+    pricingSchedule(directoryId: string, corridor: RemittanceCorridor, costContext?: Pick<PricingScheduleRequest, "payerCode" | "receptionMethod">): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
     /** Cotización rápida (debounce). Read-only. */
     quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.147.0",
+  "version": "5.149.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.14.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.585.0",
+    "@fiado/type-kit": "^3.594.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/pomelo/api/PomeloApi.ts

@@ -1,8 +1,9 @@
 import { IPomeloApi } from "./interfaces/IPomeloApi.js";
 import { inject, injectable } from "inversify";
-import { IHttpRequest } from "@fiado/http-client";
+import type { IHttpRequest } from "@fiado/http-client";
 import { CreateBankAccountRequest, CreateBankAccountUserRequest, UpdateBankAccountUserRequest } from "@fiado/type-kit/bin/account/index.js";
 import { ActivateBankAccountCardRequest, AssignCardRequest, CreateBankAccountCardShippingRequest, GetBankAccountShippingRequest, UpdateBankAccountCardRequest } from "@fiado/type-kit/bin/card/index.js";
+import { PomeloThreeDSChallengeAnswerRequest, PomeloWalletProvisioningRequest } from "@fiado/type-kit/bin/card/index.js";
 
 
 @injectable()
@@ -103,7 +104,31 @@ export default class PomeloApi implements IPomeloApi {
     //     return await this.httpRequest.put(url, object);
     // }
 
+    // //Wallet y 3DS
 
+    public async provisionWallet(request: PomeloWalletProvisioningRequest): Promise<any> {
+        const url: string = `${this.baseUrl}tokenization/provisioning`;
+        return await this.httpRequest.post(url, request);
+    }
+
+    public async getCardTokens(externalCardId: string): Promise<any> {
+        const url: string = `${this.baseUrl}cards/${encodeURIComponent(externalCardId)}/tokens`;
+        return await this.httpRequest.get(url);
+    }
 
+    public async deleteCardToken(externalCardId: string, tokenId: string): Promise<any> {
+        const url: string = `${this.baseUrl}tokens/${encodeURIComponent(tokenId)}/deletion`;
+        return await this.httpRequest.post(url, { cardId: externalCardId });
+    }
 
+    public async getPendingThreeDSChallenges(externalCardIds: string[]): Promise<any> {
+        const cardIds = externalCardIds.map((id) => encodeURIComponent(id)).join(',');
+        const url: string = `${this.baseUrl}threeds/challenges/pending?cardIds=${cardIds}`;
+        return await this.httpRequest.get(url);
+    }
+
+    public async answerThreeDSChallenge(threedsTransactionId: string, request: PomeloThreeDSChallengeAnswerRequest): Promise<any> {
+        const url: string = `${this.baseUrl}threeds/challenges/${encodeURIComponent(threedsTransactionId)}/answer`;
+        return await this.httpRequest.post(url, request);
+    }
 }

package/src/pomelo/api/interfaces/IPomeloApi.ts

@@ -1,5 +1,6 @@
 import {CreateBankAccountRequest, CreateBankAccountUserRequest, UpdateBankAccountUserRequest } from "@fiado/type-kit/bin/account/index.js";
 import { ActivateBankAccountCardRequest, AssignCardRequest, CreateBankAccountCardShippingRequest, GetBankAccountShippingRequest, UpdateBankAccountCardRequest } from "@fiado/type-kit/bin/card/index.js";
+import { PomeloThreeDSChallengeAnswerRequest, PomeloWalletProvisioningRequest } from "@fiado/type-kit/bin/card/index.js";
 
 export interface IPomeloApi {
 
@@ -25,6 +26,13 @@ export interface IPomeloApi {
     createShipment(object: CreateBankAccountCardShippingRequest): Promise<any>
     getShipment(object: GetBankAccountShippingRequest): Promise<any>
 
+    // //Wallet y 3DS
+    provisionWallet(request: PomeloWalletProvisioningRequest): Promise<any>;
+    getCardTokens(externalCardId: string): Promise<any>;
+    deleteCardToken(externalCardId: string, tokenId: string): Promise<any>;
+    getPendingThreeDSChallenges(externalCardIds: string[]): Promise<any>;
+    answerThreeDSChallenge(threedsTransactionId: string, request: PomeloThreeDSChallengeAnswerRequest): Promise<any>;
+
 
 
 }

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

@@ -59,6 +59,7 @@ import {
     RemittanceUserLimits,
     RemittanceUserLimitsBatchResponse,
     RemittanceCorridor,
+    PricingScheduleRequest,
     PricingScheduleResponse,
 } from "@fiado/type-kit/bin/remittance/index.js";
 import { IUnitellerConnectorApi } from "./interfaces/IUnitellerConnectorApi.js";
@@ -142,9 +143,19 @@ export default class UnitellerConnectorApi implements IUnitellerConnectorApi {
         return await this.httpRequest.post(url, { directoryId, ...(actor && { actor }) });
     }
 
-    async pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>> {
+    async pricingSchedule(
+        directoryId: string,
+        corridor: RemittanceCorridor,
+        costContext?: Pick<PricingScheduleRequest, "payerCode" | "receptionMethod">,
+    ): Promise<ApiGatewayResponse<PricingScheduleResponse>> {
         const url = `${this.baseUrl}/pricing/schedule`;
-        return await this.httpRequest.post(url, { directoryId, corridor });
+        // Solo los campos que vienen: sin ellos el body queda igual que antes.
+        return await this.httpRequest.post(url, {
+            directoryId,
+            corridor,
+            ...(costContext?.payerCode && { payerCode: costContext.payerCode }),
+            ...(costContext?.receptionMethod && { receptionMethod: costContext.receptionMethod }),
+        });
     }
 
     async quote(directoryId: string, request: RemittanceQuoteRequest): Promise<ApiGatewayResponse<RemittanceQuoteResponse>> {

package/src/uniteller-connector/api/interfaces/IUnitellerConnectorApi.ts

@@ -14,6 +14,7 @@ import {
     WholesaleRateRequest,
     WholesaleRateResponse,
     RemittanceCorridor,
+    PricingScheduleRequest,
     PricingScheduleResponse,
     KycUserDetail,
     KycUsersListResponse,
@@ -113,8 +114,15 @@ export interface IUnitellerConnectorApi {
     addBeneficiary(directoryId: string, request: RemittanceAddBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
     updateBeneficiary(directoryId: string, beneficiaryId: string, request: RemittanceUpdateBeneficiaryRequest, actor?: string): Promise<ApiGatewayResponse<RemittanceBeneficiary>>;
     deactivateBeneficiary(directoryId: string, beneficiaryId: string, actor?: string): Promise<ApiGatewayResponse<{ deactivated: boolean; beneficiaryId: string }>>;
-    /** Schedule de tramos de service fee + promo automática por corredor (F2 app; passthrough a remittance-business). POST /pricing/schedule. */
-    pricingSchedule(directoryId: string, corridor: RemittanceCorridor): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
+    /**
+     * Schedule de tramos de service fee + promo automática por corredor (F2 app; passthrough a remittance-business). POST /pricing/schedule.
+     * Con payer y método (opcionales) cada fee incluye el cobro extra de su grupo de costo.
+     */
+    pricingSchedule(
+        directoryId: string,
+        corridor: RemittanceCorridor,
+        costContext?: Pick<PricingScheduleRequest, "payerCode" | "receptionMethod">,
+    ): Promise<ApiGatewayResponse<PricingScheduleResponse>>;
 
     // ─── Quote + Preview (F5) ────────────────────────────────────────────────────