PreCheckoutQuery

Raw MD
This object contains information about an incoming pre-checkout query

This object contains information about an incoming pre-checkout query.

Fields

FieldTypeRequiredDescription
idStringAlwaysUnique query identifier
fromUserAlwaysUser who sent the query
currencyStringAlwaysThree-letter ISO 4217 currency code, or "XTR" for payments in Telegram Stars
total_amountIntegerAlwaysTotal 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_payloadStringAlwaysBot-specified invoice payload
shipping_option_idStringOptionalIdentifier of the shipping option chosen by the user
order_infoOrderInfoOptionalOrder information provided by the user
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.