GuidesReference Endpoints
Guides

Policy Cancel

The Policy Cancel endpoint is used when you need to cancel a customer's refund policy without a refund given by Teak. A policy can be canceled at any time.

The consumer’s policy is no longer active when using the Cancel API. The following occurs when a Policy is “canceled.”

Customer Experience

  1. The consumer is NOT refunded their protection cost
  2. The consumer can no longer void their Policy
  3. The consumer can no longer submit a refund request

Ticketing Platform Experience

  1. The Ticketing Platform will still be invoiced Teak’s Program fee.
  2. The Ticketing Platform retains its revenue share of the protection cost.
  3. No notifications will be triggered to refund the consumer.

Use Cases when the Cancel API should be used.

  1. Consumer Experience
    1. If the policy is outside the look period and the ticketing platform decides to fully refund the consumer the ticket cost, including the protection cost.
  2. Ticket Transfers
    1. If the consumer transfers their ticket to another consumer, the policy should be canceled as Refund Protection is non-transferable.
    2. This is a use case when the policy look period could still be valid.
  3. Ticket Resell
    1. If the consumer resells their ticket via the ticketing platform’s resell capability, the policy should be canceled as Refund Protection is non-transferable.
    2. This is a use case when the policy look period could still be valid.
📘

Authenticating This Request

To properly make this API call, the request needs to be authorized by generating a JWT Token sourced from the Authentication API Call using the relevant Client's Public and Secret Key.


Try it out!

If you'd like to see a working example of our Policy Cancel API call, follow this link to our API Reference Guide ! Feel free to swap out the values and see what a proper request and response call looks like.

Example Request:

curl -X PUT \
  https://api.sandbox.protecht.com/api/v2/policies/:policy_id/cancel \
  -H 'Authorization: JWT xxx.yyy.zzz'

Example Response:

{
	"status": "Canceled",
	"void_date": "2024-03-05T21:30:26.757759Z"
}