-
-
steps during transaction
-
payflow ai
-
calculation on overdraft amount required
-
initiating payflow
-
-
-
PayFlow Overdraft
Inspiration
In emerging markets and gig-economy sectors, freelancers and micro-merchants frequently face short-term liquidity gaps. When their available PayPal balance is insufficient, essential transactions can fail, affecting inventory purchases, software subscriptions, and other business expenses.
Inspired by Kenya's Fuliza M-Pesa overdraft service offered by Safaricom, PayFlow Overdraft introduces an opt-in, checkout-based credit facility for PayPal users. It bridges temporary cash-flow gaps by connecting users who need short-term credit with a dedicated funding account, helping them complete eligible payments without unnecessary disruption.
🚀 What It Does
PayFlow Overdraft is a PayPal-integrated microcredit application that connects a dedicated creditor account with users who need temporary financial assistance.
- Dedicated Creditor Account: A designated PayPal Business sandbox account serves as the funding source for approved overdrafts.
- Insufficient Funds & Overdraft Request: When a user encounters a payment shortfall, the application offers an option to complete the payment with PayFlow. The user can review the proposed overdraft amount, applicable fee, and repayment terms before accepting or declining.
- On-Demand Fund Transfer: Once the user accepts and the request is approved, PayFlow initiates a transfer of the approved amount from the funder's account to the user's PayPal account, subject to supported PayPal transfer capabilities.
- Payment Completion: After the funds become available, the user proceeds with the original PayPal checkout and completes the purchase through the normal payment flow.
- Microcredit Risk Assessment: PayFlow evaluates available transaction history and configured eligibility rules to determine an appropriate overdraft limit.
- Repayment Tracking: The application records outstanding principal, applicable fees, repayments, and available credit. Future deposits can trigger repayment reminders or repayment processing where the relevant authorization and supported payment mechanisms permit.
- AG Grid Financial Dashboard: Users have access to an interactive AG Grid-powered dashboard where they can monitor their overdraft balances, outstanding loans, repayment progress, payment history, and other financial transactions. This provides a centralized view of their borrowing activity and financial position.
- AI Financial Assistant: An integrated assistant helps users understand their overdraft limits, outstanding obligations, transaction history, and repayment plans.
How We Built It
- Backend: Python and Flask, organized into modules for checkout, overdraft requests, credit assessment, transfers, and repayment tracking.
- Frontend: A web-based user interface featuring an AG Grid dashboard for interactive financial transaction management, overdraft monitoring, and repayment tracking.
- Deployment: The application is deployed on Render, making the PayFlow Overdraft platform accessible through a hosted web application.
- Database: SQLAlchemy models for users, funding accounts, overdraft requests, disbursements, transactions, and repayment records.
- PayPal Integration:
- Orders API v2: Creates and manages the original checkout payment.
- PayPal Payouts API: Provides a potential mechanism for transferring approved funds from the creditor account to the user's PayPal account, subject to sandbox configuration and API eligibility.
- Webhooks: Tracks supported payment and transfer events to maintain transaction status and prevent duplicate processing.
- Credit Management: An application-level credit ledger tracks the funder's available lending capacity, approved overdrafts, outstanding balances, and repayments.
- AI Assistant: Helps users understand their financial position and make informed decisions about short-term borrowing.
Challenges We Ran Into
- Transaction Consistency: Preventing duplicate transfers, duplicate overdraft approvals, and inconsistent balances when asynchronous events occur.
- Responsible Lending: Designing transparent fees, clear repayment terms, and sensible credit limits.
- Financial Data Visualization: Presenting overdraft balances, repayments, and transaction records in a clear, interactive dashboard while maintaining consistency with the underlying credit ledger.
- Payment Integration: Working within PayPal sandbox capabilities and handling the complexities of funding transfers and checkout workflows.
Accomplishments
- A working sandbox demonstration of the complete flow: insufficient funds → user consent → overdraft approval → creditor-funded transfer → successful PayPal checkout.
- A transparent credit ledger that tracks the funder's disbursements and users' outstanding obligations.
- An interactive AG Grid dashboard that gives users visibility into their overdraft balances, repayments, and financial transactions.
- A deployed application on Render, making the platform accessible for demonstration and testing.
- An opt-in borrowing experience that gives users control over whether they take an overdraft.
- An AI financial assistant that explains credit limits, fees, and repayment obligations.
What's Next for PayFlow Overdraft
- Smarter Credit Assessment: Improve eligibility decisions using verified transaction history and responsible lending rules.
- Financial Wellness: Introduce cash-flow forecasting, repayment reminders, and spending insights.
- Multi-Currency Support: Explore overdrafts for cross-border freelancers and merchants.
- Funding Partnerships: Extend the creditor model to multiple funding partners and eligible merchant ecosystems.
