API

Русский

O‘zbekcha

Русский

O‘zbekcha

Тема

Транзакции ​

Движения по балансам компаний (основной, SMS, подписка и др.): пополнения, списания, оплаты тарифа. Транзакции компаний партнёров здесь не показываются — они в разделе «Транзакции партнеров».

МетодАдресНазначение
POST/admin/company/transaction/refillПополнить баланс
PATCH/admin/company/transaction/{model}/cancelОтменить транзакцию
GET/admin/company/transactionСписок транзакций
GET/admin/company/transaction/{model}Карточка транзакции

Пополнить баланс ​

POST/admin/company/transaction/refill

Создаёт ручную приходную транзакцию «Пополнение баланса» и увеличивает выбранный баланс компании (balance_type). Тип оплаты system не допускается. Возвращает созданную транзакцию.

Заголовки ​

ЗаголовокЗначениеОписание
AuthorizationBearer {token}Токен из POST /common/auth/login
Acceptapplication/jsonОтвет в JSON
Accept-LanguageruЯзык сообщений и названий: ru, uz, oz

Тело запроса ​

ПолеТипОбязательноОписание
company_idintegerДаКомпания. ID существующей записи, доступной пользователю
payment_typestringДаТип оплаты. Допустимые значения: bank, card, cash, discount, my_uzcard, terminal
amountnumberДаСумма. До 2 знаков после запятой. Не меньше 0.01. Не больше 999999999999.99
balance_typestringДаТип баланса. Допустимые значения: main, sms, pochta, imei, aniq_score, subscription
commentstringНетКомментарий. Макс. 1000 символов
json
{
    "company_id": 1,
    "payment_type": "bank",
    "amount": 1000,
    "balance_type": "main",
    "comment": "Comment 4"
}
bash
curl -X POST "https://api.wasyt.uz/admin/company/transaction/refill" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"company_id":1,"payment_type":"bank","amount":1000,"balance_type":"main","comment":"Comment 4"}'

Ответ · 200 ​

