Status Callback (POST)

A transaction callback payload follows the schema displayed here. In additional_info, you must request mcc, mnc, price, and currency be included or they will be omitted in the response from TeleSign.

Property

Type

Description

status

object or string

status.code

This code describes the status of your transaction. You can use this code to programmatically respond. You are returned two types of codes, either status codes or error codes.

status.description

string

A text description of the status code.

status.updated_on

string

This is a timestamp showing when your transaction status was updated last.

reference_id

string

The reference ID for the transaction you want to find out the status for.

external_id

string

You can mark each of your requests with your own identifier. This identifier is returned as part of a delivery receipt (DLR) callback.

additional_info

object

additional_info.mcc

string

Mobile Country Code (MCC) of the destination number. Returned if you request this feature from our Customer Support Team.

additional_info.mnc

string

Mobile Network Code (MNC) of the destination number. Returned if you request this feature from our Customer Support Team.

additional_info.price

string

The price of the message you are sending.

additional_info.currency

string

The currency with which the price is provided.

additional_info.message_parts_count

string

You can only get this in a response if you use Verify Transaction Callback to retrieve message status information. This parameter will display the number of parts your message was split into. If the message is not split, this returns a value of 1.


Did this page help you?