telegram api constructor · layer 229 · #049ee584
invoice
Invoice
definition
invoice#49ee584 flags:# test:flags.0?true name_requested:flags.1?true phone_requested:flags.2?true email_requested:flags.3?true shipping_address_requested:flags.4?true flexible:flags.5?true phone_to_provider:flags.6?true email_to_provider:flags.7?true recurring:flags.9?true currency:string prices:Vector<LabeledPrice> max_tip_amount:flags.8?long suggested_tip_amounts:flags.8?Vector<long> terms_url:flags.10?string subscription_period:flags.11?int = Invoice;
parameters
| name | type | description |
|---|---|---|
flags | # | Flags, see TL conditional fields |
test | true | Test invoice |
name_requested | true | Set this flag if you require the user's full name to complete the order |
phone_requested | true | Set this flag if you require the user's phone number to complete the order |
email_requested | true | Set this flag if you require the user's email address to complete the order |
shipping_address_requested | true | Set this flag if you require the user's shipping address to complete the order |
flexible | true | Set this flag if the final price depends on the shipping method |
phone_to_provider | true | Set this flag if user's phone number should be sent to provider |
email_to_provider | true | Set this flag if user's email address should be sent to provider |
recurring | true | Whether this is a recurring payment |
currency | string | Three-letter ISO 4217 currency code, or XTR for Telegram Stars. |
prices | Vector<LabeledPrice> | Price breakdown, a list of components (e.g. product price, tax, discount, delivery cost, delivery tax, bonus, etc.) |
max_tip_amount | long | The maximum accepted amount for tips 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). |
suggested_tip_amounts | Vector<long> | A vector of suggested amounts of tips in the smallest units of the currency (integer, not float/double). At most 4 suggested tip amounts can be specified. The suggested tip amounts must be positive, passed in a strictly increased order and must not exceed max_tip_amount. |
terms_url | string | Terms of service URL |
subscription_period | int | The number of seconds between consecutive Telegram Star debiting for bot subscription invoices |
type
history
present in layers 65–229 · constructor id changed 4×
| id | layers |
|---|---|
| #c30aa358 | 65–126 |
| #0cd886e0 | 127–142 |
| #3e85a91b | 143–163 |
| #5db95a15 | 164–192 |
| #049ee584 | 193–229 |