Agency & Commission Management — Host-to-Host Integration

Insurance • Real-time, system-to-system connectivity (no SLA section)

Purpose of Host-to-Host

Core Data Objects

Example API Endpoints

POST /agents
Onboard agent with KYC/licensing and bank account
PATCH /agents/{id}
Update status, hierarchy, or channel permissions
POST /hierarchies
Bulk update upline/downline structures
POST /sales/import
Push policy sales/cancellations from PAS
POST /commissions/calc
Trigger calculation for single sale or batch
GET /statements/{period}
Retrieve commission statements by agent/branch
POST /payouts/initiate
Create payout batch and send to bank/payroll
POST /payouts/notify
Bank callback with success/failure for each item
POST /chargebacks
Apply chargeback/clawback with reasons & links
POST /callbacks/status
Asynchronous updates to partner portals

Reference Flows

Agent Onboarding
  • Partner posts agent data + KYC → validation & approval
  • Agent ID returned; access provisioned by role
  • Welcome & credential emails triggered
Sale Capture & Calculation
  • PAS pushes sale/cancel event → engine maps schema
  • Commission calculated (splits/overrides/tiers)
  • Entry appears in agent statement real time
Monthly Close & Statement
  • Lock period, finalize adj/chargebacks
  • Generate statements (PDF/CSV) per agent/branch
  • Expose via API & portal downloads
Payout & Bank H2H
  • Create payout batch → /payouts/initiate
  • Bank processes; posts /payouts/notify for each line
  • Receipts & tax slips archived
Chargeback/Clawback
  • PAS sends lapse/cancel → engine computes clawback
  • Offset against future earnings or collect
  • Agent notified; disputes handled via evidence links

Security & Controls

Monitoring & Audit

What You Get

© Rayterton Apps — Agency & Commission Management Host-to-Host