Skip to main content

HeyPeppy Enterprise API

Welcome to the HeyPeppy Enterprise Developer Documentation.

HeyPeppy provides an AI-powered receipt processing and reimbursement compliance auditing platform engineered for Education Savings Account (ESA) administrators, scholarship funding organizations (SFOs), and state educational choice programs.

Why License HeyPeppy?​

  1. Multi-Tenant Architecture: Isolate data, queue quotas, webhooks, and billing per B2B tenant while configuring program-specific guidelines (FL_PEP, FL_UA, AZ_ESA, or custom policy catalogs).
  2. Eliminate Denial Cycles: By automatically detecting missing proof of payment, unpaid invoices, missing instructor credentials, or inadequate educational justifications before claims reach human reviewers, claim denial rates drop dramatically.
  3. Deep Guideline Compliance: Evaluates line items and justification notes against official state department of education guidelines, purchasing handbooks, and category catalogs.
  4. Enterprise Asynchronous Queue: Handles massive burst volume during end-of-semester reimbursement deadline rushes using a serverless pipeline without dropped requests or 429 rate-limit failures.
  5. FERPA & Privacy Compliant: Zero student PII persistence. Receipts are processed ephemerally with strict tenant-level data segregation.

Core Products​

1. Vision AI Receipt Processor​

  • Extracts vendor names, transaction dates, tax, discounts, and itemized line items from complex multi-page PDF statements, invoices, and smartphone photos.
  • Proof-of-Payment Validator: Differentiates between paid receipts (card last 4, zero balance, payment confirmations) and unpaid billing statements ("Amount Due", "Invoice").
  • Student Candidate Mapping: Automatically associates the document with registered students in the parent/family account.

2. Submission Auditor Engine​

  • Scans full reimbursement submissions against 5 dimensions:
    1. Document Completeness & Legibility: Validates core receipt fields (date, vendor, total, and itemization).
    2. Proof-of-Payment Validity: Verifies payment method, card last 4 digits, or paid stamps.
    3. Purchase Limitations & Frequency Caps: Checks program frequency rules (e.g., 1 computer every 3 school years, category dollar caps).
    4. Mandatory Supporting Documentation Scanner: Flags missing credentials, syllabi for large curriculum purchases, or pre-authorizations.
    5. Educational Justification Strength Scoring: Evaluates parent educational justifications with actionable coaching.

Next Steps​