Bancassurance & Partner Portal — 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 /partners/auth/sso
Initiate SSO (OAuth/OIDC) for embedded journeys
GET /partners/{id}/catalog
Pull partner-scoped products/offers
POST /leads
Create or sync a new lead with consent flags
POST /applications
Submit application payload (parties, risks, docs)
POST /rating/quote
Request premium from Rating service
POST /policies/issue
Issue via PAS; returns policyNo + documents
POST /payments/initiate
Create payment order (auto-debit/card/VA)
POST /payments/notify
Bank/PG callback for settlement status
POST /callbacks/status
Asynchronous status to partner portal

Sample Embedded-SSO (OIDC) Flow

GET /partners/auth/sso?client_id=BANK-APP&redirect_uri=https://bank.app/callback&scope=openid profile email&state=xyz

Reference Flows

Embedded Journey (Bank App)
  • User taps Insurance in bank app → SSO to partner-scoped portal
  • Portal loads catalog & prefilled profile with consent
  • Quote generated → application submitted → PAS issues policy
Payment & Reconciliation
  • Portal calls /payments/initiate → bank/PG processes
  • /payments/notify updates portal & PAS in real time
  • Daily reconciliation file (CSV/JSON) to DW/ERP
Lead Sync & Follow-up
  • Partner posts leads (with consent) to /leads
  • Journey emails/SMS/WA triggered by events
  • Status callbacks keep partner CRM up-to-date
Reporting to Partner
  • Expose performance dashboards via API or portal
  • Download policies/claims activity over time windows
  • Export to partner BI with row-level security

Security & Controls

Monitoring & Audit

What You Get

© Rayterton Apps — Bancassurance & Partner Portal Host-to-Host