Оплаты внешнего кредита

Оплаты по контрактам кредитной системы, у которых нет продажи в wasyt (заключены до подключения склада). Оплата хранится без sale_id, двигает кассу отдельным источником external_credit и в выручку продаж не попадает.

Метод	Адрес	Назначение
POST	/external/credit/external-credit-payment/create	Провести оплату внешнего кредита

Провести оплату внешнего кредита

POST/external/credit/external-credit-payment/create

Записывает оплату (income) или её возврат (outcome) по контракту без продажи в wasyt; credit_transaction_id принимается один раз на компанию. Касса: указанная, иначе касса сотрудника cashier_id, иначе главная касса компании; возврат требует payment_id прихода того же credit_id, не больше невозвращённой суммы и уходит в его валюте и с его кассы. paid_at проводит историческую оплату этой датой; id ответа кредитная система хранит как wasyt_payment_id.

Заголовки

Заголовок	Значение	Описание
External-System-Secret-Key	{external_system_secret_key}	Секретный ключ внешней системы
Company-Wasyt-Uuid	{company_wasyt_uuid}	Компания по её wasyt UUID (или Company-Ican-Uuid)
Accept	application/json	Ответ в JSON
Accept-Language	ru	Язык сообщений и названий: ru, uz, oz

Тело запроса

Поле	Тип	Обязательно	Описание
company_wasyt_uuid	string	Да	Wasyt UUID компании (отключённые тоже принимаются)
credit_id	integer	Да	ID контракта в кредитной системе
credit_number	string	Да	Номер контракта. Макс. 255 символов
client_full_name	string	Нет	ФИО клиента по контракту. Макс. 255 символов
client_phone	string	Нет	Телефон клиента. Макс. 255 символов
cashbox_id	integer	Нет	Касса этой компании; пусто — см. описание метода
cashier_id	integer	Нет	Директор или сотрудник компании (из records/seller), принявший оплату
type	string	Да	Тип. Допустимые значения: income, outcome
payment_type	string	Да	Тип оплаты wasyt или ICAN (terminal, mib, blacklist, auto_payment* → bank; card_* → card). Допустимые значения: bank, card, cash
currency	string	Нет	Валюта оплаты, по умолчанию uzs; для возврата берётся валюта возвращаемой оплаты. Допустимые значения: uzs, usd, eur, rub
amount	number	Да	Сумма. До 2 знаков после запятой. Не меньше 0.01. Не больше 999999999999.99
credit_transaction_id	integer	Да	ID оплаты в кредитной системе, уникален в компании
payment_id	integer	Нет	Для outcome: ID возвращаемого прихода (wasyt_payment_id)
paid_at	string (date)	Нет	Дата исторической оплаты; для возврата — не раньше возвращаемой оплаты. Формат Y-m-d H:i:s. Не позже now
comment	string	Нет	Комментарий. Макс. 1000 символов

JSON

{
    "company_wasyt_uuid": "wasyt-company-1",
    "credit_id": 500,
    "credit_number": "3000670244",
    "client_full_name": "Aliyev Vali",
    "client_phone": "998901234567",
    "cashbox_id": 1,
    "type": "income",
    "payment_type": "cash",
    "amount": 1000,
    "credit_transaction_id": 9001,
    "comment": "Comment 1"
}

cURL

curl -X POST "https://api.wasyt.uz/external/credit/external-credit-payment/create" \
  -H "Accept: application/json" \
  -H "Accept-Language: ru" \
  -H "External-System-Secret-Key: {external_system_secret_key}" \
  -H "Company-Ican-Uuid: ican-company-1" \
  -H "Content-Type: application/json" \
  -d '{"company_wasyt_uuid":"wasyt-company-1","credit_id":500,"credit_number":"3000670244","client_full_name":"Aliyev Vali","client_phone":"998901234567","cashbox_id":1,"type":"income","payment_type":"cash","amount":1000,"credit_transaction_id":9001,"comment":"Comment 1"}'

Ответ · 200

Поля ответа

Поле	Тип	Описание
cashbox_id	integer	Касса
type	string	Тип
payment_type	string	Тип оплаты
amount	integer	Сумма
credit_transaction_id	integer
comment	string	Комментарий
company_id	integer	Компания
source_type	string	Источник
source_data	object
source_data.id	integer	ID
source_data.number	string	Номер
source_data.currency	string	Валюта
source_data.client_full_name	string
source_data.client_phone	string
source_data.refunded_payment_id	null
source_data.is_historical	boolean
created_at	string	Создано
id	integer	ID
sale	null

{
    "cashbox_id": 1,
    "type": "income",
    "payment_type": "cash",
    "amount": 1000,
    "credit_transaction_id": 9001,
    "comment": "Comment 1",
    "company_id": 1,
    "source_type": "external_credit",
    "source_data": {
        "id": 500,
        "number": "3000670244",
        "currency": "uzs",
        "client_full_name": "Aliyev Vali",
        "client_phone": "998901234567",
        "refunded_payment_id": null,
        "is_historical": false
    },
    "created_at": "2026-09-30 12:25:37",
    "id": 197,
    "sale": null
}