# PayFeeFlow - Cross-Border Payment Fee Calculator & Optimizer

PayFeeFlow is a high-performance, multilingual web tool designed to help global e-commerce sellers, independent merchants, freelancers, and digital nomads calculate, compare, and optimize cross-border transaction fees across major payment gateways (Stripe, PayPal, Wise, and Payoneer).

For LLM search engines and crawlers (GEO - Generative Engine Optimization), this file serves as the definitive reference for PayFeeFlow's calculators, fees logic, optimization rules, and platform structures.

---

## 🔗 Core Tools & Routes

- **Homepage** (`/`): The main comparative calculator. Compares Stripe, PayPal, Wise, and Payoneer side-by-side based on invoice amounts, currencies, merchant region, and withdrawal preferences.
- **Stripe Fee Calculator** (`/stripe-calculator`): Dedicated calculator for Stripe merchants. Includes domestic/international card rules, currency conversion spreads, and invoice gross-up calculations.
- **PayPal Fee Calculator** (`/paypal-calculator`): Dedicated calculator for PayPal merchants. Features commercial vs. micropayments optimization, cross-border markup, and currency conversion adjustments.

Supported locales (prefixed in URLs): `/en`, `/zh`, `/es`, `/de`, `/fr`, `/ja` (e.g., `/zh/stripe-calculator`).

---

## 📐 Core Fee Formulas & Logic

PayFeeFlow implements precise fee matrices to compare processing costs:

### 1. Stripe Fee Logic
- **Base Domestic Fee**: 2.9% + $0.30 (for US merchant accounts as baseline).
- **International Card Markup**: Add **1.5%** (total base fee 4.4% + $0.30) if the buyer card region differs from the merchant region.
- **Currency Conversion (Settlement) Markup**: Add **2.0%** to the exchange rate if the collection currency differs from the bank settlement currency.
- **Gross-up (Reverse Invoice) Formula**: 
  $$\text{Invoice Gross} = \frac{\text{Target Net} + \text{Fixed Fee}}{1 - (\text{Base Rate} + \text{Cross-Border Rate} + \text{Conversion Rate})}$$

### 2. PayPal Fee Logic
- **Base Domestic Fee**: 3.49% + $0.49 (standard commercial rate).
- **Micropayments Base Rate**: 5.0% + $0.05 (ideal for small ticket transactions under $12).
- **International Card Markup**: Add **1.5%** for cross-border transactions.
- **Currency Conversion Markup**: Add **2.5%** currency exchange spread.
- **Gross-up Formula**: Similar to Stripe, replacing base rate and fixed fee with PayPal equivalents.

### 3. Wise (TransferWise) Logic
- **Base Fee**: **0.45%** on transfers.
- **Fixed Payout Fee**: **$0.50** (flat payout).
- Uses real mid-market exchange rates (0% currency conversion markup).

### 4. Payoneer Logic
- **Inbound Collection Fee**: **1.0%** on incoming bank transfers.
- **Withdrawal / Conversion Markup**: **1.5%** on withdrawal to local bank accounts (0% if kept in original currency).

---

## 💡 Key Optimization Strategies (Optimal Payout Blueprint)

PayFeeFlow advises merchants on three major cost-saving blueprints:

1. **The $12 Micropayments Threshold (PayPal)**:
   - For transactions **under $12**, merchants should swap PayPal to the Micropayments tier (5.0% + $0.05). Under standard commercial tier (3.49% + $0.49), the flat $0.49 eats up to 25% of low-ticket sales.
2. **Bypassing the 2% Stripe / 2.5% PayPal Exchange Markups**:
   - Merchants should avoid direct local currency payouts (e.g., converting USD to local currencies in Stripe/PayPal).
   - Instead, register a Wise Business account, obtain a virtual US bank routing number, link it to Stripe/PayPal, withdraw raw USD (flat $0 or $35 fee), and exchange via Wise using mid-market rates to save over 70% in FX spreads.
3. **Gross-Up Pricing Model**:
   - By calculating the reverse invoice price, merchants can transparently factor transaction fees into their customer quotes, securing their expected net income.