Shartnoma bo‘yicha to‘lovlar

Kredit sotuvi bo‘yicha to‘lovlar va pul qaytarishlar: ICAN ning har bir to‘lovi sotuv tranzaksiyasi va kassa harakatiga aylanadi. Shu yerda «Pulni qaytarish» oynasi uchun ma’lumotlar ham bor.

Metod	Manzil	Vazifasi
POST	/external/credit/trade-sale-transaction/create	Shartnoma bo‘yicha to‘lov o‘tkazish
POST	/external/credit/trade-sale-transaction/refund-information	To‘lovni qaytarish ma’lumotlari

Shartnoma bo‘yicha to‘lov o‘tkazish

POST/external/credit/trade-sale-transaction/create

sale_id kredit sotuvi bo‘yicha to‘lov (income) yoki qaytarish (outcome) yozadi va kassani o‘zgartiradi: cashbox_id siz — sotuv kassasi, auto_payment* avtoyechimlari — kompaniyaning asosiy kassasi; system/discount kassa harakatisiz to‘lovga hisoblanadi. credit_transaction_id kompaniya bo‘yicha bir marta qabul qilinadi (takror — 422). So‘ng sotuv holati qayta hisoblanadi: to‘langani sold_amount dan kam bo‘lmasa completed, aks holda in_progress (canceled saqlanadi); javobdagi id — qaytarish uchun payment_id.

Sarlavhalar (headers)

Sarlavha	Qiymat	Tavsif
External-System-Secret-Key	{external_system_secret_key}	Tashqi tizim maxfiy kaliti
Company-Wasyt-Uuid	{company_wasyt_uuid}	Kompaniya wasyt UUID si bo‘yicha (yoki Company-Ican-Uuid)
Accept	application/json	Javob JSON da
Accept-Language	ru	Xabarlar va nomlar tili: ru, uz, oz

So‘rov tanasi

Maydon	Turi	Majburiy	Tavsif
sale_id	integer	Ha	Kredit sotuvi ID si (trade-sale/create javobidagi id)
cashbox_id	integer	Yo‘q	Kassa; bo‘sh bo‘lsa — sotuv kassasi
type	string	Ha	Turi. Mumkin qiymatlar: income, outcome
payment_type	string	Ha	Wasyt yoki ICAN to‘lov turi (terminal, mib, blacklist, auto_payment* → bank; card_* → card; discount → system); debt taqiqlangan. Mumkin qiymatlar: bank, card, cash, bonus, system
amount	number	Ha	Summa. Verguldan keyin 2 tagacha raqam. Kamida 0.01. 999999999999.99 dan oshmasin
credit_transaction_id	integer	Ha	Kredit tizimidagi to‘lov ID si, kompaniyada yagona
credit_status	string	Ha	Shartnoma holati; sotuv holatlaridan bo‘lmagan qiymat in_progress ga almashtiriladi
comment	string	Yo‘q	Izoh. Maks. 1000 belgi

JSON

{
    "sale_id": 1,
    "type": "income",
    "payment_type": "auto_payment_uniaccess",
    "amount": 1000,
    "credit_transaction_id": 1,
    "credit_status": "completed"
}

cURL

curl -X POST "https://api.wasyt.uz/external/credit/trade-sale-transaction/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 '{"sale_id":1,"type":"income","payment_type":"auto_payment_uniaccess","amount":1000,"credit_transaction_id":1,"credit_status":"completed"}'

Javob · 200

Javob maydonlari