Поля ответа
ПолеТипОписание
company_idintegerКомпания
payment_typestringТип оплаты
amountintegerСумма
balance_typestringТип баланса
commentstringКомментарий
typestringТип
creation_typestringТип создания
reason_typestringТип причины
reasonstringПричина
updated_atstringОбновлено
created_atstringСоздано
statusstringСтатус
balanceintegerБаланс
creator_idintegerСоздатель
idintegerID
companyobjectКомпания
company.idintegerID
company.parent_idnullРодитель
company.partner_idintegerПартнёр
company.district_idintegerРайон
company.industry_idintegerСфера деятельности
company.namestringНазвание
company.company_namestringКомпания
company.logoobjectЛоготип
company.logo.originalobject
company.logo.original.rawstring
company.logo.original.webpstring
company.logo.widen_25object
company.logo.widen_25.rawstring
company.logo.widen_25.webpstring
company.logo.widen_100object
company.logo.widen_100.rawstring
company.logo.widen_100.webpstring
company.logo.widen_500object
company.logo.widen_500.rawstring
company.logo.widen_500.webpstring
company.innstringИНН
company.mfostringМФО
company.addressstringАдрес
company.latitudenullШирота
company.longitudenullДолгота
company.commentstringКомментарий
company.telegram_phonestringТелефон в Telegram
company.director_full_namestringФИО директора
company.bankstringБанк
company.payment_accountstringРасчётный счёт
company.agreement_numberstringНомер договора
company.agreement_datenull
company.atmos_terminal_idintegerID терминала в Atmos
company.uniaccess_auto_payment_credit_overdue_daysinteger
company.uniaccess_branch_idintegerBranch ID в Uniaccess
company.field_of_activitystringНаправление
company.vat_percentstringНДС (%)
company.is_using_new_my_uzcard_auto_payment_by_pinflbooleanИспользует новый метод MyUzcard для автосписания по ПИНФЛ
company.bonus_entry_periodintegerПериод учёта бонусов (в месяцах)
company.abc_segment_ainteger
company.abc_segment_binteger
company.abc_segment_cinteger
company.is_pos_window_enabledboolean
company.cashbox_shift_settingsobject
company.cashbox_shift_settings.is_enabledbooleanВключено
company.has_bank_payment_typeboolean
company.is_ican_turned_onbooleanICAN включён
company.is_partner_turned_onbooleanПартнёр включён
company.created_atstringСоздано
company.updated_atstringОбновлено
company.is_deletedboolean
company.balanceobjectБаланс
company.balance.mainintegerОсновной
company.balance.smsintegerSMS
company.balance.pochtaintegerПочта
company.balance.imeistringIMEI
company.balance.aniq_scorestring
company.balance.subscriptioninteger
json
{
    "company_id": 1,
    "payment_type": "bank",
    "amount": 1000,
    "balance_type": "main",
    "comment": "Comment 4",
    "type": "income",
    "creation_type": "manualy",
    "reason_type": "common_refill",
    "reason": "Пополнение баланса",
    "updated_at": "2026-09-30 12:49:54",
    "created_at": "2026-09-30 12:49:54",
    "status": "completed",
    "balance": 2000,
    "creator_id": 1,
    "id": 126,
    "company": {
        "id": 1,
        "parent_id": null,
        "partner_id": 1,
        "district_id": 1,
        "industry_id": 1,
        "name": "Company 1",
        "company_name": "Company 1",
        "logo": {
            "original": {
                "raw": "https://api.wasyt.uz/test_data/images/1.png",
                "webp": "https://api.wasyt.uz/storage/thumbs/original/6a21a10b2d2ed8f4573f3842b10dc1df1778568717.webp"
            },
            "widen_25": {
                "raw": "https://api.wasyt.uz/storage/thumbs/widen/25/6a21a10b2d2ed8f4573f3842b10dc1df1778568717.png",
                "webp": "https://api.wasyt.uz/storage/thumbs/widen/25/6a21a10b2d2ed8f4573f3842b10dc1df1778568717.webp"
            },
            "widen_100": {
                "raw": "https://api.wasyt.uz/storage/thumbs/widen/100/6a21a10b2d2ed8f4573f3842b10dc1df1778568717.png",
                "webp": "https://api.wasyt.uz/storage/thumbs/widen/100/6a21a10b2d2ed8f4573f3842b10dc1df1778568717.webp"
            },
            "widen_500": {
                "raw": "https://api.wasyt.uz/storage/thumbs/widen/500/6a21a10b2d2ed8f4573f3842b10dc1df1778568717.png",
                "webp": "https://api.wasyt.uz/storage/thumbs/widen/500/6a21a10b2d2ed8f4573f3842b10dc1df1778568717.webp"
            }
        },
        "inn": "000000001",
        "mfo": "00001",
        "address": "Address 1",
        "latitude": null,
        "longitude": null,
        "comment": "Comment 1",
        "telegram_phone": "998000000001",
        "director_full_name": "Director 1",
        "bank": "Bank 1",
        "payment_account": "00000000000000000001",
        "agreement_number": "001/2026",
        "agreement_date": null,
        "atmos_terminal_id": 97007302,
        "uniaccess_auto_payment_credit_overdue_days": 3,
        "uniaccess_branch_id": 1,
        "field_of_activity": "trading",
        "vat_percent": "12.00",
        "is_using_new_my_uzcard_auto_payment_by_pinfl": true,
        "bonus_entry_period": 12,
        "abc_segment_a": 75,
        "abc_segment_b": 15,
        "abc_segment_c": 10,
        "is_pos_window_enabled": true,
        "cashbox_shift_settings": {
            "is_enabled": true
        },
        "has_bank_payment_type": false,
        "is_ican_turned_on": true,
        "is_partner_turned_on": false,
        "created_at": "2026-09-30 12:47:58",
        "updated_at": "2026-09-30 12:49:04",
        "is_deleted": false,
        "balance": {
            "main": 2000,
            "sms": 2000,
            "pochta": 3000,
            "imei": "10000000000.00",
            "aniq_score": "10000000000.00",
            "subscription": 0
        }
    }
}

Пример ошибки · 422 ​

json
{
    "message": "Допустимые значения для Тип оплаты: bank, card, cash, discount, my_uzcard, terminal.",
    "errors": {
        "payment_type": [
            "Допустимые значения для Тип оплаты: bank, card, cash, discount, my_uzcard, terminal."
        ]
    }
}

Отменить транзакцию ​

PATCH/admin/company/transaction/{model}/cancel

Переводит транзакцию в canceled и откатывает её сумму с баланса компании. Отменить можно только завершённый (completed) приход и только если сумма не выше настройки cancel_transaction_amount_limit; иначе — 400. Оплата через My Uzcard возвращается на карту.

Из формы (multipart/form-data) метод PATCH отправляется как POST с параметром ?_method=PATCH.

Заголовки ​

ЗаголовокЗначениеОписание
AuthorizationBearer {token}Токен из POST /common/auth/login
Acceptapplication/jsonОтвет в JSON
Accept-LanguageruЯзык сообщений и названий: ru, uz, oz

