Интеграция SMS сервиса Payom.tj по API

Используйте простой REST API для отправки SMS через Payom.tj. Ниже представлены примеры для популярных языков программирования.

                    
curl --location 'https://HOST/api/message' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_TOKEN' \
--data '{
  "telephone": "+992999999999",
  "text": "Привет, это сообщение из Payom.tj",
  "senderName": "payom.tj",
  "type": "SMS"
}'
                    
                

                    
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://HOST/api/message',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 10,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
  "telephone": "+992999999999",
  "text": "Привет, это сообщение из Payom.tj",
  "senderName": "payom.tj",
  "type": "SMS"
}',
  CURLOPT_HTTPHEADER => array(
    'Accept: application/json',
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_TOKEN'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
                    
                

                    
const axios = require('axios');
let data = JSON.stringify({
  "telephone": "+992999999999",
  "text": "Привет, это сообщение из Payom.tj",
  "senderName": "payom.tj",
  "type": "SMS"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://HOST/api/message',
  headers: {
    'Accept': 'application/json',
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

                    
                

                    
import http.client
import json

conn = http.client.HTTPSConnection("HOST")
payload = json.dumps({
  "telephone": "+992999999999",
  "text": "Привет, это сообщение из Payom.tj",
  "senderName": "payom.tj",
  "type": "SMS"
})
headers = {
  'Accept': 'application/json',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer YOUR_TOKEN'
}
conn.request("POST", "/api/message", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
                    
                

                    
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io"
)

func main() {

  url := "https://HOST/api/message"
  method := "POST"

  payload := strings.NewReader(`{
  "telephone": "+992999999999",
  "text": "Привет, это сообщение из Payom.tj",
  "senderName": "payom.tj",
  "type": "SMS"
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Accept", "application/json")
  req.Header.Add("Content-Type", "application/json")
  req.Header.Add("Authorization", "Bearer YOUR_TOKEN")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := io.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
                    
                

Параметры метода

Базовый URL: /api/message

Хост API и JWT токен вы получаете после регистрации в сервисе.

Параметры запроса

• telephone — номер получателя в формате +992XXXXXXXXX
• text — текст сообщения (можно оставить пустым, если используется templateMessage)
• senderName — имя отправителя (латинские буквы и цифры, до 11 символов)
• templateMessage — объект для отправки сообщения по шаблону:
  • templateId — UUID шаблона, который хотите использовать
  • variables — массив переменных, которые будут подставлены в шаблон. Формат: ключ = имя переменной, значение = значение

Пример передачи свободного текста сообщения:

{
  "telephone": "+992999999999",
  "senderName": "MySender",
  "text": "Текст сообщения"
}

Пример передачи шаблонного сообщения:

{
  "telephone": "+992999999999",
  "senderName": "MySender",
  "templateMessage": {
    "templateId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "variables": {
      "code": 1234
    }
  }
}

Ответ возвращается в формате JSON с HTTP статусом 201 и идентификатором отправленного сообщения.

            
{
    "id": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "telephone": "+992999999999",
    "text": "Привет, это сообщение из Payom.tj",
    "createAt": "2025-11-08T18:52:07+03:00",
    "sentAt": null,
    "updatedAt": null,
    "transaction": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
    "type": "SMS",
    "deliveryStatus": "SERVICE_ACCEPTED",
    "deliveryStatusLabel": "Принято сервисом",
    "source": "API",
    "sourceMeta": {
        "ip": "11.11.11.11"
    },
    "configuration": {
        "senderName": "payom.tj",
        "operator": "TCELL",
        "quantityByLength": 1
    }
}
            
        

Возможные статусы сообщений

Система Payom.tj возвращает один из следующих статусов доставки SMS: