SuccessfulPayment
This object contains basic information about a successful payment. Note that if the buyer initiates a chargeback with the relevant payment provider following this transaction, the funds may be debited from your balance. This is outside of Telegram's control.
Поля
currencyString
Three-letter ISO 4217 currency code, or “XTR” for payments in Telegram Stars
total_amountInteger
Total price in the smallest units of the currency (integer, not float/double). For example, for a price of
US$ 1.45 pass amount = 145. See the exp parameter in currencies.json, it shows the number of digits past the decimal point for each currency (2 for the majority of currencies).invoice_payloadString
Bot-specified invoice payload
Expiration date of the subscription, in Unix time; for recurring payments only
True, if the payment is a recurring payment for a subscription
True, if the payment is the first payment for a subscription
Identifier of the shipping option chosen by the user
Order information provided by the user
Telegram payment identifier
Provider payment identifier
Поле StaticGram (в официальном Bot API его нет). Только для коинов (currency "TON"): сумма платежа в коинах десятичной строкой, например "1.5"; total_amount при этом в нанотонах (1 коин = 1000000000). Для статиков (XTR) поля нет.
Минимальный JSON
JSON
{
"currency": "...",
"total_amount": 1,
"invoice_payload": "...",
"telegram_payment_charge_id": "...",
"provider_payment_charge_id": "..."
}Где используется
Типы