Параметры пути ​

ПараметрОписание
modelID записи

Тело запроса ​

ПолеТипОбязательноОписание
commentstringНетКомментарий. Макс. 1000 символов
json
{
    "comment": "Cancel comment 1"
}
bash
curl -X PATCH "https://api.wasyt.uz/admin/company/transaction/1/cancel" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"comment":"Cancel comment 1"}'

Ответ · 200 ​

Поля ответа
ПолеТипОписание
messagestringСообщение
json
{
    "message": "Success"
}

Список транзакций ​

GET/admin/company/transaction

Постраничный список транзакций компаний, доступных администратору, без компаний партнёров. Незавершённые попытки оплаты тарифа и списания с кошелька подписки скрыты. total_status_completed — суммы завершённых транзакций по типам для текущей выборки.

Заголовки ​

ЗаголовокЗначениеОписание
AuthorizationBearer {token}Токен из POST /common/auth/login
Acceptapplication/jsonОтвет в JSON
Accept-LanguageruЯзык сообщений и названий: ru, uz, oz

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

ПараметрОписание
filter[id]ID — точное значение
filter[creator_id]Создатель — точное значение
filter[company_id]Компания — одно значение или список filter[company_id][]
filter[type]Тип — точное значение
filter[creation_type]Тип создания — точное значение
filter[payment_type]Тип оплаты — одно значение или список filter[payment_type][]
filter[balance_type]Тип баланса — точное значение
filter[reason_type]Тип причины — одно значение или список filter[reason_type][]
filter[status]Статус — одно значение или список filter[status][]
filter[created_at]Создано — период: [0] — с, [1] — по (Y-m-d)
filter[company.is_ican_turned_on]ICAN включён — точное значение
sort[]Сортировка, - — по убыванию: id, -id
with[]Подгрузить связи: creator.profile, company
pageНомер страницы, с 1
page-sizeЗаписей на странице, не больше 20
http
GET /admin/company/transaction?filter[id]=1&filter[creator_id]=1&filter[company_id][0]=1&filter[company_id][1]=2&filter[type]=income&filter[creation_type]=manualy&filter[payment_type][0]=bank&filter[payment_type][1]=card&filter[balance_type]=main&filter[reason_type][0]=manually_advertising&filter[reason_type][1]=common_refill&filter[status][0]=completed&filter[status][1]=canceled&filter[created_at][0]=2026-09-29&filter[created_at][1]=2026-09-30&filter[company.is_ican_turned_on]=1

Ответ · 200 ​

Постраничный ответ: записи в data[], пагинация в links и meta.

Поля ответа
ПолеТипОписание
dataarrayДанные
json
{
    "data": [],
    "links": {
        "first": "https://api.wasyt.uz/admin/company/transaction?page=1",
        "last": "https://api.wasyt.uz/admin/company/transaction?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "from": null,
        "last_page": 1,
        "links": [],
        "path": "https://api.wasyt.uz/admin/company/transaction",
        "per_page": 20,
        "to": null,
        "total": 0
    },
    "total_status_completed": []
}

Карточка транзакции ​

GET/admin/company/transaction/{model}

Возвращает транзакцию компании, доступной администратору.

Заголовки ​

ЗаголовокЗначениеОписание
AuthorizationBearer {token}Токен из POST /common/auth/login
Acceptapplication/jsonОтвет в JSON
Accept-LanguageruЯзык сообщений и названий: ru, uz, oz

Параметры пути ​

ПараметрОписание
modelID записи

Ответ · 200 ​

Поля ответа
ПолеТипОписание
idintegerID
creator_idintegerСоздатель
company_idintegerКомпания
typestringТип
creation_typestringТип создания
payment_typestringТип оплаты
amountintegerСумма
balance_typestringТип баланса
balanceintegerБаланс
reason_typestringТип причины
reason_paramsarray
reasonstringПричина
commentnullКомментарий
statusstringСтатус
transaction_idnullТранзакция
utrnonull
created_atstringСоздано
updated_atstringОбновлено
json
{
    "id": 1,
    "creator_id": 1,
    "company_id": 1,
    "type": "income",
    "creation_type": "manualy",
    "payment_type": "bank",
    "amount": 1000,
    "balance_type": "main",
    "balance": 2000,
    "reason_type": "manually_advertising",
    "reason_params": [],
    "reason": "Reason 1",
    "comment": null,
    "status": "completed",
    "transaction_id": null,
    "utrno": null,
    "created_at": "2026-09-30 12:47:58",
    "updated_at": "2026-09-30 12:47:58"
}