About using the API for integration with insurance companies
This integration API is designed for insurance companies and insurance service aggregators. The goal is to allow users to purchase an insurance policy on the partner's site through a dedicated section in the search results.
Partners that have implemented the methods described in this document provide a quote for the insurance object in question. They then compete with other partners in the integration to offer their services. When a user selects an offer, the integration service sends a confirmation to the partner's API. The user can then proceed to the partner's site to fill in the policy details and make a payment.
Once payment is made, the insurance company or aggregator must send the user a link to a resource with the policy information.
External API
Integration with Yandex is implemented via REST API. If you have no other integrations, you need to implement these methods:
- Estimate the cost using a VIN or license plate number.
- Calculate the policy cost based on the full form.
- Issue policy.
- Get policy by ID.
- Get policy status by ID.
- Get links to policy draft.
- Get payment link.
- Get brand catalog.
- Get model catalog.
- Get catalog of manufacture years by model_id.
- Get catalog of vehicle engine powers.
- Update dictionaries.
The main goal is to obtain and provide the information required to issue a policy through an external integration.
Appendix
List of statuses
|
Status |
Description |
|
|
Draft |
|
|
Declined |
|
|
Pending |
|
|
Validation |
|
|
Calculation |
|
|
Awaiting payment |
|
|
Paid |
|
|
Issued |