Invoice

Raw MD
This object contains basic information about an invoice

This object contains basic information about an invoice.

Fields

FieldTypeRequiredDescription
titleStringAlwaysProduct name
descriptionStringAlwaysProduct description
start_parameterStringAlwaysUnique bot deep-linking parameter that can be used to generate this invoice
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).
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.