Pay

Метод: POST

Эндпоинт: /api/agent/p2p/pay/v2

Пример тела запроса:

{
  "agentTranId": "122",
  "from": {
    "params": {
      "pan": "8600510311111111",
      "otp": "111222"
    },
    "type": "PAN",
    "currency": 860
  },
  "to": {
    "params": {
      "pan": "8600510311111111"
    },
    "type": "PAN",
    "currency": 860
  },
  "amount": 2100,
  "promo": {
    "code": "promo_5mln"
  }
}

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

Поле	Обязательное	Тип	Описание
agentTranId	да	String	Уникальный идентификатор запроса()
from	да	String	Поля from описывают отправителя
from.params	да	JSON	Набор параметров, зависящих от type
from.params.otp	да	String	OTP code
to.type	да	String	Тип счета получателя default - PAN (PAN, TOKEN, SQB_ACCOUNT)
to.currency	да	Number	Код валюты получателя(default 860)
to	да	JSON	Поля to описывают получателя
to.params	да	String	Набор параметров, зависящих от type
to.type	да	String	Тип счета получателя default - PAN (PAN, TOKEN, SQB_ACCOUNT)
to.currency	да	Number	Код валюты получателя(default 860)
amount	да	Number	Сумма транзакции
promo.code	нет	String	promo code

1. Когда type = PAN. Если значение поля type равно PAN, то структура объекта params имеет следующий вид:

{
  "pan": "8600111122223333",
  "exp": "1022",
  "name": "Cardholder name",
  "ccy": "860",
  "additionalParam": {
    "citizen": "860",
    "birthDate": "2025-10-25",
    "docType": "passport",
    "docNumber": "AA5111212",
    "docDate": "2025-10-25",
    "pinFl": "12345678901234",
    "firstName": "Sender first name",
    "lastName": "Sender last name",
    "middleName": "Sender middle name"
  }
}

🧩 Описание полей:

Поле	Тип	Обязательность	Описание
pan	String (16 цифр)	Да	Номер карты (PAN)
exp	String (4 цифр)	Да	Срок действия карты в формате MMYY
name	String (≤128)	Нет	Имя держателя карты
ccy	String	Нет	Код валюты (например, 860)
additionalParam	JSON	Нет* Подробнее	Дополнительные данные отправителя

2. Когда type = TOKEN. Если значение поля type равно TOKEN, то структура объекта params имеет следующий вид:

{
  "token": "ASD78KGS88GSDNGV4098TUASF",
  "bin": "860011",
  "name": "Name of the card holder",
  "exp": "1126",
  "additionalParam": {
    "citizen": "860",
    "birthDate": "2025-10-25",
    "docType": "passport",
    "docNumber": "AA5111212",
    "docDate": "2025-10-25",
    "pinFl": "12345678901234",
    "firstName": "Sender first name",
    "lastName": "Sender last name",
    "middleName": "Sender middle name"
  }
}

🧩 Описание полей:

Поле	Тип	Обязательность	Описание
token	String	Да	Уникальный токен карты (идентификатор, выданный эмитентом или платежной системой)
bin	String (6, 8 или 16 цифр)	Да	Номер BIN или PAN-кода карты (используется для идентификации банка-эмитента)
name	String	Нет	Имя держателя карты
exp	String (4 цифр)	Нет	Срок действия карты в формате MMYY
additionalParam	JSON	Нет* Подробнее	Дополнительные данные отправителя

3. Когда type = SQB_ACCOUNT. Если значение поля type равно SQB_ACCOUNT, то структура объекта params имеет следующий вид:

{
  "account": "22616000111222333444",
  "mfo": "00491",
  "name": "name of the account owner",
  "purpose": "purpose",
  "purposeId": "purposeId",
  "inn": "123456789",
  "additionalParam": {
    "citizen": "860",
    "birthDate": "2025-10-25",
    "docType": "passport",
    "docNumber": "AA5111212",
    "docDate": "2025-10-25",
    "pinFl": "12345678901234",
    "firstName": "Sender first name",
    "lastName": "Sender last name",
    "middleName": "Sender middle name"
  }
}

🧩 Описание полей:

