Skip to main content
OLIVE Platform

​
Welcome to OLIVE

OLIVE 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

Agent-TS

Conversational AIOpenAI-powered agent for WhatsApp integrations and natural language wallet operations

Gateway

REST API GatewayFull REST API with authentication, rate limiting, and comprehensive logging

Wallet-Core

Financial EngineSecure ledger with atomic transactions and compliance monitoring

​
Architecture

​
Key Features

Secure Payments

Atomic database transactions with full audit trails

Idempotent API

Request ID-based idempotency for safe retries

AI Assistant

Natural language wallet operations via WhatsApp

KYC Compliance

Multi-level KYC with OCR document verification

Fraud Detection

Real-time monitoring and suspicious activity alerts

Multi-Auth

API keys, JWT, HMAC, and service authentication

​
Quick Start

1

Start Services

docker compose up -d --build gateway wallet-core agent
2

Verify Health

curl http://localhost:8080/health  # Gateway
curl http://localhost:8000/health  # Agent
3

Get API Key

Create an API key through the admin dashboard or CLI
4

Make First Request

curl -H "Authorization: Bearer olive_live_xxx" \
  http://localhost:8080/api/v1/health

Full Quickstart Guide

Complete setup instructions with configuration and deployment options

​
API Base URLs

EnvironmentGatewayAgent
Developmenthttp://localhost:8080http://localhost:8000
Demohttps://demo.api.vultlocal.comhttps://agent.olive.example.com

​
Explore

API Reference

Complete endpoint documentation with examples and response schemas

Integration Guides

Step-by-step tutorials for common integration patterns

Architecture

Deep dive into system design and data flows

Authentication

Learn about API keys, JWT, and HMAC authentication

​
Support

GitHub

Source code and issue tracking

Slack

Join our developer community

Email

support@olive.example.com