Change coverage values

Optional. Only available to:

  • UK-based Partner Company (retailers)
  • UK-based Merchants
  • UK registered operations of global Merchants

Context

This guide is designed to help:

  • a) A Partner Company (third party provider)

select the retail values of the orders their Policyholders would like to insure.

  • b) A Partner Company (retailer)

select the retail values of the orders they would like to insure.

This is an optional feature, the standard value Anansi range is £0 to £25,000 and is applied by default.

Step 1 - Setting the insurance coverage values

A) For a Partner Company (third party provider)

Changing the Policyholders retail values of the orders they would like to insure is an option that should be chosen by the Policyholder. You can offer this feature by implementing a user interface such as a slider or input boxes. Once the Policyholder has either selected their initial retail value range or updated the values, Anansi will insure parcels within this new range immediately.

Note that this feature must be implemented in a way that provides a digital footprint, in order for Anansi to receive and store this data.

B) For a Partner Company (retailer)

Partner Company (retailer) can change the retail values of the orders to be insured by using the API endpoints below. Anansi will insure parcels within this new range immediately.

Step 2 - Validate your customer journey

A) For a Partner Company (third party provider)

After Partner Company (third party provider) decide how to implement step 1 and how to show the necessary information to the Policyholder, please reach out to your Anansi contact to schedule a first audit with the Compliance team.

B) For a Partner Company (retailer)

This step does not apply. Please go to Step 3.

Step 3 - Send the new values via the API

HTTP Example:

POST /api/partner/policyholders/<id>/actions/change_insurance_values HTTP/1.1
Host: <Insert host>
authentication: <Insert authentication token>
Content-Type: application/json

{
"min_insurance_value": 0,
"max_insurance_value": 25000,
}

Full POST /policyholders/<id>/actions/change_insurance_values documentation (opens in this window)

After a successful response, the Policyholder will receive an email with their new Policy Schedule including the new retail values of the orders they would like to insure from Anansi. Setting both min_insurance_val and max_insurance_val to 0 will make sure no future shipments are insured.

Next steps