SmartPay Payment Platform
SmartPay is a three-tier payment platform combining a secure transaction engine, a public API gateway, and conversational agents that provide natural-language experiences via WhatsApp.
Platform Components
Conversational AI
OpenAI-powered agent for WhatsApp integrations and natural language wallet operations
REST API Gateway
Full REST API with authentication, rate limiting, and comprehensive logging
Financial Engine
Secure ledger with atomic transactions and compliance monitoring
Architecture
Key Features
Atomic database transactions with full audit trails
Request ID-based idempotency for safe retries
Natural language wallet operations via WhatsApp
Multi-level KYC with OCR document verification
Real-time monitoring and suspicious activity alerts
API keys, JWT, HMAC, and service authentication
Quick Start
docker compose up -d --build gateway wallet-core agent
curl http://localhost:8080/health # Gateway
curl http://localhost:8000/health # Agent
Create an API key through the admin dashboard or CLI
curl -H "Authorization: Bearer olive_live_xxx" \
http://localhost:8080/api/v1/health
Complete setup instructions with configuration and deployment options
API Base URLs
| Environment | Gateway | Agent |
|---|---|---|
| Development | http://localhost:8080 | http://localhost:8000 |
| Demo | https://demo.api.vultlocal.com | https://agent.smartpay.example.com |
Explore
Complete endpoint documentation with examples and response schemas
Step-by-step tutorials for common integration patterns
Deep dive into system design and data flows
Learn about API keys, JWT, and HMAC authentication
Support
Source code and issue tracking
Join our developer community