Тип данных PreCheckoutQuery

Объект содержит информацию о запросе предварительной проверки оплаты, включая данные о пользователе, валюте, сумме и деталях заказа.

Описание

Этот объект содержит информацию о входящем запросе предварительной проверки оплаты.

Поле Тип Описание
id String Уникальный идентификатор запроса
from User Пользователь, отправивший запрос
currency String Трёхбуквенный код валюты ISO 4217 currency, или «XTR» для платежей в Telegram Stars
total_amount Integer Общая сумма в наименьших единицах валюты (целое число, не float/double). Например, для цены US$ 1.45 укажите amount = 145. См. параметр exp в currencies.json, который показывает количество знаков после десятичной точки для каждой валюты (2 для большинства валют).
invoice_payload String Полезная нагрузка счёта, указанная ботом
shipping_option_id String Необязательный. Идентификатор варианта доставки, выбранного пользователем
order_info OrderInfo Необязательный. Информация о заказе, предоставленная пользователем

Примеры

json

{
  "id": "pre_checkout_query_123456789",
  "from": {
    "id": 123456789,
    "is_bot": false,
    "first_name": "John",
    "last_name": "Doe",
    "username": "johndoe",
    "language_code": "en"
  },
  "currency": "USD",
  "total_amount": 1450,
  "invoice_payload": "order_12345",
  "shipping_option_id": "express_shipping",
  "order_info": {
    "name": "John Doe",
    "phone_number": "+1234567890",
    "email": "john@example.com",
    "shipping_address": {
      "country_code": "US",
      "state": "California",
      "city": "San Francisco",
      "street_line1": "123 Main St",
      "street_line2": "Apt 4B",
      "post_code": "94105"
    }
  }
}

Дополнительно

  • User - Объект, представляющий пользователя или бота Telegram с основной информацией и настройками.
  • OrderInfo - Объект содержит информацию о заказе, включая контактные данные и адрес доставки пользователя.
Комментарии