Travel Insurance Policy

---

After an insurance offer was selected by the customer, this method provides a way to finalise the insurance and create the insurance policy.

URL

/recommendation/travel/policy

Methods

POST

Data Params

Field	Type	Description	Required
secretKey	string	Secret key of the sales project. Read more about this argument.	Yes
quoteId	string	External quote id which is going to be associated with the created policy.	No
from	string	ISO 3166-1 alpha-2 code of origin country.	Yes
to	string	ISO 3166-1 alpha-2 code of destination country.	Yes
activityId	string	Activity to be covered by the insurance. Read more about this argument.	Yes
travellerGroup	string	Activity to be covered by the insurance. Read more about this argument.	Yes
transportation	string	Activity to be covered by the insurance. Read more about this argument.	Yes
adults	integer	Number of adults travelling.	Yes
children	integer	Number of children travelling.	Yes
start	string	ISO timestamp of the start date.	Yes
end	string	ISO timestamp of the end date.	Yes
bundleId	string	ID of the travel bundle (predefined for sales partner or find this in the travel quote response.	Yes
productId	string	ID of the travel product (predefined for sales partner or find this in the travel quote response.	Yes
addons	Addons	Selected addons for the quote.	Yes
policyHolder	Policyholder	Information of the policyholder.	Yes, except for Group Policies.
travellers	array of Traveller	Information of the insured travellers.	Yes
agreements	array of strings	Links of the accepted agreements.	Yes

Addons

Field	Type	Description	Required
car	CarAddon or null	Details of the car insurance addon.	Yes
storno	StornoAddon or null	Details of the storno insurance addon.	Yes
sport	SportAddon or null	Details of the sport insurance addon.	Yes

CarAddon

Field	Type	Description	Required
id	string	ID of the selected car insurance addon.	Yes
age	integeer	The age of the car.	Yes
license	string	License plate of the car.	Yes

TODO: 6-quote-configuration-addons-storno

StornoAddon

Field	Type	Description	Required
id	string	ID of the selected storno insurance addon.	Yes
value	integer	The price of the booked travel services (e.g. accomodation, air ticket), excluding parts that are refundable from the service provider (e.g. airport taxes)	Yes
provider	string	The travel agency, airline or other company where the service (e.g. accomodation, air ticket) was booked and bought.	Yes
date	date	Date of the reservation of services (e.g. accomodation, air ticket). If the trip starts within 15 days, cancellation insurance can only be purchased on the day of reservation.	Yes

SportAddon

Field	Type	Description	Required
id	string	ID of the selected sport insurance addon.	Yes

PolicyHolder

Field	Type	Description	Required
firstName	string	First name of the policyholder.	Yes
lastName	Date	Last name of the policyholder.	Yes
birthdate	string	Birthdate of the policyholder.	Yes
nationality	string	Nationality of the policyholder.	Yes
email	string	Email of the policyholder.	Yes
country	string	Country of the policyholder.	Yes
city	string	City of the policyholder.	Yes
address	string	Address of the policyholder.	Yes
zip	string	ZIP code of the policyholder.	Yes
phone	string	Phone number of the policyholder.	Yes

Traveller

Field	Type	Description	Required
firstName	string	First name of the traveller.	Yes
lastName	Date	Last name of the traveller.	Yes
birthdate	string	Birthdate of the traveller.	Yes
nationality	string	Nationality of the traveller.	Yes
email	string	Email of the traveller.	Yes

Success Response

Code: 200

Content

Field	Type	Description
paymentUrl	string	Payment link to redirect the user.

See more about payment at the Travel Policy Payment.

Sample Call

contract_data.json

{
    "secretKey": "<YOUR_SECRET_KEY>",
    "from": "HU",
    "to": "FR",
    "activityId": "5c17b8e232903c0cb48762c9",
    "adults": 1,
    "children": 0,
    "start": "1546622557145",
    "end": "1546822667145",
    "bundleId": "5c17b9bf32903c0cb48762ce",
    "productId": "5bd56f5f4e82779a07a99fc6",
    "addons": {
        "car": null,
        "storno": null,
        "sport": null
    },
    "policyHolder": {
        "firstName": "Joe",
        "lastName": "Apple",
        "birthdate": "1995-01-01",
        "nationality": "Hungarian",
        "email": "joe.apple@gmail.com",
        "country": "Hungary",
        "city": "Budapest",
        "address": "Dob utca 2",
        "zip": "1071",
        "phone": "+36301233445"
    },
    "travellers": [
        {
            "firstName": "First",
            "lastName": "Last",
            "birthdate": "1995-09-13",
            "nationality": "Magyar",
            "email": "e@e.com"
        }
    ],
    "agreements": ["5c17e17452cbd10e760796fc","5c17e26952cbd10e760796fd","5c17e38152cbd10e760796ff"]
}

Response

{
  "paymentUrl": "http://link.com"
}