Check

Обзор

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

Для выполнения платежа после успешной проверки необходимо использовать операцию Pay, описанную в Документации по операции Pay.

Запрос на проверку (Check Request)

Для проверки возможности платежа отправляется следующий запрос:

{
  "recipientId": 1001****51,
  "account": "5440********3132",
  "amount": 6000000000,
  "currency": 860,
  "agentTranId": "3c6a****-****-****-****-****f4a1",
  "params": {},
  "agentParams": {},
  "requestGroup": null,
  "requestSubGroup": null
}

Параметры запроса на проверку

Параметр	Тип	Обязательный	Описание	Максимальная длина
recipientId	Long	Да	Идентификатор получателя
account	String	Да	Номер счета для оплаты (номер карты)	64
amount	Long	Да	Сумма платежа (в тийинах)
currency	Integer	Да	Код валюты (860 - UZS)
agentTranId	String (UUID)	Да	Уникальный идентификатор транзакции	64
params	Map<String,Object>	Нет	Дополнительные параметры
agentParams	Map<String,Object>	Нет	Параметры агента
requestGroup	String	Нет	Группа запроса
requestSubGroup	String	Нет	Подгруппа запроса

Ответ на проверку (Check Response)

При успешной проверке возвращается следующий ответ:

{
  "id": 1024****65,
  "recipientId": 1001****51,
  "recipientShortName": "i.dep****uzs",
  "sessionId": null,
  "amountRatio": 100,
  "amount": 6000000000,
  "account": "5440********3132",
  "currency": 860,
  "extId": 0,
  "requestTime": "2025-08-21T05:56:44.412319Z",
  "responseTime": "2025-08-21T05:56:44.413729Z",
  "responseText": "SKIP_CHECK_IS_ON",
  "success": true,
  "status": "CHECK_OK",
  "data": {
    "skipCheck": true,
    "rate": 100,
    "recipientCcy": 860,
    "senderCcy": null,
    "recipientAmount": 6000000000
  },
  "statusCode": 0,
  "statusMessage": null,
  "problemStatus": null,
  "gatewayName": null,
  "sender": null,
  "receiver": null
}

Параметры ответа на проверку

Параметр	Тип	Описание
id	Long	Идентификатор счета (требуется для операции оплаты)
recipientId	Long	Идентификатор получателя
recipientShortName	String	Краткое имя получателя (макс. 64 символа)
sessionId	String/null	Идентификатор сессии (для POS-систем, макс. 32 символа)
amountRatio	Integer	Коэффициент суммы (например, 1 - рубли/сумы, 100 - тийины/копейки)
amount	Long	Сумма платежа
account	String	Номер счета/телефона (макс. 64 символа)
currency	Integer	Код валюты (3-значный код ISO 4217)
extId	String	Внешний идентификатор транзакции (макс. 32 символа)
requestTime	String	Время запроса (формат ISO 8601 Instant)
responseTime	String	Время ответа (формат ISO 8601 Instant)
responseText	String	Текст ответа (макс. 128 символов)
success	Boolean	Статус успеха (true/false)
status	TransactionStatus	Статус транзакции (см. Документация по статусам транзакций)
data	Map<String,Object>	Дополнительные данные (JSON-объект)
statusCode	Integer	Код статуса (0 - успех, другие значения - ошибка)
statusMessage	String/null	Сообщение о статусе
problemStatus	ProblemStatus/null	Статус проблемы
gatewayName	String/null	Название шлюза
sender	P2pParticipantDto/null	Информация об отправителе
receiver	P2pParticipantDto/null	Информация о получателе

Статусы транзакций для операции проверки

• NEW - Новая транзакция

• CHECK_OK - Проверка успешна

• CHECKING - Проверка в процессе

• CHECK_FAIL - Проверка не удалась

Важные замечания

1. Последовательность: Операция проверки должна выполняться перед операцией оплаты.

2. Идентификатор счета: Используйте id из ответа на проверку как billId в запросе на оплату.

3. Формат суммы: Все суммы указываются в тийинах (1 сум = 100 тийинов).

4. Код валюты: 860 - Узбекский сум (UZS).

5. UUID: agentTranId должен быть уникальным для каждой транзакции.

Обработка ошибок

Проверяйте следующие параметры в ответе API:

• success: true и statusCode: 0 - операция успешна

• success: false или statusCode != 0 - ошибка операции

В случае ошибок используйте следующие параметры:

• statusMessage - Подробная информация об ошибке

• problemStatus - Статус проблемы (перечисление ProblemStatus)

• status - Значение перечисления TransactionStatus (см. Документация по статусам транзакций)