@vtex/faststore-plugin-buyer-portal 1.3.80 → 1.3.81

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.81] - 2026-04-29
+
+### Changed
+
+- Switch payment methods route/api integration to `payment-groups` and support string-based ids in the add/remove flow (`B2BTEAM-3238`)
+- Register the page in `plugin.config.js` as `payment-groups` with path `/pvt/organization-account/payment-groups/[orgUnitId]/[contractId]` so it matches `buyerPortalRoutes` and resolves navigation 404s. Bookmarks or deep links using the previous `/pvt/organization-account/payment-methods/...` path are no longer served by this plugin (`B2BTEAM-3238`)
+
 ## [1.3.80] - 2026-04-29
 
 ### Fixed
@@ -597,7 +604,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add CHANGELOG file
 - Add README file
 
-[unreleased]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.80...HEAD
+[unreleased]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.81...HEAD
 [1.3.55]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.54...v1.3.55
 [1.3.54]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.53...v1.3.54
 [1.3.53]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.52...v1.3.53
@@ -665,6 +672,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 [1.3.65]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.64...v1.3.65
 [1.3.64]: https://github.com/vtex/faststore-plugin-buyer-portal/releases/tag/1.3.64
 [1.3.69]: https://github.com/vtex/faststore-plugin-buyer-portal/releases/tag/1.3.69
