telegram.SuccessfulPayment

class telegram.SuccessfulPayment(currency, total_amount, invoice_payload, telegram_payment_charge_id, provider_payment_charge_id, shipping_option_id=None, order_info=None, **kwargs)

Bases: telegram.base.TelegramObject

This object contains basic information about a successful payment.

currency

str – Three-letter ISO 4217 currency code.

total_amount

int – Total price in the smallest units of the currency.

invoice_payload

str – Bot specified invoice payload.

shipping_option_id

str – Optional. Identifier of the shipping option chosen by the user.

order_info

telegram.OrderInfo – Optional. Order info provided by the user.

telegram_payment_charge_id

str – Telegram payment identifier.

provider_payment_charge_id

str – Provider payment identifier.

Parameters:
  • currency (str) – Three-letter ISO 4217 currency code.
  • total_amount (int) – 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_payload (str) – Bot specified invoice payload.
  • shipping_option_id (str, optional) – Identifier of the shipping option chosen by the user.
  • order_info (telegram.OrderInfo, optional) – Order info provided by the user
  • telegram_payment_charge_id (str) – Telegram payment identifier.
  • provider_payment_charge_id (str) – Provider payment identifier.
  • **kwargs (dict) – Arbitrary keyword arguments.