Intelligent Merchant Search

Overview

The Intelligent Merchant Search is the core proactive tool within Credit Card Co-Pilot. It allows you to simulate a transaction before it happens, ensuring you always select the card that yields the highest return. By analyzing your specific wallet against merchant categories and payment channels, the system removes the guesswork from maximizing rewards.

Key Features

The search tool is designed to handle the complexity of modern payment ecosystems:

• Multi-Channel Awareness: Recommendations adjust based on whether you are paying via UPI, Online, or Offline (POS).
• Amount-Optimized Logic: Calculations account for transaction-specific variables like reward caps and minimum spend requirements.
• Milestone Integration: The engine doesn't just look at base reward rates; it prioritizes cards where the spend will help you reach lucrative milestone bonuses (e.g., "Spend ₹20,000 more this quarter for a ₹1,000 voucher").
• Explainable Recommendations: Every suggestion comes with a clear "why," detailing the logic (e.g., "5% accelerated cashback for online shopping") and a confidence score.

How to Use Merchant Search

Access the search tool directly from the Home Screen quick actions to find the best card for your next purchase.

1. Identify the Merchant

Start typing the name of the merchant (e.g., "Amazon", "Starbucks", "Zomato"). The system uses a normalized merchant database to identify the correct category and reward rules associated with that business.

2. Specify the Payment Channel

Reward rates often vary wildly depending on how you pay. You can toggle between:

• Online: Standard web or app transactions.
• Offline / POS: Physical swipes or tap-to-pay at a terminal.
• UPI: Payments made via linked RuPay credit cards on UPI.

3. Enter the Transaction Amount

By providing the expected spend, the engine can:

• Check if you are approaching a monthly or quarterly reward cap.
• Calculate the exact INR value of the points or miles you will earn.
• Determine if this specific amount will trigger a Milestone Achievement.

Understanding the Recommendation

Once the parameters are set, the system provides a ranked list of your cards.

Reward Breakdown

For each card, you will see a detailed breakdown:

• Effective Rate: The final percentage value of the reward.
• Reward Type: Whether you'll earn cashback, points, or miles.
• Cash Value: The real-money equivalent of the rewards for that specific transaction.

Explainability and Confidence

To ensure you can trust the recommendation, the system provides:

• Logic Source: Indicates if the rule came from a merchant-specific matrix, a category match (e.g., "Dining"), or a custom user override.
• Confidence Band: A "High," "Medium," or "Low" rating based on how well the merchant's data matches known reward categories.

// Example of the data structure driving your recommendations
interface CardRecommendation {
  cardName: string;
  rank: number; // 1 = Best choice
  reward: {
    effectiveRate: number; // e.g., 0.05 for 5%
    cashValue: number;     // INR value of the reward
    milestoneDescription: string | null; // e.g., "70% towards your quarterly goal"
  };
  explanation: string; // "Best rate: 5% cashback on online shopping."
}

Intended Use Cases

High-Value Purchases

Before making a large purchase (like electronics or flights), use the search to check if the transaction amount exceeds your card's monthly accelerated reward cap. If it does, the Co-Pilot might suggest a secondary card that still offers a high base rate.

Milestone "Push"

If you have multiple cards with similar reward rates, the search tool will prioritize the card where the spend is most "valuable" for an upcoming milestone, helping you secure large bonuses that you might otherwise miss.

UPI vs. Physical Card

When at a store that accepts both UPI and physical cards, a quick search can reveal if your RuPay card on UPI offers better rewards than swiping a different card in your wallet.