Sign in

v1

latestOpenAPI 3.0.12026-08-066103.9 MB

Cancel a policy according to its id.

Cf. summary

post/sales/v2/individual/travel/policies/{policy_id}/cancel

Path parameters

policy_idstring required
Example:ea45ec62-0d21-4f44-a577-b8624da2bf5b

Unique policy identifier.

Headers

accept-languagestring
Example:en

Accepted language, IANA language codification. If language not managed, "en" will be used by default.

Request body

cancellation_datestring date required

Date when policy cancellation should be effective - ISO 8601 format (YYYY-MM-DD).

cancellation_reason'COOLING_OFF_PERIOD' | 'CREDIT_CARD_REJECTED' | 'DECEASED_BENEFICIARY' | 'DECEASED_POLICY_HOLDER' | 'DISPUTED' | 'DUPLICATE_PURCHASE' | 'END_OF_CONTRACT' | 'EXTRAORDINARY_TERMINATION_AFTER_CLAIM' | 'MOVING_RESIDENCE_ABROAD' | 'NON_PAYMENT' | 'NO_REASON' | 'OTHER_REASON' | 'POLICY_SUBSTITUTION' | 'SPECIFIC_BENEFITS' | 'TRIP_CANCELLATION' | 'VISA_DECLINED'

Reason for policy cancellation:

  • COOLING_OFF_PERIOD: When the service hasn't started yet and the client wants to cancel its service (when he may have found a better offer elsewhere for instance). Source of cancellation: NA
  • CREDIT_CARD_REJECTED: The policy has been cancelled because of the credit card got rejected.
  • DECEASED_BENEFICIARY: The beneficiary has passed away.
  • DECEASED_POLICY_HOLDER: The policy holder has passed away.
  • DISPUTED: When the requested service is not the same as the one that must be delivered after the provider's investigation. Source of cancellation: NA
  • DUPLICATE_PURCHASE: The policy has been cancelled because it is a duplicate of another policy.
  • END_OF_CONTRACT: The policy has cancelled because the contract has ended.
  • EXTRAORDINARY_TERMINATION_AFTER_CLAIM: Extraordinary termination after a claim has been submitted.
  • MOVING_RESIDENCE_ABROAD: The policy holder is moving residence abroad.
  • NON_PAYMENT: The policy has been cancelled because of non payment.
  • NO_REASON: No specified reason. Source of cancellation: Customer
  • OTHER_REASON: The policy has been cancelled for other reason.
  • POLICY_SUBSTITUTION: Policy substitution applies to a policy that is being cancelled because it will be replaced for a new one, upgrading the coverages of the previous one.
  • SPECIFIC_BENEFITS: Exceptional cancellation cases that must be defined with the partner Source of cancellation: NA
  • TRIP_CANCELLATION: Trip has been cancelled.
  • VISA_DECLINED: The VISA (need to enter some countries) has been declined by the country.

Example request

{
  "cancellation_date": "2018-08-20"
}

Response

Policy successfully cancelled.

coverage_end_datestring date required

End date of policy coverage - ISO 8601 format (YYYY-MM-DD).

Example response

{
  "refund_amount": {
    "value": 199.99,
    "currency": "EUR"
  },
  "coverage_end_date": "2018-08-20"
}