StarsTransaction#

class pyrogram.raw.types.StarsTransaction#

Represents a Telegram Stars transaction ».

Constructor of StarsTransaction.

Details:

  • Layer: 198

  • ID: 64DFC926

Parameters:

  • id (str) – Transaction ID.

  • stars (StarsAmount) – Amount of Stars (negative for outgoing transactions).

  • date (int 32-bit) – Date of the transaction (unixtime).

  • peer (StarsTransactionPeer) – Source of the incoming transaction, or its recipient for outgoing transactions.

  • refund (bool, optional) – Whether this transaction is a refund.

  • pending (bool, optional) – The transaction is currently pending.

  • failed (bool, optional) – This transaction has failed.

  • gift (bool, optional) – This transaction was a gift from the user in peer.peer.

  • reaction (bool, optional) – This transaction is a paid reaction ».

  • stargift_upgrade (bool, optional) – N/A

  • title (str, optional) – For transactions with bots, title of the bought product.

  • description (str, optional) – For transactions with bots, description of the bought product.

  • photo (WebDocument, optional) – For transactions with bots, photo of the bought product.

  • transaction_date (int 32-bit, optional) – If neither pending nor failed are set, the transaction was completed successfully, and this field will contain the point in time (Unix timestamp) when the withdrawal was completed successfully.

  • transaction_url (str, optional) – If neither pending nor failed are set, the transaction was completed successfully, and this field will contain a URL where the withdrawal transaction can be viewed.

  • bot_payload (bytes, optional) – Bot specified invoice payload (i.e. the payload passed to inputMediaInvoice when creating the invoice).

  • msg_id (int 32-bit, optional) – For paid media transactions », message ID of the paid media posted to peer.peer (can point to a deleted message; either way, extended_media will always contain the bought media).

  • extended_media (List of MessageMedia, optional) – The purchased paid media ».

  • subscription_period (int 32-bit, optional) – The number of seconds between consecutive Telegram Star debiting for Telegram Star subscriptions ».

  • giveaway_post_id (int 32-bit, optional) – ID of the message containing the messageMediaGiveaway, for incoming star giveaway prizes.

  • stargift (StarGift, optional) – This transaction indicates a purchase or a sale (conversion back to Stars) of a gift ».

  • floodskip_number (int 32-bit, optional) – This transaction is payment for paid bot broadcasts. Paid broadcasts are only allowed if the allow_paid_floodskip parameter of messages.sendMessage and other message sending methods is set while trying to broadcast more than 30 messages per second to bot users. The integer value returned by this flag indicates the number of billed API calls.

  • starref_commission_permille (int 32-bit, optional) – This transaction is the receival (or refund) of an affiliate commission (i.e. this is the transaction received by the peer that created the referral link, flag 17 is for transactions made by users that imported the referral link).

  • starref_peer (Peer, optional) – For transactions made by referred users, the peer that received the affiliate commission.

  • starref_amount (StarsAmount, optional) – For transactions made by referred users, the amount of Telegram Stars received by the affiliate, can be negative for refunds.