feat: fee estimation module #3781

Anubhav-Ghosh1 · 2025-10-30T11:10:23Z

Type of Change

Description

Added Fee Estimation Module

This feature introduces a Fee Estimation module that enables merchants to use their transaction data to estimate interchange and scheme fee breakdowns.

The module consists of two key components:

1. Overview Module

Provides aggregated insights for a selected date range, including:

Total cost incurred breakdown across interchange and scheme fees.
Geolocation-based breakdown displaying fee distribution across regions.
Fee breakdown table showing each fee type and its contribution to total cost.
- Clicking on a fee entry opens a side modal with detailed information such as:
  - Regional breakdown
  - Total transactions where the fee was applied
  - Associated processor, cost, and contribution percentage

2. Transaction View Module

Displays transaction-level insights in a tabular format.

Selecting a transaction reveals detailed insights including:
- Processor
- Card type, brand, variant, and regionality
- Transaction value and total fees
- A detailed fee breakdown by interchange and scheme components

Motivation and Context

This feature enables users to gain detailed insights into the fee breakdown, helping them understand how interchange and scheme fees contribute to their overall transaction costs.

How did you test it?

Screen.Recording.2025-10-30.at.4.32.25.PM.mov

Manually tested the following scenarios:

Provided empty data to mock scenario when data is not available.
Pagination works correctly with 10 rows per page

Where to test it?

Since the transaction data used for this module isn’t available in the Integ environment, two separate flows are implemented for testing:

Integ & Local: Use mock data to simulate API responses and enable feature validation.
Sandbox & Production: Use the actual API to fetch live transaction data.

INTEG
SANDBOX
PROD

Checklist

I ran npm run re:build
I reviewed submitted code
I added unit tests for my changes where possible

semanticdiff-com · 2025-10-30T11:10:26Z

Review changes with

Changed Files

File	Status
public/hyperswitch/icons/solid.svg	0% smaller
src/APIUtils/APIUtils.res	Unsupported file format
src/APIUtils/APIUtilsTypes.res	Unsupported file format
src/Orchestration/OrchestrationApp.res	Unsupported file format
src/Recoils/TableAtoms.res	Unsupported file format
src/components/Graphs/BarGraph/BarGraphTypes.res	Unsupported file format
src/components/Graphs/BarGraph/BarGraphUtils.res	Unsupported file format
src/container/AnalyticsContainer.res	Unsupported file format
src/entryPoints/FeatureFlagUtils.res	Unsupported file format
src/entryPoints/SidebarValues.res	Unsupported file format
src/screens/Analytics/FeeEstimation/FeeEstimation.res	Unsupported file format
src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationOverview.res	Unsupported file format
src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationTransactionView.res	Unsupported file format
src/screens/Analytics/FeeEstimation/FeeEstimationEntity.res	Unsupported file format
src/screens/Analytics/FeeEstimation/FeeEstimationHelper.res	Unsupported file format
src/screens/Analytics/FeeEstimation/FeeEstimationTypes.res	Unsupported file format
src/screens/Analytics/FeeEstimation/FeeEstimationUtils.res	Unsupported file format
src/screens/NewAnalytics/Insights/InsightsRefundsAnalytics/InsightsRefundsAnalyticsEntity.res	Unsupported file format
src/screens/NewAnalytics/Insights/PaymentAnalytics/InsightsPaymentAnalyticsEntity.res	Unsupported file format
src/screens/NewAnalytics/Insights/SmartRetryAnalytics/InsightsSmartRetryAnalyticsEntity.res	Unsupported file format
tailwind.config.js	0% smaller

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationOverview.res

src/screens/Analytics/FeeEstimation/FeeEstimationHelper.res

src/screens/Analytics/FeeEstimation/FeeEstimation.res

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationOverview.res

src/screens/Analytics/FeeEstimation/FeeEstimationUtils.res

gitanjli525 · 2025-10-30T13:10:06Z

In FeeEstimationHelper, import the LogicUtils file once at the top instead of using repeatedly.
Since BarGraphTypes is already imported at the top, you can remove the duplicate imports as well.

src/screens/Analytics/FeeEstimation/FeeEstimationHelper.res

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationOverview.res

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationTransactionView.res

src/screens/Analytics/FeeEstimation/FeeEstimationEntity.res

src/screens/Analytics/FeeEstimation/FeeEstimationHelper.res

gitanjli525 · 2025-11-03T12:39:10Z

@Anubhav-Ghosh1 can you please add a feature flag for this section ?

src/APIUtils/APIUtils.res

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationOverview.res

…ation module

…tion view

src/screens/Analytics/FeeEstimation/FeeEstimation.res

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationTransactionView.res

susrithasabbini · 2025-11-21T09:21:24Z

src/screens/Analytics/FeeEstimation/FeeEstimation.res

+          "payload": {
+            "offset": pageDetail.offset,
+            "limit": pageDetail.resultsPerPage,
+            "startDate": monthFilters["startDate"],
+            "endDate": monthFilters["endDate"],
+          },


Please construct an array and convert array to dict

susrithasabbini · 2025-11-21T09:21:35Z

src/screens/Analytics/FeeEstimation/FeeEstimation.res

