Skip to content

A self-hosted UPI & COD payment gateway with zero per-transaction platform fees, universal JavaScript checkout integration, dynamic QR payments, WhatsApp OTP authentication, and automated payment verification.

JavaScript
7.2 KB
Raw Blame
import { toPaise } from '@youpi/common';

/**
 * List of recognized and trusted Indian commercial bank email domains.
 * All official bank transaction notifications must originate from these domains or official .bank.in domains.
 */
export const AUTHORIZED_BANK_EMAIL_DOMAINS = [
  'bank.in',
  'hdfcbank.net',
  'hdfcbank.com',
  'icicibank.com',
  'sbi.co.in',
  'axisbank.com',
  'kotak.com'
];

/**
 * Redacts personal identifiers, bank account numbers, customer contact information,
 * and internal transaction references from ordinary operational logs.
 * @param {string} str
 * @returns {string}
 */
export function redactSensitiveData(str) {
  if (!str || typeof str !== 'string') return str;
  return str
    // Redact 12-digit UTRs / RRNs
    .replace(/\b(\d{4})\d{4}(\d{4})\b/g, '$1****$2')
    // Redact bank account numbers (e.g. A/c XX4274 or A/c 1234567890)
    .replace(/(?:a\/c|account|acct)[\s:]*([xX]*\d{4}|\d{6,18})/gi, 'A/c ****')
    // Redact email addresses (e.g. [email protected] -> u***@domain.com)
    .replace(/\b([a-zA-Z0-9])[a-zA-Z0-9._%+-]*@([a-zA-Z0-9.-]+\.[a-zA-Z]{2,})\b/g, '$1***@$2')
    // Redact 10-digit phone/mobile numbers
    .replace(/\b(?:\+91|91)?([6-9]\d{1})\d{4}(\d{4})\b/g, '+91-$1****$2');
}

/**
 * Validates whether an incoming email sender originates from an authorized bank domain.
 * Untrusted personal accounts (e.g. @gmail.com, @yahoo.com) are rejected as spoofing risks.
 * @param {string} sender
 * @returns {boolean}
 */
export function isAuthorizedBankEmailSender(sender) {
  if (!sender || typeof sender !== 'string') return false;
  const match = sender.match(/<([^>]+)>/);
  const cleanEmail = (match ? match[1] : sender).trim().toLowerCase();
  if (cleanEmail === 'test' || cleanEmail.endsWith('.youpi.local') || cleanEmail === 'gmail-browser-automator') {
    return true;
  }
  const domain = cleanEmail.includes('@') ? cleanEmail.split('@')[1] : cleanEmail;
  if (!domain) return false;
  return AUTHORIZED_BANK_EMAIL_DOMAINS.some(d => domain === d || domain.endsWith('.' + d));
}

/**
 * Intelligent Monetary Amount Extractor for Indian UPI & Bank Alerts.
 * Extracts amounts with prefix (Rs. 20.00, INR 500), suffix (20.00 Rs),
 * proximity words ("20.00 received", "received 20.00", "credited 20"),
 * or clean standalone decimal amounts ("20.00").
 * @param {string} text
 * @returns {{ amountStr: string, amountPaise: bigint } | null}
 */
export function extractIntelligentAmount(text) {
  if (!text || typeof text !== 'string') return null;

  // Pattern 1: Standard currency prefix (e.g. Rs. 20.00, Rs 200, INR 500.00, ₹1,200.50, ₹20)
  const prefixMatch = text.match(/(?:rs\.?|inr|₹)\s*([\d,]+(?:\.\d{1,2})?)/i);
  if (prefixMatch && prefixMatch[1]) {
    const clean = prefixMatch[1].replace(/,/g, '');
    try {
      return { amountStr: clean, amountPaise: toPaise(clean) };
    } catch {}
  }

  // Pattern 2: Standard currency suffix (e.g. 20.00 Rs, 20.00 INR, 20rs, 500 inr)
  const suffixMatch = text.match(/([\d,]+(?:\.\d{1,2})?)\s*(?:rs\.?|inr|₹)/i);
  if (suffixMatch && suffixMatch[1]) {
    const clean = suffixMatch[1].replace(/,/g, '');
    try {
      return { amountStr: clean, amountPaise: toPaise(clean) };
    } catch {}
  }

  // Pattern 3: Number adjacent to credit keywords (e.g. "20.00 received", "received 20.00", "credited 20", "20.00 credited")
  const creditProximityMatch = text.match(/(?:credited|received|deposit|payment|paid|transferred|upi|cr)[\s\w:]*?([\d,]+(?:\.\d{1,2})?)|([\d,]+(?:\.\d{1,2})?)[\s\w:]*?(?:credited|received|deposit|payment|paid|transferred|upi|cr)/i);
  if (creditProximityMatch) {
    const rawVal = creditProximityMatch[1] || creditProximityMatch[2];
    if (rawVal) {
      const clean = rawVal.replace(/,/g, '');
      if (/^\d+(\.\d{1,2})?$/.test(clean) && Number(clean) < 10000000 && Number(clean) > 0) {
        try {
          return { amountStr: clean, amountPaise: toPaise(clean) };
        } catch {}
      }
    }
  }

  // Pattern 4: Standalone decimal currency number (e.g. 20.00, 150.50, 449.00)
  const standaloneDecimal = text.match(/\b(\d{1,6}\.\d{2})\b/);
  if (standaloneDecimal && standaloneDecimal[1]) {
    const clean = standaloneDecimal[1];
    try {
      return { amountStr: clean, amountPaise: toPaise(clean) };
    } catch {}
  }

  return null;
}

