Version: v1.0

Order Lifecycle

SIM’s and connectivity plans are purchased by creating orders. Order fulfilment is asynchronous due to the nature of SIM and network provisioning. Below there is the complete of statuses for an order and also an example request/reponse of an order creation and an order status requests.

StatusDescription
ACCEPTEDwaiting to be processed
FULFILLINGbeing processed at the moment
COMPLETEDprocessed with success
FAILEDfailed to be processed

Example Request#

curl -X GET \
https://services.truphone.com/connect-api/v1/order/3a6acf89-1ccf-4611-9424-453930f57ef1 \
-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#

{
"output": {
"matchingId": "5C-M1OIY-QHWKD1",
"iccid": "8944478600000205337",
"smdpUrl": "rsp.truphone.com",
"lpa_url": "LPA:1$%rsp.truphone.com$%5C-M1OIY-QHWKD1",
"qrcode_url": "https://services.truphone.com/connect/qrcode/v1/esim/LPA:1$rsp.truphone.com$5C-M1OIY-QHWKD1",
"subscription_id": "a-5gVXH2sjvICL7U5roet1hMC35UYSCCi4Mbiszdceo="
},
"status": "COMPLETED",
"externalId": "b27ec0e7-ad36-45ab-8e2f-c291441a2355",
"id": "b27ec0e7-ad36-45ab-8e2f-c291441a2355"
}