SMPP & REST API Developer Hub

Request Body

# Incoming DLR webhook POST payload
{
  "message_id":    "msg_01HX4Y9Z3K2W8V6N5P7Q",
  "batch_id":      "batch_01HX9A2B3C4D5E6F7G8H",
  "to":            "+447911123456",
  "from":          "SBSTEL",
  "status":        "DELIVRD",
  "err_code":      0,
  "err_desc":      "Message delivered",
  "submitted_at":  "2026-03-26T10:00:00Z",
  "delivered_at":  "2026-03-26T10:00:01Z",
  "network":       "EE UK",
  "mcc":           "234",
  "mnc":           "30"
}

TLV Example — DLR Parsing

# Python: Parse TLV fields from deliver_sm DLR
def parse_dlr_tlvs(pdu):
    msg_id   = pdu.get_tlv(0x001E)  # receipted_message_id
    state    = pdu.get_tlv(0x0427)  # message_state (1=delivered, 5=undeliverable)
    err_code = pdu.get_tlv(0x0423)  # network_error_code

    if state == 2:
        mark_delivered(msg_id)
    elif state == 5:
        net_type = err_code[0]
        net_err  = int.from_bytes(err_code[1:3], 'big')
        mark_failed(msg_id, net_type, net_err)

# submit_sm field summary for OTP with full DLR
submit_sm:
  source_addr:          "SBSBANK"
  dest_addr:            "+447911123456"
  short_message:        "Your OTP is 482910. Valid for 5 minutes."
  data_coding:          0          # GSM7
  registered_delivery:  0x11       # All DLRs
  validity_period:      "000000000005000R"  # 5 minute expiry
  TLVs:
    user_message_reference: "TXN-98765-OTP"   # your internal ref

<?php
/**
 * SBS TELECOM — Send SMS with DLR webhook (PHP)
 */
function sbstelSendSMS(string $apiKey, array $params): array {
    $ch = curl_init('https://api.sbstelecom.co.uk/v1/messages');
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST           => true,
        CURLOPT_POSTFIELDS     => json_encode($params),
        CURLOPT_HTTPHEADER     => [
            "Authorization: Bearer {$apiKey}",
            'Content-Type: application/json',
        ],
        CURLOPT_TIMEOUT        => 10,
    ]);
    $body     = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($httpCode !== 200) {
        throw new \RuntimeException("SMS API error {$httpCode}: {$body}");
    }
    return json_decode($body, true);
}

// Usage
$result = sbstelSendSMS('YOUR_API_KEY', [
    'to'           => '+447911123456',
    'from'         => 'SBSTEL',
    'text'         => 'Your verification code is 482910',
    'route'        => 'otp',
    'callback_url' => 'https://yourapp.com/dlr',
]);
echo "Sent: {$result['message_id']}";

// DLR webhook handler
$dlr = json_decode(file_get_contents('php://input'), true);
$sig = $_SERVER['HTTP_X_SBS_SIGNATURE'] ?? '';
$expected = hash_hmac('sha256', file_get_contents('php://input'), 'YOUR_WEBHOOK_SECRET');

if (!hash_equals($expected, $sig)) {
    http_response_code(403); exit;
}

if ($dlr['status'] === 'DELIVRD') {
    markDelivered($dlr['message_id']);
}
http_response_code(200);