Card transaction fees
Learn about the fee structure associated with processing card payments on our platform. This guide provides a transparent overview of the different types of fees that may apply to various card transactions.
Bringing Transparency and Automation to Card Payment Fees
As of Oct 2025, MatchMove has upgraded its Card Authorization Platform to introduce a robust, transparent, and automated approach to transaction fee management. This update resolves previous limitations regarding visibility and manual processing, ensuring that partners have a clear breakdown of costs and earnings.
This guide outlines the changes to the fee model, the new automation capabilities, and the technical implementation details for developers.
Why the Change?
Previously, the platform utilized a net transaction fee computation. While functional, this "black box" approach created operational inefficiencies:
- No Breakdown: Fees were lumped together, making it impossible to distinguish between network costs, platform fees, and partner markups.
- Manual Management: Any change in network fees (e.g., by Mastercard) required manual recalculation for every single card type and program.
- Limited Visibility: Partners could not automatically extract or verify their specific markup portions.
The New Standard
The revamped model introduces granular fee attribution. Moving forward, every transaction—whether a cross-border payment or an ATM withdrawal—will feature a transparent breakdown during authorization and settlement.
The New Fee Structure
The new system moves away from a single "Net Fee" to a component-based formula.
Total Fee = Platform Fee + Partner Fee + Tax
What is the Platform Fee?
The Platform Fee is the baseline fee component charged by MatchMove to cover the essential underlying costs of processing card transactions on the network.
It covers key operational costs, including network scheme fees (such as Mastercard fees), BIN sponsorship fees, transaction authorization infrastructure, and platform processing charges.
The Platform Fee forms the core processing cost of a transaction (such as cross-border payments, ATM cash withdrawals, or currency exchanges) before any custom partner markup is added.
What is the Partner Fee markup?
The Partner Fee markup is an additional, custom fee component configured and earned by you (the Partner) on card transactions to generate margin and earnings.
While the Platform Fee covers underlying infrastructure and processing costs (such as Mastercard network fees and BIN sponsorship), the Partner Fee represents your custom commercial markup. It is added to the transaction fee structure to generate revenue for your program.
The Partner Fee markup is added on top of the base transaction costs and forms part of the overall fee charged during transaction processing (such as cross-border payments, ATM cash withdrawals, or currency exchanges).
Definitions
- Tax: Applicable taxes on the computed total fee.
- Fee Types: Both platform and partner fees can consist of Fixed (flat rate) and Variable (percentage) components.
Important Note: There is no change to the total fees collected. Partners will earn the same amount as before; the only change is that the breakdown of these fees is now visible and structured.
Key Features & Benefits
1. Automated Fee Hierarchies
The platform now supports fee hierarchies (Region, Network, Partner, Card Type). This eliminates manual updates.
- Scenario: If Mastercard increases transaction fees by 0.2% for the Singapore region.
- Action: The system automatically applies this change across all Singapore programs instantly.
- New Programs: When a new card program is launched, it automatically inherits the relevant platform fee components based on its region and network.
2. Rule-Based Configuration
Fees can now be defined dynamically based on transaction attributes, including:
- Transaction Currency
- Channel (e.g., ATM, POS, E-com)
- Issuing Country
- Merchant Location
3. Enhanced Reporting
Partner earnings and fee components are automatically extracted and pushed to Adminnet 2.0 reports, APIs, and webhooks.
Fee Configuration: Platform and Partner Fees
Both the Platform Fee and the Partner Fee Markup are established at the program configuration level. Here is a breakdown of how each fee is set up, managed, and modified.
1. Platform Fee Configuration
The Platform Fee covers the baseline costs of processing card transactions (e.g., network scheme fees, BIN sponsorship, platform infrastructure).
- Set by MatchMove: This fee is strictly defined and configured by MatchMove in the backend system.
- Automated Inheritance: It is automatically applied to your program based on the agreed commercial terms, region, network (e.g., Mastercard), and card type. Partners do not need to manually configure this fee.
2. Partner Fee Configuration
The Partner Fee is your custom commercial markup. It is entirely optional and provides a way to generate revenue from card transactions.
- Partner-Defined: You decide the amount (whether a fixed rate, a percentage, or both) you want to charge as a markup on top of the base transaction costs.
- Card Type Specific: When setting this markup, you must specify the exact card type code(s) (
card_type_code) to which the partner fee should be applied. - Default Value: If you choose not to add a markup, the Partner Fee is automatically defaulted to 0.
Setting Up and Modifying the Partner Fee
Because the Partner Fee directly impacts the final transaction amount charged to your end-users, it cannot be configured or modified directly in the dashboard or via the API. All additions, modifications, or removals of a Partner Fee require a formal Change Request Ticket submitted to the MatchMove Support Team.
During Implementation (Pre-Launch)
Before your program goes live, the MatchMove Implementation team will work with you to finalize your program configurations. As part of this process, the team will explicitly ask if you require a Partner Fee markup to be configured before you formally exit the User Acceptance Testing (UAT) phase. Once you confirm your desired fee structure and the applicable card type codes (card_type_code), a Change Request Ticket must be raised to implement it.
Post-Launch (Making Changes)
If you decide to add, remove, or modify your Partner Fee after your program is live, the process remains exactly the same. You must:
- Raise a formal Change Request Ticket.
- Submit the ticket to the MatchMove Support Team, clearly specifying the new fixed and/or variable fee structure, along with the specific card type code(s) where the fee should be charged.
- The Support Team will configure the updated markup on your behalf.
Technical Implementation
Rounding Logic
To ensure accuracy, fee components are rounded individually to ISO-defined currency decimals before they are summed.
Example Calculation:
- Scenario: A cross-border transaction of SGD 10.10.
- Rates: Platform Fee (1.75%), Partner Fee (1.00%).
- ISO Decimal: SGD uses 2 decimal places.
Platform Fee = 1.75% x 10.10 = 0.17675 —> SGD 0.18
Partner Fee = 1.00 x 10.10 = 0.105 —> SGD 0.11
Total Fee = 0.18 + 0.11 = SGD 0.29
Note: Minor rounding differences may occur between the "Total Fee" and the sum of unrounded components.
Webhook Updates (For Developers)
A new object additional_fee_details, has been added to Authorization, Decline, and Reversal webhooks.
Details for the following transaction fees will appear in the additional fee details when the fee code applies to the transaction:
ATM Balance Inquiry Fee | A fee charged when performing a balance check on the card through an Automated Teller Machine (ATM), and fees may vary depending on the bank ATM used. |
|---|---|
ATM Cash Withdrawal Fee | A fee charged when performing a cash withdrawal through an Automated Teller Machine (ATM), and fees may vary depending on the bank ATM used. |
Cross Border Fee | A fee charged when a payment is made to the merchant who is located/registered in another country using the same currency in which the card was issued. |
Cross Currency Fee | A fee charged when a payment is made to the merchant who is located/registered in the same country where the card is issued, using another currency different from which the card was issued. |
Cross Border Cross Currency Fee | A surcharge applied when you make a transaction that triggers two specific conditions simultaneously: the merchant is located in a different country (cross-border) and the payment requires a foreign exchange conversion (cross-currency). This will be charged using the same currency in which the card was issued. |
Issuer Forex Fee | A fee charged when a payment is made to the merchant who is located/registered in another country using the other country's currency different from which the card was issued. |
Issuer Surcharge | When the issuer charges a surcharge fee for the particular kind of purchase transaction, it is marked as an issuer surcharge |
Card Authorization webhook payload preview:
"additional_fee_details": [
{
"cross_border_fee": {
"platform_fee": {
"fixed_fee": "0.01",
"variable_fee": "0.02",
"sub_total": "0.03"
},
"partner_fee": {
"fixed_fee": "0.03",
"variable_fee": "0.04",
"sub_total": "0.07"
}
}
}
]
Additional Fee Details explained:
Using the detail in the sample webhook payload above, we have the following transaction fee code: cross_border_fee
| Platform-levied fixed component fee, in the base currency set in the program |
| Platform-levied variable component fee, in the base currency set in the program |
| Platform-levied fee total, from fixed and variable component, in the base currency set in the program |
| Partner-charged fixed component markup fee, in the base currency set in the program |
| Partner-charged variable component markup fee, in the base currency set in the program |
| Platform-charged markup fee total, from fixed and variable component, in the base currency set in the program |
Applying the formula: Total Fee = Platform Fee + Partner Fee + Tax
The total cross-border fee will be calculated as:
cross_border_fee (1.0) = platform_fee.sub_total(0.3) + partner_fee.sub_total (0.7)
If the base currency of the program is set to USD, then cross-border card transactions will be charged
1.0 USD for transaction fees.Scope and Exclusions:
- Scope: The card payment fee structure discussed above is only applicable to Mastercard transactions.
- Exclusions: For the Philippine region, BancNet transactions remain unaffected (no additional platform/partner fees are permitted beyond scheme fees).
Related Links
On this page
- Card transaction fees