TransactionPartnerUser¶

class aiogram.types.transaction_partner_user.TransactionPartnerUser(*, type: Literal[TransactionPartnerType.USER] = TransactionPartnerType.USER, transaction_type: str, user: User, affiliate: AffiliateInfo | None = None, invoice_payload: str | None = None, subscription_period: int | None = None, paid_media: list[PaidMediaPreview | PaidMediaPhoto | PaidMediaVideo] | None = None, paid_media_payload: str | None = None, gift: Gift | None = None, premium_subscription_duration: int | None = None, **extra_data: Any)[source]¶

Describes a transaction with a user.

Source: https://core.telegram.org/bots/api#transactionpartneruser

type: Literal[TransactionPartnerType.USER]¶: Type of the transaction partner, always ‘user’

transaction_type: str¶: Type of the transaction, currently one of ‘invoice_payment’ for payments via invoices, ‘paid_media_payment’ for payments for paid media, ‘gift_purchase’ for gifts sent by the bot, ‘premium_purchase’ for Telegram Premium subscriptions gifted by the bot, ‘business_account_transfer’ for direct transfers from managed business accounts

user: User¶: Information about the user

affiliate: AffiliateInfo | None¶: Optional. Information about the affiliate that received a commission via this transaction. Can be available only for ‘invoice_payment’ and ‘paid_media_payment’ transactions.

invoice_payload: str | None¶: Optional. Bot-specified invoice payload. Can be available only for ‘invoice_payment’ transactions.

subscription_period: int | None¶: Optional. The duration of the paid subscription. Can be available only for ‘invoice_payment’ transactions.

paid_media: list[PaidMediaUnion] | None¶: Optional. Information about the paid media bought by the user; for ‘paid_media_payment’ transactions only

paid_media_payload: str | None¶: Optional. Bot-specified paid media payload. Can be available only for ‘paid_media_payment’ transactions.

gift: Gift | None¶: Optional. The gift sent to the user by the bot; for ‘gift_purchase’ transactions only

premium_subscription_duration: int | None¶: Optional. Number of months the gifted Telegram Premium subscription will be active for; for ‘premium_purchase’ transactions only