Тип данных RefundedPayment

Объект содержит информацию о возвращённом платеже, включая валюту, сумму и идентификаторы.

Описание

Этот объект содержит основную информацию о возвращённом платеже.

Поле Тип Описание
currency String Трёхбуквенный код валюты по стандарту ISO 4217 currency, или «XTR» для платежей в Telegram Stars. В настоящее время всегда «XTR»
total_amount Integer Общая возвращённая сумма в наименьших единицах валюты (целое число, не число с плавающей точкой). Например, для цены US$ 1.45 значение total_amount = 145. См. параметр exp в currencies.json, который показывает количество знаков после запятой для каждой валюты (2 для большинства валют).
invoice_payload String Полезная нагрузка счёта, указанная ботом
telegram_payment_charge_id String Идентификатор платежа Telegram
provider_payment_charge_id String Необязательный. Идентификатор платежа провайдера

Примеры

json

{
  "currency": "XTR",
  "total_amount": 145,
  "invoice_payload": "order_12345",
  "telegram_payment_charge_id": "charge_abc123",
  "provider_payment_charge_id": "provider_xyz789"
}

История изменений

  • API 7.7. Добавлен объект RefundedPayment
Комментарии