Check

---

Метод: POST

Эндпоинт: /api/agent/v2/unregistered-check

Авторизация

Нужно передавать jwt token в заголовках (headers):

Authorization: Bearer <access_token>
Content-Type: application/json

---

Тело запроса - CheckRequest

{
  "agentTranId": "123qwe",
  "recipientId": 123456,
  "account": "123",
  "amount": 10000,
  "params": {
    "pan": "8600123412341234",
    "exp": "0127"
  }
}

Поля тела запроса

Поле	Обязательное	Тип	Описание
agentTranId	Да	String	Уникальный идентификатор транзакции
recipientId	Да	Number	Идентификатор получателя (merchant / provider / услуга)
account	Да	String	Лицевой счёт / номер телефона / идентификатор клиента
amount	Да	Number	Сумма платежа
params.pan	Да	String	Номер карты
params.exp	Да	String	Срок действия карты (формат YYMM)

При отсутствии любого из обязательных полей сервер выбросит Не найдена сумма или номер карты или срок карты → HTTP 400.

---

Формат ответа (SimpleBillResponse)

{
  "id": 987654321,
  "recipientId": 123456,
  "recipientShortName": "UMS MOBILE",
  "sessionId": "SESS-20251107-001",
  "amount": 10000,
  "account": "998901234567",
  "currency": 860,
  "extId": "AGT-00112233",
  "requestTime": "2025-11-07T10:23:45Z",
  "responseTime": "2025-11-07T10:23:46Z",
  "responseText": "Услуга успешно проверена",
  "success": true,
  "status": "CHECK_OK",
  "data": {
    "abonentName": "ALIJON ALIJONOV",
    "balanceBefore": 15000,
    "service": "Mobile Top-Up",
    "providerInfo": "UMS",
    "otp": {
      "message": "OTP code has been sent to mobile number",
      "msisdn": "+998*******24",(only in humo)
      "id": "117098788"(only in uzcard)
    }
  },
  "statusCode": 0,
  "statusMessage": "SUCCESS",
  "gatewayName": "SOME_GATEWAY",
  "sender": {
    "id": "CARD-8600",
    "name": "Humo / Uzcard",
    "account": "860012******1234"
  },
  "receiver": {
    "id": "UMS",
    "name": "UMS MOBILE",
    "account": "998901234567"
  }
}

Поля тела запроса

Поле	Тип	Значение из примера	Описания
id	Number	987654321
recipientId	Number	123456
recipientShortName	String	"UMS MOBILE"
sessionId	String	"SESS-20251107-001"
amount	Number	10000
account	String	"998901234567"
currency	Number	860
extId	String	"AGT-00112233"
requestTime	Number	"2025-11-07T10:23:45Z"
responseTime	Number	"2025-11-07T10:23:46Z"
responseText	String	"Услуга успешно проверена"
success	Boolean	true
status	String	"CHECK_OK"
data.abonentName	String	"ALIJON ALIJONOV"
data.balanceBefore	Number	15000
data.service	String	"Mobile Top-Up"
data.providerInfo	String	"UMS"
data.otp	String	JSON	Детали OTP
data.otp.message	String	OTP code has been sent to mobile number(in humo) Successfully send to ********1234(in uzcard)	Сообщение OTP
data.otp.msisdn	String	+998*******34 (only in humo)	Номер телефона, на который отправлен OTP
data.otp.id	String	117772233 (only in uzcard)	Детали OTP
statusCode	Number	0
statusMessage	String	"SUCCESS"
gatewayName	String	"SOME_GATEWAY"
sender.id	String	"CARD-8600"
sender.name	String	"Humo / Uzcard"
sender.account	String	"860012******1234"
receiver.id	String	"UMS"
receiver.name	String	"UMS MOBILE"
receiver.account	String	"998901234567"

Поля ответа (SimpleBillResponse)

Возможные статусы

• CHECK_OK — проверка пройдена, OTP успешно запущен.

• CHECK_FAIL — проверка не пройдена или ошибка при OTP.

• Другие статусы домена (если определены в TransactionStatus).

---

Коды ответов

• 200 OK — успешная проверка; тело содержит SimpleBillResponse.

• 400 Bad Request — невалидные параметры (INVALID_PARAMS), непереданны или забыты нужные параметры.

• 401 Unauthorized — нет/просрочен токен, нужно заново обратится к нужным api что бы взять access/refresh token.

• 403 Forbidden — недостаточно прав, нужно запросить права у админа.

---

Примеры

Успешный ответ (200):

{
  "id": 987654321,
  "success": true,
  "status": "CHECK_OK",
  "data": {
    "recipientId": 123456,
    "recipientShortName": "UMS MOBILE",
    "sessionId": "SESS-20251107-001",
    "amount": 10000,
    "account": "998901234567",
    "currency": 860,
    "extId": "AGT-00112233",
    "requestTime": "2025-11-07T10:23:45Z",
    "responseTime": "2025-11-07T10:23:46Z",
    "responseText": "Услуга успешно проверена",
    "abonentName": "ALIJON ALIJONOV",
    "balanceBefore": 15000,
    "service": "Mobile Top-Up",
    "providerInfo": "UMS",
    "gatewayName": "SOME_GATEWAY"
  },
  "statusMessage": "SUCCESS",
  "sender": {
    "id": "CARD-8600",
    "name": "Humo / Uzcard",
    "account": "860012******1234"
  },
  "receiver": {
    "id": "UMS",
    "name": "UMS MOBILE",
    "account": "998901234567"
  }
}

Неуспешный OTP

{
  "success": false,
  "status": "SENDER_PC_ERROR",
  "details": "get something bank card error",
  "data": null
}

Ошибка валидации

{
  "error": "INVALID_PARAMS",
  "message": "Не найдена сумма или номер карты или срок карты"
}

---

Схема

Client → API: POST /v2/unregistered-check
API → sendOtpV2 // uzcard, humo
API → check(checkRequest)

---

Частые ошибки и советы

• INVALID_PARAMS — проверьте recipientId, account, amount, params.pan, params.exp.

• CHECK_FAIL из-за OTP — повторите попытку, проверьте доступность провайдера и корректность телефона.