You can share order events with us via the Hakuna API so we can create and manage the insurance contracts appropriately.
Publish order placement events
Whenever an order is placed in your system, publish an order placement event by calling our and passing us order, customer, and product information (including a for any protection products in the order):
As a response, you'll receive the generated event ID.
Publish line item fulfillment events
Whenever you ship any of the products in an order, publish the line item fulfillment events for the fulfilled products by calling our and passing us the order ID and a list of the fulfilled line items.
Hakuna does not require you to fulfill protection plan line items, but it may make sense to have your ERP system automatically fulfill them when the associated product is fulfilled.
As a response, you'll receive the generated event ID.
Publish line item refund events
Whenever you refund any products in an order, publish the line item refund events by calling our events endpoint and passing us the order ID and a list of the refunded line items. Keep in mind that whenever a protected product is refunded, you must also refund the associated protection product.
As a response, you'll receive the generated event ID.
Publish line item cancellation events
Whenever you cancel any products in an order, you will need to publish the line item cancellation events by calling our events endpoint and passing us the order ID and a list of the cancelled line items. Keep in mind that whenever a protected product is cancelled, you must also cancel the associated protection product.
As a response, you'll receive the generated event ID.
Publish order cancellation events
Whenever an entire order is cancelled for any reason, publish an order cancellation event by calling our events endpoint and passing us the order ID and the date and time the order was cancelled at.
