CSQ Docs
    CSQ Docs
    Dummy Product Usage Guide
    • CSQ API Doc
    • Dummy Product Usage Guide
    • Overview on Dummy Products
    • Top-Up Simulation
    • Voucher Purchase Simulation
    • Supermarket Vouchers Purchase Simulation
    • Bill Payment Simulation
    • Location-based products simulation
    • Insurance Contracting Simulation

    Insurance Contracting Simulation

    Insurance Contracting Simulation#

    🛡️ Simulating Insurance Contracting with Dummy Products#

    This guide explains how to simulate an insurance contracting flow using the Dummy Insurance provider through the public Insurance API.
    The dummy implementation allows developers to test:
    Dynamic step-based contracting flows
    Form rendering driven by backend responses
    Quote calculation
    Payment execution
    Success and error scenarios
    No real insurance provider is contacted and no real transaction is executed.

    📦 Dummy Insurance Overview#

    The Dummy Insurance simulates a dynamic, backend-driven flow identical in behavior to real insurance integrations.
    Main characteristics:
    Dynamic steps (start → step → quote)
    Backend-controlled required and optional fields
    Explicit transition to payment using payment = true
    Deterministic payment result based on insuranceId

    🔁 Simulation Flow#

    1.
    Start insurance contracting flow
    2.
    Submit dynamic contract data
    3.
    Receive quote (last step)
    4.
    Execute payment
    5.
    Retrieve ticket

    🔹 Step 1: Start Contracting Flow#

    Method
    GET /insurances/start/{terminalId}/{operatorId}

    Description#

    Initializes the dummy insurance flow. The backend returns:
    Available phases
    Dynamic form definition
    Required and optional input fields
    Next step endpoint

    🔸 Step 2: Submit Contract Data#

    Method
    POST /insurances/step/{terminalId}/{operatorId}/1

    💰 Quote Amount Simulation#

    planIdamountToSendX100Amount
    11000001000.00
    22000002000.00
    33000003000.00

    💳 Step 3: Execute Payment#

    Method
    POST /insurances/payment/{terminalId}/{operatorId}

    🎟️ Step 4: Get Ticket#

    Method
    GET /insurances/ticket/{terminalId}/{operatorId}/{reference}

    ✅ Summary#

    Dummy Insurance allows full end‑to‑end insurance flow testing in a deterministic way.
    Modified at 2025-12-10 14:24:50
    Previous
    Location-based products simulation
    Built with