SuccessfulPayment
نوع دادهاین شیء اطلاعات پایهٔ یک پرداخت موفق را شامل می‌شود. توجه کنید اگر خریدار پس از این تراکنش نزد ارائه‌دهندهٔ پرداخت مربوطه درخواست chargeback کند، ممکن است وجه از موجودی شما کسر شود. این موضوع خارج از کنترل تلگرام است.
فیلدها
| نام | نوع | توضیحات |
|---|---|---|
| currency | String | کد سه‌حرفی ارز بر پایهٔ ISO 4217، یا «XTR» برای پرداخت با ستارهٔ تلگرام |
| total_amount | Integer | قیمت کل به کوچک‌ترین واحد ارز (عدد صحیح، نه اعشاری). مثلاً برای قیمت ۱٫۴۵ دلار آمریکا amount = 145 بدهید. پارامتر exp را در currencies.json ببینید؛ تعداد ارقام بعد از ممیز هر ارز را نشان می‌دهد (برای بیشتر ارزها ۲). |
| invoice_payload | String | payload صورتحساب که ربات تعیین کرده است. |
| subscription_expiration_date | Integer | اختیاری. تاریخ انقضای اشتراک به زمان یونیکس؛ فقط برای پرداخت‌های تکرارشونده |
| is_recurring | Boolean | اختیاری. True اگر پرداخت، پرداخت تکرارشوندهٔ یک اشتراک باشد. |
| is_first_recurring | Boolean | اختیاری. True اگر پرداخت، اولین پرداخت یک اشتراک باشد. |
| shipping_option_id | String | اختیاری. شناسهٔ گزینهٔ ارسالی که کاربر انتخاب کرده است. |
| order_info | OrderInfo | اختیاری. اطلاعات سفارشی که کاربر ارائه کرده است. |
| telegram_payment_charge_id | String | شناسهٔ پرداخت تلگرام |
| provider_payment_charge_id | String | شناسهٔ پرداخت ارائه‌دهنده |