RefundedPayment

Raw MD
This object contains basic information about a refunded payment

This object contains basic information about a refunded payment.

Fields

FieldTypeRequiredDescription
currencyStringAlwaysThree-letter ISO 4217 currency code, or "XTR" for payments in Telegram Stars. Currently, always "XTR".
total_amountIntegerAlwaysTotal refunded price in the smallest units of the currency (integer, not float/double). For example, for a price of US$ 1.45, total_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_payloadStringAlwaysBot-specified invoice payload
telegram_payment_charge_idStringAlwaysTelegram payment identifier
provider_payment_charge_idStringOptionalProvider payment identifier
Botlify Cloud Runtime
Credentials are auto-injected in .env — always load them with getenv(): BOT_TOKEN, ADMIN_CHAT_ID, BOT_USERNAME. Main database: database.db (SQLite, WAL mode). Runtime errors: error.log. Quick test: send to $ADMIN_CHAT_ID. Full details: Runtime Reference.