Описание
Описывает транзакцию с Telegram Stars. Обратите внимание, что если покупатель инициирует возврат средств у платёжного провайдера, у которого он приобрёл Stars (например, Apple, Google) после этой транзакции, возвращённые Stars будут вычтены из баланса бота. Это находится вне контроля Telegram.
| Поле | Тип | Описание |
|---|---|---|
| id | String | Уникальный идентификатор транзакции. Совпадает с идентификатором исходной транзакции для возвратов. Совпадает с SuccessfulPayment.telegram_payment_charge_id для успешных входящих платежей от пользователей. |
| amount | Integer | Целочисленное количество Telegram Stars, переданных транзакцией |
| nanostar_amount | Integer | Опционально. Количество 1/1000000000 долей Telegram Stars, переданных транзакцией; от 0 до 999999999 |
| date | Integer | Дата создания транзакции в Unix-времени |
| source | TransactionPartner | Опционально. Источник входящей транзакции (например, пользователь, покупающий товары или услуги, Fragment, возвращающий неудачный вывод). Только для входящих транзакций |
| receiver | TransactionPartner | Опционально. Получатель исходящей транзакции (например, пользователь для возврата покупки, Fragment для вывода). Только для исходящих транзакций |
Примеры
json
{
"id": "transaction_123456789",
"amount": 500,
"nanostar_amount": 250000000,
"date": 1698765432,
"source": {
"type": "user",
"user_id": 987654321
}
}История изменений
- API 7.5. Добавлен объект StarTransaction
- API 8.1. Обновлен объект StarTransaction: Добавлено поле nanostar_amount
Дополнительно
- TransactionPartner - Объект описывает источник или получателя транзакции в Telegram Bot API.