Проверка платежа

API для проверки статуса транзакции по ее идентификатору.

Пример запроса

GET /api/v1/billing/check/transaction
Accept: application/json
Content-Type: application/json
Authorization: Basic base64(username:password)

{
  "transactionId": "string"
}

Параметры запроса

#	Параметр	Тип	Описание
1	transactionId	UUID	Идентификатор транзакции — передается в сервис мерчанта после успешной оплаты.

Пример ответа

{
  "data": {
    "invoice": "213598",
    "phone": "998931470608",
    "operationId": "string",
    "accountType": "UZCARD",
    "amount": 100000,
    "payTime": "22-07-2025 14:47:27",
    "status": "SUCCESS"
  },
  "errorMessage": "",
  "timestamp": 1753437959364
}

Параметры ответа

#	Параметр	Тип	Описание
1	invoice	String	Номер счета.
2	phone	String	Номер телефона клиента.
3	operationId	UUID	Идентификатор транзакции.
4	accountType	String	Тип карты: UZCARD или HUMO.
5	amount	Long	Сумма транзакции в тийинах.
6	payTime	String	Время оплаты в формате dd-MM-yyyy HH:mm:ss.
7	status	Enum	Статус транзакции — см. таблицу ниже.
8	errorMessage	String	Текст ошибки.
9	timestamp	Long	Время ответа в миллисекундах.

Статусы транзакции

Статус	Описание
PENDING	Транзакция в обработке.
SUCCESS	Оплата прошла успешно.
FAILED	Оплата не прошла.
REVERSED	Транзакция отменена (средства возвращены).

Ответ с ошибкой

{
  "data": null,
  "errorMessage": "Операция не найдена!",
  "timestamp": 1753437974340
}