To receive delivery receipts to your platform, simply provide us with a URL you wish to receive them to. We will POST the following parameters to you:
| Parameters | Type | Information |
| JSON | String | A string JSON array. For more details, please see the information below. |
Here is an example of the JSON parameter:
[ 1, "447123456789", "640ab2bae07bedc4c163f679a746f7ab7fb5d1fa", "Delivered" ]
You can use the json_decode() function in PHP to convert this string into a PHP variable.
The delivery receipt format is currently JSON. You will receive an JSON array in which the first element is either integer 0 (fail) or integer 1 (success). The second element is a string MSISDN and the third element is the string submission reference you received when the message was sent. The fourth element is a string reason.
You may receive one or more delivery receipts for each MSISDN and submission reference combination but generally speaking, you will have received all of these delivery receipts within 72 hours of the message being sent.
Reasons
| Buffered | The message is currently in a retry process. |
| Not Delivered | The message could not be delivered. |
| Delivered | The message has been delivered successfully. |
| Stopped | This message was stopped before it was dispatched for delivery. This will only be returned on a route which has a in-built HLR lookup and confirms that a number is inactive and no longer in use. You will not be charged for the message - only the HLR lookup. |
| Unknown | This is rare and will only be returned on a route which has a in-built HLR lookup and it couldn't determine whether a number is dead or alive. The message will still be sent (based on your settings) because this is not considered a permanent error and you will still be charged for the HLR lookup. |
Sample code
<?php
if (isset($_POST['JSON']))
{
$JSON = $_POST['JSON'];
if (get_magic_quotes_gpc())
{
$JSON = stripslashes($JSON);
}
$JSON = json_decode($JSON);
if ( ! empty($JSON) && is_array($JSON) && count($JSON) == 4)
{
list($result, $to, $submission_reference, $reason) = $JSON;
}
}
?>
You now have the following PHP variables available: $result, $to, $submission_reference and $reason.
Speak to a real person
(01323) 800 160
One direct number for all enquiries - sales and support.
Monday - Friday, 10am to 6pm.
Clear SMS pricing
SMS text messages from just 2.99p. Lower prices available for an agreeable monthly quota.
