Получение платежа

GET по id платежа или своему номеру заказа

GET/api/v1/payments/{id}

GET/api/v1/payments?orderId={orderId}

Описание

Возвращает объект платежа - тот же формат, что и при создании. Искать можно по идентификатору TabPay из поля id или по вашему номеру заказа orderId.

Чужой или несуществующий платёж - одинаковый 404: платежи видны только магазину, который их создал.

Когда использовать

ответ на создание платежа не дошёл - проверить по orderId, существует ли платёж, прежде чем создавать заново;
вебхук не пришёл (ваш сервер был недоступен дольше суток повторов) - сверить статус;
ручная сверка при разборе спорной оплаты.

Для регулярного получения результатов используйте вебхуки, а не опрос в цикле - это быстрее и не упирается в лимиты.

curl https://tabpay.org/api/v1/payments/6b9d2c88-4b1a-4f0e-9c37-1f2ab34cd561 \
  -H "X-Api-Key: tp_ваш_ключ"

Ответ 200

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