Maydon	Turi	Tavsif
sale_id	integer	Sotish
type	string	Turi
payment_type	string	To'lov turi
amount	integer	Summa
credit_transaction_id	integer
cashbox_id	integer	Kassa
created_at	string	Yaratilgan
company_id	integer	Kompaniya
id	integer	ID
sale	object
sale.id	integer	ID
sale.creator_id	integer	Yaratuvchi
sale.company_id	integer	Kompaniya
sale.cashbox_id	integer	Kassa
sale.stock_id	integer	Ombor
sale.client_id	integer	Mijoz
sale.exchange_of_sale_id	null
sale.currency	string	Valyuta
sale.purchased_amount	integer
sale.sold_amount	integer	Sotuvdagi summa
sale.returned_amount	integer	Qaytarilgan summa
sale.status	string	Status
sale.source_type	string	Manba
sale.source_data	array
sale.code	string	Kod
sale.created_at	string	Yaratilgan
sale.updated_at	string	Yangilangan

{
    "sale_id": 1,
    "type": "income",
    "payment_type": "bank",
    "amount": 1000,
    "credit_transaction_id": 1,
    "cashbox_id": 16,
    "created_at": "2026-09-30 12:25:54",
    "company_id": 1,
    "id": 228,
    "sale": {
        "id": 1,
        "creator_id": 2,
        "company_id": 1,
        "cashbox_id": 1,
        "stock_id": 1,
        "client_id": 1,
        "exchange_of_sale_id": null,
        "currency": "uzs",
        "purchased_amount": 500,
        "sold_amount": 4900,
        "returned_amount": 0,
        "status": "completed",
        "source_type": "wasyt",
        "source_data": [],
        "code": "w-1-1",
        "created_at": "2020-01-01 10:00:00",
        "updated_at": "2026-09-30 12:25:54"
    }
}

To‘lovni qaytarish ma’lumotlari

POST/external/credit/trade-sale-transaction/refund-information

Kredit sotuvi yoki tashqi kreditning payment_id to‘lovi bo‘yicha «Pulni qaytarish» oynasi ma’lumotlari (boshqa to‘lov — 422): pul tushgan kassa, currency, paid_amount (aynan shu to‘lov summasi) va balances[] — shu kassaning to‘lov valyutasidagi cash, card, bank bo‘yicha nolga teng bo‘lmagan qoldiqlari. Hech narsani o‘zgartirmaydi: qaytarishni kredit tizimi o‘zi o‘tkazadi.

Sarlavhalar (headers)

Sarlavha	Qiymat	Tavsif
External-System-Secret-Key	{external_system_secret_key}	Tashqi tizim maxfiy kaliti
Company-Wasyt-Uuid	{company_wasyt_uuid}	Kompaniya wasyt UUID si bo‘yicha (yoki Company-Ican-Uuid)
Accept	application/json	Javob JSON da
Accept-Language	ru	Xabarlar va nomlar tili: ru, uz, oz

So‘rov tanasi

Maydon	Turi	Majburiy	Tavsif
payment_id	integer	Ha	Wasyt kirim to‘lovi ID si (trade-sale-transaction/create yoki external-credit-payment/create javobidagi id). Mavjud yozuv ID si

JSON

{
    "payment_id": 1
}

cURL

curl -X POST "https://api.wasyt.uz/external/credit/trade-sale-transaction/refund-information" \
  -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 '{"payment_id":1}'

Javob · 200

Javob maydonlari

Maydon	Turi	Tavsif
cashbox	object
cashbox.id	integer	ID
cashbox.name	string	Nomlanish
cashbox.type	string	Turi
currency	string	Valyuta
paid_amount	integer
balances	object[]
balances[].id	integer	ID
balances[].payment_type	string	To'lov turi
balances[].label	string
balances[].currency	string	Valyuta
balances[].amount	integer	Summa

{
    "cashbox": {
        "id": 1,
        "name": "Cashbox 1",
        "type": "sale"
    },
    "currency": "uzs",
    "paid_amount": 4000,
    "balances": [
        {
            "id": 1,
            "payment_type": "cash",
            "label": "Наличные",
            "currency": "uzs",
            "amount": 1000
        },
        {
            "id": 24,
            "payment_type": "card",
            "label": "Безналичные",
            "currency": "uzs",
            "amount": 3000
        }
    ]
}