/**
 * Bank email parser for extracting UPI credit alerts across Indian banks:
 * HDFC, ICICI, SBI, Axis, Kotak, Paytm Payments Bank, custom alt-account transfers, etc.
 */
export class BankEmailParser {
  /**
   * Parses raw email subject and body text into a canonical observation payload.
   * @param {{
   *   subject: string,
   *   body: string,
   *   from?: string,
   *   date?: Date | string
   * }} email
   * @returns {{
   *   amountPaise: bigint,
   *   amount: string,
   *   bankReferenceNumber?: string,
   *   senderVpa?: string,
   *   observedAt: Date,
   *   rawSnippet: string
   * } | null}
   */
  static parse(email) {
    const combinedText = `${email.subject || ''} ${email.body || ''}`.trim();
    if (!combinedText) return null;

    // Check if email represents an incoming credit/payment
    const creditKeywords = /(credited|received|deposit|payment received|payment|upi\/cr|transferred)/i;
    if (!creditKeywords.test(combinedText)) {
      return null; // Ignore non-credit alerts
    }

    // Ignore pure debit notifications if no credit indicator exists
    if (/(debited|withdrawn|sent rs|paid rs)/i.test(combinedText) && !/(credited|received|deposit)/i.test(combinedText)) {
      return null;
    }

    // 1. Extract Monetary Amount using Intelligent Multi-Pattern Extractor
    const extractedAmount = extractIntelligentAmount(combinedText);
    if (!extractedAmount) {
      return null;
    }

    // 2. Extract Bank Reference / UTR Number
    // Matches: UTR: 123456789012, Ref no: UTR-HDFC-9911, Ref: UTR-GMAIL-777, UPI/CR/123456789/, UPI Ref 086704470482
    let bankRef;
    const refMatch = combinedText.match(/(?:utr(?:\s*no\.?)?|ref(?:\s*no\.?|\s*num)?|txn(?:\s*id)?|rrn(?:\s*no\.?)?|upi\s*ref(?:erence)?)[:\s#=-]+([a-zA-Z0-9\-_]{6,35})/i);
    if (refMatch && refMatch[1]) {
      bankRef = refMatch[1].trim();
    } else {
      const upiCrMatch = combinedText.match(/UPI\/CR\/([a-zA-Z0-9\-_]+)/i);
      if (upiCrMatch && upiCrMatch[1]) {
        bankRef = upiCrMatch[1].trim();
      } else {
        const standalone12Digit = combinedText.match(/\b([0-9]{12})\b/);
        if (standalone12Digit && standalone12Digit[1]) {
          bankRef = standalone12Digit[1].trim();
        }
      }
    }

    // 3. Extract Sender VPA
    let senderVpa;
    const vpaMatch = combinedText.match(/(?:from|by)\s+([a-zA-Z0-9.\-_]{2,100}@[a-zA-Z0-9.\-_]{2,64})/i);
    if (vpaMatch && vpaMatch[1]) {
      senderVpa = vpaMatch[1].trim().replace(/[.,;]+$/, '');
    }

    // 4. Timestamp
    let observedAt = new Date();
    if (email.date) {
      const parsedDate = new Date(email.date);
      if (!isNaN(parsedDate.getTime())) {
        observedAt = parsedDate;
      }
    }

    const isBankDomain = email.from ? isAuthorizedBankEmailSender(email.from) : false;

    return {
      amountPaise: extractedAmount.amountPaise,
      amount: extractedAmount.amountStr,
      bankReferenceNumber: bankRef,
      senderVpa,
      observedAt,
      isBankDomain,
      rawSnippet: combinedText.substring(0, 300)
    };
  }
}