Поле	Тип	Обязательное	Описание
account	String (20 цифр)	Да	Номер банковского счёта получателя или отправителя.
mfo	String (5 цифр)	Да	Код МФО (банковский идентификатор).
name	String (≤ 128)	Да	Имя владельца счёта.
purpose	String	Нет	Назначение платежа (например: «оплата услуг»).
purposeId	String	Нет	Идентификатор назначения платежа.
inn	String (9 цифр)	Нет	ИНН владельца счёта.
additionalParam	JSON	Нет* Подробнее	Используется только, если поле params находится в объекте from, сумма перевода > 50 BRV, и перевод выполняется между картами Uzcard ⇄ Humo.

Response example:

{
  "amount": 2100,
  "currency": 860,
  "agentTranId": "1752818335",
  "success": true,
  "statusCode": 0,
  "statusMessage": "SUCCESS",
  "sender": {
    "name": "{\"pan\":\"8600510343218413\"}",
    "amount": 2111,
    "processorType": "UZCARD",
    "commissionAmount": 11,
    "commission": 0.50,
    "currency": 860,
    "data": {
      "ACCOUNT": "8600510343218413",
      "COMMISSION_PARTS": [
        {
          "name": "Charity 0,01%",
          "amount": 0,
          "amountInPercent": 0.01,
          "code": "review"
        },
        {
          "name": "Bank income - 0.09%",
          "amount": 3,
          "amountInPercent": 0.09,
          "isResidualReceiver": true
        },
        {
          "name": "PC Uzcard Kredit 0.40%",
          "amount": 8,
          "amountInPercent": 0.4
        }
      ],
      "EXT_ID": "refNum1,refNum2"
    }
  },
  "recipient": {
    "name": "{\"pan\":\"8600510343218413\"}",
    "amount": 2100,
    "processorType": "UZCARD",
    "commissionAmount": 0,
    "commission": 0,
    "currency": 860,
    "data": {
      "ACCOUNT": "8600510343218413",
      "COMMISSION_PARTS": [
        {
          "name": "0%",
          "amount": 0,
          "amountInPercent": 0,
          "isResidualReceiver": true
        }
      ],
      "EXT_ID": "refNum1,refNum2"
    }
  },
  "rate": {
    "bankSell": 1,
    "bankBuy": 1
  },
  "bmId": 100266151
}

Поля ответа:

Поле	Тип	Описание
amount	Number	Сумма запроса
currency	Number	Код валюты транзакции
agentTranId	String	Уникальный идентификатор запроса агента
authorized	Boolean	Статус авторизации
success	Boolean	Флаг успеха транзакции
statusCode	Number	Код статуса (statusCode является индикатором успеха транзакции) (Значения кодов статуса)
statusMessage	String	Сообщение статуса
sender.name	String	Имя отправителя (JSON строка)
sender.amount	Number	Сумма отправителя с комиссией
sender.processorType	String	Тип процессора отправителя
sender.commissionAmount	Number	Сумма комиссии отправителя
sender.commission	Number	Ставка комиссии отправителя
sender.currency	Number	Код валюты отправителя
sender.data.ACCOUNT	String	Номер счета отправителя
sender.data.COMMISSION_PARTS.name	String	Название первой части комиссии
sender.data.COMMISSION_PARTS.amount	Number	Сумма первой части комиссии
sender.data.COMMISSION_PARTS.amountInPercent	Number	Процент первой части комиссии
sender.data.COMMISSION_PARTS.code	String	Код первой части комиссии
sender.data.EXT_ID	String	Внешний идентификатор отправителя
recipient.name	String	Имя получателя (JSON строка)
recipient.amount	Number	Сумма получателя
recipient.processorType	String	Тип процессора получателя
recipient.commissionAmount	Number	Сумма комиссии получателя
recipient.commission	Number	Ставка комиссии получателя
recipient.currency	Number	Код валюты получателя
recipient.data.ACCOUNT	String	Номер счета получателя
recipient.data.COMMISSION_PARTS.name	String	Название части комиссии получателя
recipient.data.COMMISSION_PARTS.amount	Number	Сумма части комиссии получателя
recipient.data.COMMISSION_PARTS.amountInPercent	Number	Процент части комиссии получателя
recipient.data.COMMISSION_PARTS.isResidualReceiver	Boolean	Остаточный получатель части комиссии получателя
recipient.data.EXT_ID	String	Внешний идентификатор получателя
rate.bankSell	Number	Курс продажи банка
rate.bankBuy	Number	Курс покупки банка
bmId	Number	Идентификатор BM