Partner API
An open API for banks, marketplaces, aggregators and agents. A partner calculates the premium, issues and cancels a policy in its own name and receives contract events through webhooks. Method descriptions in six languages are published in the documentation.
Methods
API documentationPartner/Quotes/Calculate- Premium calculation for the partner’s product and questionnaire
Partner/Products/List- Products available to the partner key
Partner/Policies/IssueOnBehalf- Policy issuance on behalf of the partner
Partner/Policies/Cancel- Policy cancellation with refund calculation
Partner/Agent/Policies- Policies issued by the agent
Partner/Agent/PortfolioStatistics- Agent portfolio statistics
Webhooks
The system notifies the partner of policy events. Every notification is signed with HMAC and is redelivered after a failure.
PolicyIssuedPolicyActivatedPolicyCancelledPolicyExpiredEndorsementApplied
Security
Two keys
A public key for the widget on the partner’s page and a secret key for calls from the partner’s server.
Key permissions
Each key sees only its own products and methods, and the request origin is checked.
HMAC signature
The partner verifies that the webhook came from the insurer and was not altered on the way.
Webhook address protection
The address is checked so that a webhook cannot be pointed at the insurer’s internal network.
Idempotency
A repeated request with the same Idempotency-Key does not issue a second policy.
Purchase widget
The widget is embedded on the partner’s page with a script and a public key. The questionnaire, calculation, key information document and payment come from the insurer’s builder, and messaging with the partner’s site checks the message origin.
Embedded insuranceFor the insurer’s internal systems
Rating plans, underwriting and anti-fraud are available to the insurer’s internal systems as gRPC services, and data is exported to the warehouse by cursor with an audit trail.
Shall we connect your partner?
Tell us which product you need to sell and in which channel. We will show the API on a test key.