Оценка карт

Раздел описывает методы и параметры для получения информации для оценки количества и суммы поступлений и снятий по карте за указанный период времени.

Стуктура

Сводка представляет собой структуру с ключами-датами в формате YYYY-MM (по месяцам). Каждому месяцу соответствует список сводок для конкретных типов транзакций. Если за определённый месяц отсутствуют транзакции, ключ для данного месяца не включается в ответ.

Атрибуты

Name
type
Type
string
Description
Тип транзакций из списка типов.
Name
amount
Type
integer
Description
Сумма транзакций данного типа за месяц в тийинах.
Name
count
Type
integer
Description
Количество транзакций данного типа за месяц.

Пример сводки за месяц

{
  "type": "CREDIT",
  "amount": 1876536939,
  "count": 3
}

POST/scoring

Получение сводки

Возвращает историю транзакций по карте, агрегированную по месяцам и типу транзакции за запрашиваемый период. Для кажого месяца и типа предоставляется сумма и количество транзакций.

Параметры

Name
ref
Type
string
Description
Уникальный идентификатор запроса.
Name
token
Type
string
Description
Токен карты, полученный при токенизации.
Name
from_date
Type
string
Description
Дата начала периода в формате YYYY-MM-DD.
Для карт системы Uzcard должен быть как минимум за два месяца до текущей даты.
Name
to_date
Type
string
Description
Дата окончания периода в формате YYYY-MM-DD.
Интервал запрашиваемого периода не должен превышать один год.

Запрос

POST

/scoring

{
  "ref": "41185257-b3d0-41f3-babd",
  "token": "62d602f4-115d-46ce-a385",
  "from_date":"2022-01-01",
  "to_date": "2023-02-28"
}

Ответ

{
  "2023-01": [
    {
      "type": "CREDIT",
      "amount": 1876536939,
      "count": 3
    },
    {
      "type": "CREDIT_REVERSAL",
      "amount": 6120000,
      "count": 3
    },
    ...
  ],
  "2023-02": [ ... ],
  "2023-03": [ ... ],
  ...
}

Типы транзакций

Значение	Описание
`DEBIT`	Снятие
`CREDIT`	Пополнение
`P2P_DEBIT`	Снятие c карты отправителя при переводе между картами
`P2P_CREDIT`	Пополнение карты получателя при переводе между картами
`DEBIT_REVERSAL`	Возврат снятых средств
`CREDIT_REVERSAL`	Возврат пополнения
`P2P_DEBIT_REVERSAL`	Возврат снятых средств при переводе между картами
`P2P_CREDIT_REVERSAL`	Возврат пополнения при переводе между картами
`CASH_IN`	Пополнение карты наличными средствами через банкомат
`CASH_OUT`	Снятие наличных средств с карты через банкомат
`REFILL_FROM_BANK_ACCOUNT`	Пополнение карты с банковского счёта