+          "payload": {
+            "offset": pageDetail.offset,
+            "limit": pageDetail.resultsPerPage,
+            "startDate": monthFilters["startDate"],
+            "endDate": monthFilters["endDate"],
+          },


Same here, make a util function that does, and use it everywhere

susrithasabbini · 2025-11-21T09:22:25Z

src/screens/Analytics/FeeEstimation/FeeEstimation.res

+  let tabs: array<Tabs.tab> = [
+    {
+      title: "Overview",
+      renderContent: () => <OverviewContainer monthFilters />,
+    },
+    {
+      title: "Transactions View",
+      renderContent: () => <TransactionViewContainer monthFilters />,
+    },


Can this be memoized

Anubhav-Ghosh1 self-assigned this Oct 30, 2025

Anubhav-Ghosh1 requested a review from a team as a code owner October 30, 2025 11:10

susrithasabbini reviewed Oct 30, 2025

View reviewed changes

gitanjli525 reviewed Oct 30, 2025

View reviewed changes

src/screens/Analytics/FeeEstimation/FeeEstimationUtils.res Outdated Show resolved Hide resolved

gitanjli525 reviewed Oct 30, 2025

View reviewed changes

src/screens/Analytics/FeeEstimation/FeeEstimationHelper.res Outdated Show resolved Hide resolved

susrithasabbini reviewed Oct 31, 2025

View reviewed changes

Anubhav-Ghosh1 requested review from gitanjli525 and susrithasabbini October 31, 2025 13:26

gitanjli525 reviewed Nov 3, 2025

View reviewed changes

src/APIUtils/APIUtils.res Outdated Show resolved Hide resolved

gitanjli525 reviewed Nov 3, 2025

View reviewed changes

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationOverview.res Outdated Show resolved Hide resolved

juspay deleted a comment from nishchay-17 Nov 3, 2025

nishchay-17 and others added 13 commits November 6, 2025 19:17

feat: add month range selector

b940a20

chore: resolve comments

8acf733

feat: resolved comments and refactored code

e98f848

chore: added toast

d5d9556

fix: month range selector

79f912a

fix: resolved pr changes

a439906

fix: updated sidebar component

5644ccb

fix: updated data along with api payload

ebacea1

feat: added feature flag for fee estimation module

131ccd0

feat: added feature flag and updated month range module for fee estim…

415e369

…ation module

feat: added overview table component and added pagination for transac…

e192173

…tion view

fix: merge conflicts

44ed3b8

fix: merge conflicts

bf02248

Anubhav-Ghosh1 force-pushed the feat/fee-estimation-module branch from 393c1b1 to bf02248 Compare November 6, 2025 13:55

gitanjli525 reviewed Nov 6, 2025

View reviewed changes

src/screens/Analytics/FeeEstimation/FeeEstimation.res Outdated Show resolved Hide resolved

gitanjli525 reviewed Nov 6, 2025

View reviewed changes

src/screens/Analytics/FeeEstimation/FeeEstimation.res Outdated Show resolved Hide resolved

fix: merge conflicts

27b251b

gitanjli525 previously approved these changes Nov 7, 2025

View reviewed changes

susrithasabbini reviewed Nov 10, 2025

View reviewed changes

src/screens/Analytics/FeeEstimation/FeeEstimationComponents/FeeEstimationTransactionView.res Outdated Show resolved Hide resolved

fix: updated colors for fee estimation expanded table

22498a1

Anubhav-Ghosh1 dismissed gitanjli525’s stale review via 22498a1 November 10, 2025 08:01

susrithasabbini previously approved these changes Nov 10, 2025

View reviewed changes

fix: moved date range function to fee estimation utils

6ecd5e0

Anubhav-Ghosh1 dismissed susrithasabbini’s stale review via 6ecd5e0 November 10, 2025 08:33

susrithasabbini approved these changes Nov 10, 2025

View reviewed changes

Anubhav-Ghosh1 requested a review from gitanjli525 November 10, 2025 11:12

gitanjli525 approved these changes Nov 10, 2025

View reviewed changes

Anubhav-Ghosh1 linked an issue Nov 10, 2025 that may be closed by this pull request

[FEAT]: Fee Estimation Module (Analytics) #3837

Open

2 tasks

Anubhav-Ghosh1 requested a review from Riddhiagrawal001 November 11, 2025 11:18

susrithasabbini reviewed Nov 21, 2025

View reviewed changes

feat: fee estimation module #3781

Are you sure you want to change the base?

feat: fee estimation module #3781

Uh oh!

Conversation

Anubhav-Ghosh1 commented Oct 30, 2025

Type of Change

Description

1. Overview Module

2. Transaction View Module

Motivation and Context

How did you test it?

Where to test it?

Checklist

Uh oh!

semanticdiff-com bot commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gitanjli525 commented Oct 30, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gitanjli525 commented Nov 3, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

susrithasabbini Nov 21, 2025

Choose a reason for hiding this comment

Uh oh!

susrithasabbini Nov 21, 2025

Choose a reason for hiding this comment

Uh oh!

susrithasabbini Nov 21, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

semanticdiff-com bot commented Oct 30, 2025 •

edited

Loading