Skip to main content

Agent Network

Agents are local businesses authorized to handle cash transactions for OLIVE users.

Agent Types


Agent Status


Commission Tiers

Tier must be 1, 2, or 3.

Settlement Modes


Agent Fields


Validation Rules

Super Agent:
  • Cannot have parent_agent_id
  • Business name required
  • Contact person required
  • Phone required
  • Commission tier 1-3
Sub Agent:
  • Must have parent_agent_id
  • Same field requirements as super agent

Float Operations


Agent PIN

Every agent has a 4-digit PIN:
  • Hashed: SHA256(pin) (no salt)
  • Required for transaction authorization
  • Validated before any float operation

Agent Integration

Complete guide

Agent API

API endpoints

Fees

Commission rates