+[1.3.81]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.80...v1.3.81
 [1.3.80]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.79...v1.3.80
 [1.3.79]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.78...v1.3.79
 [1.3.78]: https://github.com/vtex/faststore-plugin-buyer-portal/compare/v1.3.77...v1.3.78

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vtex/faststore-plugin-buyer-portal",
-  "version": "1.3.80",
+  "version": "1.3.81",
   "description": "A plugin for faststore with buyer portal",
   "main": "index.js",
   "scripts": {

package/plugin.config.js

@@ -28,8 +28,8 @@ module.exports = {
       path: "/pvt/organization-account/budgets/[orgUnitId]/[contractId]/[budgetId]",
       appLayout: false,
     },
-    "payment-methods": {
-      path: "/pvt/organization-account/payment-methods/[orgUnitId]/[contractId]",
+    "payment-groups": {
+      path: "/pvt/organization-account/payment-groups/[orgUnitId]/[contractId]",
       appLayout: false,
     },
     "credit-cards": {

package/src/features/payment-methods/clients/PaymentMethodsClient.ts

@@ -2,6 +2,7 @@ import { Client } from "../../shared/clients/Client";
 import { getApiUrl } from "../../shared/utils";
 
 import type {
+  PaymentMethodId,
   PaymentMethodResponse,
   PaymentMethodsIdArray,
   PaymentMethodsReqCommonParams,
@@ -39,7 +40,7 @@ export default class PaymentMethodsClient extends Client {
     }
 
     const queryString = queryParams.toString();
-    const url = `customers/${customerId}/units/${unitId}/payment-methods/paginated${
+    const url = `customers/${customerId}/units/${unitId}/payment-groups/paginated${
       queryString ? `?${queryString}` : ""
     }`;
 
@@ -58,7 +59,7 @@ export default class PaymentMethodsClient extends Client {
     const { customerId, unitId, cookie, paymentMethodsIds } = data;
 
     return await this.post<PaymentMethodResponse, PaymentMethodsIdArray>(
-      `customers/${customerId}/units/${unitId}/payment-methods`,
+      `customers/${customerId}/units/${unitId}/payment-groups`,
       paymentMethodsIds,
       {
         headers: {
@@ -71,13 +72,13 @@ export default class PaymentMethodsClient extends Client {
 
   async removePaymentMethodFromUnit(
     data: PaymentMethodsReqCommonParams & {
-      paymentMethodId: number;
+      paymentMethodId: PaymentMethodId;
     }
   ) {
     const { customerId, unitId, cookie, paymentMethodId } = data;
 
     return await this.delete(
-      `customers/${customerId}/units/${unitId}/payment-methods/${paymentMethodId}`,
+      `customers/${customerId}/units/${unitId}/payment-groups/${paymentMethodId}`,
       null,
       {
         headers: {

package/src/features/payment-methods/components/AddPaymentMethodsDrawer/AddPaymentMethodsDrawer.tsx

@@ -19,6 +19,7 @@ import { useAddPaymentMethodsToUnit } from "../../hooks";
 import { useDebouncedSearchPaymentMethods } from "../../hooks/useDebouncedSearchPaymentMethods";
 
 import type { TableColumn } from "../../../shared/components/Table/TableHead/TableHead";
+import type { PaymentMethodId } from "../../../shared/types";
 
 export type AddPaymentMethodsDrawerProps = Omit<
   BasicDrawerProps,
@@ -35,7 +36,7 @@ export const AddPaymentMethodsDrawer = ({
   const [querySearch, setQuerySearch] = useState("");
   const [drawerPage, setDrawerPage] = useState(1);
   const [isLastPage, setIsLastPage] = useState(true);
-  const [selectedMethods, setSelectedMethods] = useState<Set<number>>(
+  const [selectedMethods, setSelectedMethods] = useState<Set<PaymentMethodId>>(
     new Set()
   );
 
@@ -116,7 +117,7 @@ export const AddPaymentMethodsDrawer = ({
     }
   }, [someSelected]);
 
-  const toggleItem = useCallback((id: number) => {
+  const toggleItem = useCallback((id: PaymentMethodId) => {
     setSelectedMethods((prev) => {
       const next = new Set(prev);
       if (next.has(id)) next.delete(id);

package/src/features/payment-methods/components/RemovePaymentMethodsDrawer/RemovePaymentMethodsDrawer.tsx

@@ -2,6 +2,7 @@ import { type BasicDrawerProps, BasicDrawer } from "../../../shared/components";
 import { useBuyerPortal } from "../../../shared/hooks";
 import { useRemovePaymentMethod } from "../../hooks/useRemovePaymentMethodSubmit";
 
+import type { PaymentMethodId } from "../../../shared/types";
 import type { PaymentMethodData } from "../../types";
 
 export type RemovePaymentMethodsDrawerProps = Omit<
@@ -27,7 +28,7 @@ export const RemovePaymentMethodsDrawer = ({
   const { remove, isRemovingPaymentMethod } =
     useRemovePaymentMethod(handleSuccess);
 
-  const handleSubmit = (paymentMethodId: number) => {
+  const handleSubmit = (paymentMethodId: PaymentMethodId) => {
     remove(paymentMethodId);
   };
 

package/src/features/payment-methods/hooks/useRemovePaymentMethodSubmit.ts

@@ -7,6 +7,7 @@ import { CHANGES_TIMEOUT_MESSAGE } from "../../shared/utils/constants";
 
 import { useRemovePaymentMethodFromUnit } from "./useRemovePaymentMethodsFromUnit";
 
+import type { PaymentMethodId } from "../../shared/types";
 import type { PaymentMethodData } from "../types";
 
 export function useRemovePaymentMethod(onAfterSuccess?: () => void) {
@@ -38,12 +39,14 @@ export function useRemovePaymentMethod(onAfterSuccess?: () => void) {
       },
     });
 
-  const remove = (paymentMethod: PaymentMethodData | number) => {
+  const remove = (paymentMethod: PaymentMethodData | PaymentMethodId) => {
     removePaymentMethod({
       customerId,
       unitId,
       paymentMethodId:
-        typeof paymentMethod === "number" ? paymentMethod : paymentMethod?.id,
+        typeof paymentMethod === "number" || typeof paymentMethod === "string"
+          ? paymentMethod
+          : paymentMethod?.id,
     });
   };
 

package/src/features/payment-methods/services/remove-payment-methods-from-unit.service.ts

@@ -1,9 +1,11 @@
 import { paymentMethodsClient } from "../clients/PaymentMethodsClient";
 
+import type { PaymentMethodId } from "../../shared/types";
+
 export type RemovePaymentMethodFromUnitServiceProps = {
   customerId: string;
   unitId: string;
-  paymentMethodId: number;
+  paymentMethodId: PaymentMethodId;
   cookie: string;
 };
 

package/src/features/payment-methods/types/PaymentMethod.ts

@@ -1,7 +1,9 @@
 import { PageControl } from "../../product-assortment/types";
 
+import type { PaymentMethodId } from "../../shared/types";
+
 export type PaymentMethodData = {
-  id: number;
+  id: PaymentMethodId;
   name: string;
   isEnabled?: boolean;
 };

package/src/features/shared/types/PaymentMethodsClientTypes.ts

@@ -1,4 +1,5 @@
-export type PaymentMethodsIdArray = Array<{ id: number }>;
+export type PaymentMethodId = string | number;
+export type PaymentMethodsIdArray = Array<{ id: PaymentMethodId }>;
 
 export type PaymentMethodResponse = {
   message: string;

package/src/features/shared/types/index.ts

@@ -4,6 +4,7 @@ export type { CurrencyType, LocaleType } from "./CurrencyType";
 export type { LoaderData } from "./LoaderData";
 export type { IPagination } from "./Pagination";
 export type {
+  PaymentMethodId,
   PaymentMethodResponse,
   PaymentMethodsIdArray,
   PaymentMethodsReqCommonParams,

package/src/features/shared/utils/buyerPortalRoutes.ts

@@ -42,7 +42,7 @@ export const buyerPortalRoutes = {
     ),
 
   paymentMethods: (params: { orgUnitId: string; contractId: string }) =>
-    replaceParams(`${base}/payment-methods/[orgUnitId]/[contractId]`, params),
+    replaceParams(`${base}/payment-groups/[orgUnitId]/[contractId]`, params),
 
   creditCards: (params: { orgUnitId: string; contractId: string }) =>
     replaceParams(`${base}/credit-cards/[orgUnitId]/[contractId]`, params),

package/src/features/shared/utils/constants.ts

@@ -22,7 +22,7 @@ export const SCOPE_KEYS = {
   CREDIT_CARDS: "creditCards",
 } as const;
 
-export const CURRENT_VERSION = "1.3.80";
+export const CURRENT_VERSION = "1.3.81";
 
 export const CHANGES_TIMEOUT_MESSAGE =
   "Changes may take up to 10 minutes to apply.";

package/src/features/shared/utils/routeLayoutMapping.ts

@@ -27,7 +27,7 @@ export const ROUTE_TABS_LAYOUT_MAPPING: Record<string, RouteTabsLayoutConfig> =
       pageName: "Contract",
       pageTitle: "Address Details",
     },
-    "/pvt/organization-account/payment-methods/[orgUnitId]/[contractId]": {
+    "/pvt/organization-account/payment-groups/[orgUnitId]/[contractId]": {
       layout: "ContractTabsLayout",
       pageName: "Contract",
       pageTitle: "Payment Methods",