Skip to main content

Quickstart

Get SmartPay running and make your first API call in 5 minutes.

Prerequisites​

  • Docker and Docker Compose
  • cURL or API client

1. Start Services​

git clone https://github.com/EmmanuelKeifala/olive.git
cd smartpay
docker compose up -d --build gateway wallet-core agent

2. Verify Health​

curl http://localhost:8080/health

3. Your First API Call​

Check Balance​

curl -X GET "http://localhost:8080/api/v1/balance/user123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create Payment​

curl -X POST "http://localhost:8080/api/v1/payments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "user_id": "user123",
    "recipient": "user456",
    "amount": 5000,
    "currency": "SLE"
  }'

Next Steps​

Register Subscribers

User registration guide

API Reference

Complete API documentation