Описание
Этот объект содержит основную информацию об успешном платеже. Обратите внимание, что если покупатель инициирует возврат средств через соответствующий платёжный провайдер после этой транзакции, средства могут быть списаны с вашего баланса. Это находится вне контроля Telegram.
| Поле | Тип | Описание |
|---|---|---|
| currency | String | Трёхбуквенный код валюты ISO 4217 currency, или «XTR» для платежей в Telegram Stars |
| total_amount | Integer | Общая цена в наименьших единицах валюты (целое число, не число с плавающей запятой). Например, для цены US$ 1.45 укажите amount = 145. См. параметр exp в currencies.json, там указано количество цифр после десятичной точки для каждой валюты (2 для большинства валют). |
| invoice_payload | String | Полезная нагрузка счёта, указанная ботом |
| subscription_expiration_date | Integer | Необязательный. Дата истечения срока действия подписки в формате Unix time; только для повторяющихся платежей |
| is_recurring | True | Необязательный. True, если платёж является повторяющимся платежом для подписки |
| is_first_recurring | True | Необязательный. True, если платёж является первым платежом для подписки |
| shipping_option_id | String | Необязательный. Идентификатор варианта доставки, выбранного пользователем |
| order_info | OrderInfo | Необязательный. Информация о заказе, предоставленная пользователем |
| telegram_payment_charge_id | String | Идентификатор платежа Telegram |
| provider_payment_charge_id | String | Идентификатор платежа провайдера |
Примеры
json
{
"currency": "USD",
"total_amount": 145,
"invoice_payload": "order_12345",
"subscription_expiration_date": 1735689600,
"is_recurring": true,
"is_first_recurring": false,
"shipping_option_id": "express",
"order_info": {
"name": "John Doe",
"phone_number": "+1234567890",
"email": "john@example.com",
"shipping_address": {
"country_code": "US",
"state": "NY",
"city": "New York",
"street_line1": "123 Main St",
"street_line2": "Apt 4B",
"post_code": "10001"
}
},
"telegram_payment_charge_id": "chg_telegram_abc123",
"provider_payment_charge_id": "chg_stripe_xyz789"
}История изменений
- API 8.0. Обновлен объект SuccessfulPayment: Добавлены поля subscription_expiration_date, is_recurring и is_first_recurring
Дополнительно
- OrderInfo - Объект содержит информацию о заказе, включая контактные данные и адрес доставки пользователя.