TransactionPartnerUser
نوع دادهزیرنوعی از TransactionPartner
تراکنش با یک کاربر را توصیف می‌کند.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| type | String | نوع طرف تراکنش؛ همیشه «user» |
| transaction_type | String | نوع تراکنش؛ در حال حاضر یکی از «invoice_payment» برای پرداخت از طریق صورتحساب، «paid_media_payment» برای پرداخت رسانهٔ پولی، «gift_purchase» برای هدیه‌های فرستاده‌شده توسط ربات، «premium_purchase» برای اشتراک‌های تلگرام پریمیومی که ربات هدیه داده، و «business_account_transfer» برای انتقال مستقیم از حساب‌های کسب‌وکار مدیریت‌شده |
| user | User | اطلاعات کاربر |
| affiliate | AffiliateInfo | اختیاری. اطلاعات همکار فروش که از طریق این تراکنش کمیسیون گرفته است. فقط برای تراکنش‌های «invoice_payment» و «paid_media_payment» ممکن است در دسترس باشد. |
| invoice_payload | String | اختیاری. payload صورتحساب که ربات تعیین کرده است. فقط برای تراکنش‌های «invoice_payment» ممکن است در دسترس باشد. |
| subscription_period | Integer | اختیاری. مدت اشتراک پولی. فقط برای تراکنش‌های «invoice_payment» ممکن است در دسترس باشد. |
| paid_media | Array of PaidMedia | اختیاری. اطلاعات رسانهٔ پولی‌ای که کاربر خریده است؛ فقط برای تراکنش‌های «paid_media_payment» |
| paid_media_payload | String | اختیاری. payload رسانهٔ پولی که ربات تعیین کرده است. فقط برای تراکنش‌های «paid_media_payment» ممکن است در دسترس باشد. |
| gift | Gift | اختیاری. هدیه‌ای که ربات برای کاربر فرستاده است؛ فقط برای تراکنش‌های «gift_purchase» |
| premium_subscription_duration | Integer | اختیاری. تعداد ماه‌هایی که اشتراک تلگرام پریمیومِ هدیه‌شده فعال خواهد بود؛ فقط برای تراکنش‌های «premium_purchase» |