Объект платежа

Справочник полей ответа

Объект платежа возвращают создание и получение платежа. Все суммы - целые числа в копейках, все даты - строки ISO 8601 в UTC.

Поля

string (UUID)

Идентификатор платежа в TabPay. Используйте его в запросах статуса; он же приходит в вебхуке.

orderId

string

Ваш номер заказа из запроса на создание.

status

string

Статус платежа - см. справочник статусов.

amountKopecks

integer

Сумма платежа в копейках.

commissionKopecks

integer

Комиссия TabPay в копейках по тарифу вашего магазина.

description

string | null

Назначение платежа.

method

string | null

SBP или CARD; null, пока покупатель не выбрал способ оплаты.

telegramId

string | null

Телеграм-ID покупателя из запроса на создание; null, если не передавался. Метаданные для ботов.

metadata

object | null

Ваши произвольные данные из запроса на создание (эхо), либо null.

successUrl

string | null

Ссылка возврата после успешной оплаты уровня платежа; null - используется ссылка магазина.

failUrl

string | null

Ссылка возврата после неудачной оплаты уровня платежа; null - используется ссылка магазина.

payUrl

string

Ссылка на платёжную страницу - отправьте покупателя сюда.

isTest

boolean

Тестовый платёж магазина-песочницы: исход задаётся на платёжной странице, деньги не двигаются, вебхук с test: true. См. раздел «Тестовый режим».

paidAt

string | null

Момент успешной оплаты в формате ISO 8601; null, пока платёж не оплачен.

createdAt

string

Момент создания платежа в формате ISO 8601.

Объект платежа

{
  "id": "6b9d2c88-4b1a-4f0e-9c37-1f2ab34cd561",
  "orderId": "order-1001",
  "status": "SUCCESS",
  "amountKopecks": 19900,
  "commissionKopecks": 1393,
  "description": "Подписка на месяц",
  "method": "SBP",
  "telegramId": "987654321",
  "metadata": { "productId": 42, "tariff": "month" },
  "successUrl": null,
  "failUrl": null,
  "payUrl": "https://tabpay.org/pay/6b9d2c88-4b1a-4f0e-9c37-1f2ab34cd561",
  "isTest": false,
  "paidAt": "2026-07-11T10:24:05.000Z",
  "createdAt": "2026-07-11T10:20:30.000Z"
}

Значения поля status и допустимые переходы - Статусы платежа.