Digital Wallet Management

The Digital Wallet Management system is the core of the Credit Card Co-Pilot experience. It allows you to create a digital twin of your physical wallet, enabling the recommendation engine to provide precise, card-specific advice for every transaction.

By centralizing your credit card portfolio, the system tracks reward rates, network-specific benefits, and progress toward lucrative spending milestones.

Your Portfolio at a Glance

The Digital Wallet provides a high-level overview of your available credit across all issuers and networks (Visa, Mastercard, RuPay, and Amex).

• Centralized Tracking: View all active cards in one place, regardless of the issuing bank.
• Active Status Control: Easily toggle cards as "Active" or "Inactive." This ensures the recommendation engine only suggests cards you currently have on hand, without losing the historical spend data of older cards.
• Security-First Metadata: Store essential identifiers like the last 4 digits and network type to distinguish between similar card products without storing sensitive full card numbers.

Adding and Customizing Cards

Card Co-Pilot uses an extensive global database of credit card products, making it easy to add your cards by simply searching for the issuer and product name (e.g., "HDFC Regalia Gold" or "ICICI Amazon Pay").

Personalized Display Names

Since many users carry multiple cards from the same bank, you can set custom Display Names. This allows you to differentiate cards based on their use case (e.g., "Personal Shopping" vs. "Business Travel").

Reward Overrides

While the system comes pre-loaded with standard reward rates, we recognize that banks often provide targeted offers to specific customers. The Custom Rewards feature allows you to manually override reward rules.

• Use Case: If you have a lifetime waiver or a special 5% cashback rate on a specific merchant that isn't part of the standard card terms, you can input these rules to ensure your recommendations remain 100% accurate.

Milestone & Goal Tracking

A key value proposition of the Digital Wallet is its integration with Milestone Definitions. Many high-end cards offer significant bonuses (points, vouchers, or cashback) once a spend threshold is reached.

The wallet automatically tracks:

• Spend Thresholds: Total spend within a specific period (Monthly, Quarterly, or Annual).
• Proximity Alerts: Visual indicators showing how close you are to achieving a bonus.
• Milestone Forecasts: Intelligent "nudges" that suggest using a specific card more frequently if you are within range of a reward milestone.

Smart Recommendations

The Digital Wallet isn't just a static list; it's the primary input for the Recommendation Engine. For every merchant search or transaction, the system evaluates your entire wallet to find the "Best Rank" card.

// Example of how a card in your wallet is evaluated
{
  "cardName": "Amazon Pay ICICI",
  "rank": 1,
  "explanation": "5% cashback on online shopping. Best rate in your wallet.",
  "reward": {
    "effectiveRate": 0.05,
    "rewardType": "cashback",
    "milestoneProgressPct": 75,
    "milestoneDescription": "Spend ₹5,000 more for a ₹500 voucher"
  }
}

Use Cases

• Optimizing Network Benefits: Use the wallet to identify which cards are RuPay-enabled for UPI transactions versus those that are better suited for Visa/Mastercard POS terminals.
• Fee Management: Track annual fees and card activity to decide which cards are providing enough value to keep active.
• Strategic Spending: When nearing a quarterly milestone on a specific card, the wallet informs the recommendation engine to prioritize that card, even if its base reward rate is lower than others.

Data Integrity & Parser Review

To ensure your wallet's spend history is accurate, the Parser Review tool allows you to monitor how transactions are being ingested from SMS or Email. If a transaction is attributed to the wrong card or merchant, you can manually correct it to keep your milestone tracking and reward balances perfectly synced.