Version: v1.0

Cancelling an Order

In some use-cases customers migh order an eSIM without realising that either 1) their device doesn't have eSIM support, or 2) the device is locked to a carrier and therefore it will not be possible to install an eSIM profile from Truphone. In this scenarios it should be possible to revert the order without any cost for our partners and enable a refund to the end customer.

Connect supports the above use-case using the delete SIM API. This endpoint will cancel the eSIM profile and its respective subscriptions provided two conditions:

  • The eSIM profile is not installed in any device when the cancellation is triggered
  • There was no data usage on the given eSIM profile

If those two conditions are met the resources are freed.

Example Request#

curl -X DELETE \
https://services.truphone.com/connect-api/v1/sim/8944478600000205337 \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Cache-Control: no-cache' \
-H 'Content-Type: application/json' \
-H 'X-Correlation-ID: unique-id-from-requester-123'

Example Response#

204 No Content