Payments
Chekdagi to‘lovlarni tavsiflovchi model.
To‘lovlar massivining har bir elementi obyekt bo‘lishi kerak; null elementlarga ruxsat berilmaydi. To‘lov turi bo‘yicha jami summa manfiy bo‘lmasa ham, har bir alohida to‘lov summasi manfiy bo‘lishi mumkin emas. Noto‘g‘ri to‘lovlar 701003 xatosi bilan rad etiladi. Dastlabki tekshirish metodlarida ignore_payments = true bo‘lsa, to‘lovlarni tekshirish o‘tkazib yuboriladi.
| Nomi | Ma’lumot turi | Majburiyligi | Parametr tavsifi |
|---|---|---|---|
| type | int64 | Majburiy | REGOS: VCR dagi to‘lov turi: 1 - naqd, 2 - bank kartasi / to‘lov tizimi |
| value | int64 | payment_id to‘ldirilmagan bo‘lsa majburiy; Receipt.Refund da doim majburiy |
To‘lov summasi, tiyinlarda. 0 dan kichik bo‘lishi mumkin emas |
| payment_id | string | Ixtiyoriy | Payment.Create yoki Payment.Start orqali REGOS: VCR da yaratilgan to‘lov ID si |
| card_type | int32 | Ixtiyoriy | Karta turi: 1 - korporativ, 2 - shaxsiy, 3 - ijtimoiy. Sukut bo‘yicha: 2 |
| card_number | string | To‘lov Payment.Create yoki Payment.Start orqali yaratilmagan bo‘lsa, type = 2 va card_type = 3 da majburiy |
Xaridorning ijtimoiy kartasi raqami. 16 ta raqam yuboriladi; javob va chop etishda niqoblangan qiymat ishlatiladi |
| RRN | string | Ixtiyoriy | Mavjud bo‘lsa, to‘lov protsessingi tranzaksiyasi identifikatori |
Naqd to‘lovda (type = 1) type va value majburiy; payment_id maydonini yuborish mumkin emas.
Chekni OFD orqali tekshirish yoqilganida, kamida bitta tovar uchun naqd pul taqiqlangan bo‘lsa yoki bir MXIK kodli pozitsiyalarning jami qiymati naqd to‘lov chegarasidan oshsa, butun chekdagi naqd summa nolga teng bo‘lishi kerak. Bu qoida sotuv, qaytarish, avans va kredit cheklariga tegishli. Naqd summasi musbat bo‘lgan aralash to‘lov 701003 xatosi bilan rad etiladi. Summa chegaraga aynan teng bo‘lsa, chegara cheklovi ishga tushmaydi.
Payment.Create yoki Payment.Start orqali to‘lashda mahalliy to‘lov id sini payment_id maydonida yuboring. Bunday to‘lov sotuv chekida faqat bir marta ishlatiladi.
Receipt.Sale da payment_id to‘ldirilgan bo‘lsa, REGOS: VCR yaratilgan to‘lov summasi va ma’lumotlaridan foydalanadi.
Receipt.Refund da payment_id pulni qaytarishni boshlamaydi. U chekni dastlabki integratsiyalangan to‘lovning allaqachon tasdiqlangan qaytarish operatsiyasi bilan bog‘laydi; value ushbu operatsiya summasiga teng bo‘lishi kerak. Naqd pul yoki boshqa usul orqali qaytarishda bu maydon yuborilmaydi.
UzQR to‘lovi kartali naqd pulsiz to‘lov sifatida ro‘yxatdan o‘tkaziladi; UzQR to‘lov identifikatori RRN sifatida ishlatiladi.
QR-to‘lovlarda chekni yopishdan oldin Payment.Get status = 3 qaytarganiga ishonch hosil qiling.
Muhim: Bitta chekda type = 2 bo‘lgan bittadan ortiq to‘lov obyektini yuborish mumkin emas.