SMS Delivery Receipt

From CDYNE Wiki
Jump to navigation Jump to search

SMS Delivery Receipt

Delivery Receipts (DR) indicate message status throughout the delivery process. You may receive one to multiple DRs per outgoing message. DRs are sent through the network with low priority. You may receive them out of order. Not all carriers support handset DRs. You may or may not receive a DR indicating delivery to cell phone. However, you should receive a DR indicating delivery to the carrier.

Fields

ID

Carrier level ID of the message. Used internally to match to SMS MessageID.

Sub-ID

Carrier level Sub-ID of the message.

Dlvrd

Value '1' indicates the message has been delivered, '0' indicates still pending.

Submit Date

Submission data and time.

Done Date

Date and time the status has changed, or message delivery time when Stat is set to 'DELIVRD'.

Stat

Current status of the message.

Err

Additional error code, provider specific. See the next section "Common Delivery Receipt Error Codes" below for more details on this field of the delivery receipt.

Common Delivery Receipt Error Codes

The 3-digit code is passed through the Err section of the Delivery Receipt. CDYNE will parse this code out and also pass it through the Code parameter of the Delivery Receipt Postback. This list contains the most common delivery receipts. Because error codes can differ from carrier to carrier, you may receive error codes not listed here.

000 - DELIVRD

  • Message was delivered to cell phone.

003 - DELIVERED TO CARRIER

  • Message was delivered to carrier.

004 - ACCEPTD

  • Message was accepted by carrier.

005 - DELETED/UNDELIV

  • This can be received when end user's cell phone number is blocked at carrier level.
  • Message delivery was attempted, but message could not be delivered and was deleted from carrier.
  • Handset might be out of network coverage when message delivery was attempted.
  • Handset migh be switched off.
  • Handset might be roaming out of carrier's supported network.

008 - EXPIRED

  • Message expired at carrier.

023 - REJECTED

  • Message rejected by carrier.

024 - UNDELIV

Attempt to deliver message failed.

  • Handset might be out of network coverage when message delivery was attempted.
  • Handset might be switched off.
  • Handset might be roaming out of carrier's supported network.

091 - INVALID ROUTING

  • Carrier has not approved/provisioned short code.
  • Contact CDYNE about our automatic backup through a DID.

090 - BAD ADDRESS

  • Destination number is not a valid number.
  • Destination carrier rejected the message.

093 - CARRIER GATEWAY ERROR

  • Carrier not responding. Message will automatically be reattempted.

999 - UNKNOWN

  • Unknown status returned from carrier.