Alternative Integrations

We support selling assurance entitlements and travel insurance policies using standard integrated payments, or by invoicing your clients. This will require you to on-board your clients (we call these "Limited Partners") to the Vertical Insure platform and issue product-specific certificates for the client based on the product you are wanting to sell. The supporting sequence diagram describes the flow for this process.

On-boarding Limited Partners

Assurance entitlements must be quoted on behalf of a limited partner which you will on-board. For example, if you are a booking platform, the limited partner you on-board might be the resort that is using your platform. For each limited partner, you will need to call our partner on-boarding API. You will need to store the ID of the limited partner that is created for later use.

Travel Insurance & Travel Retailer On-boarding

Another alternative integration feature is the capability to sell travel insurance products without a payments integration (i.e. invoicing). As part of the partner on-boarding API, you can provide the flag travel_retailer: true and the limited partner will recieve an email to complete a travel retailer agreement. Once this agreement has been signed, you will be able to purchase travel insurance using the invoice payment process mentioned above.

Creating Partner Certificates

Assurance entitlements can be quoted given the partner requesting the quote has a valid certificate issued to them for the product that is being quoted.

Once you have on-boarded your limited partner, you can create a certificate for them using the create partner certificate API.

Once the partner is on-boarded and a certificate has been created, you are able to quote and sell assurance entitlements. We currently support selling these entitlements through the following product APIs:

• booking protection API
• registration cancellation API
• ticket refund API

Payments

When purchasing an assurance entitlement using a standard payment integration with one of our supported processors, the purchase flow is exactly the same as any other product. If you do not have a payment integration with Vertical Insure, you will collect the money owed for the entitlement (or policy as it pertains to travel insurance) and then Vertical Insure will send you an invoice at the end of the period. For making a purchase call with invoicing, you should pass a 'payment method token' with a value following the format invoice:$ID, where $ID is an identifier representing the transaction or payment in your system.

curl -L -X POST 'https://api.verticalinsure.com/v1/purchase/season-interruption' \
-H 'Content-Type: application/json' \
--data-raw '{
  "quote_id": "string",
  "payment_method": {
    "token": "invoice:123456789"
  }
}'