Oflayn do‘konlar uchun integratsiya

Integratsiya rejasi

  1. Oflayn do‘koningiz joylashgan hududda mobil internet barqaror ishlashiga ishonch hosil qiling, shunda mijoz to‘lov sahifasiga o‘ta oladi.

  2. Shaxsiy kabinetda ariza yuboring va test muhitining faollashtirilgani haqida xatni kuting.

  3. Do‘kon backend qismida /orders metodi orqali to‘lov parametrlarini uzatishni sozlang:

    Parametrlar namunasi
    Parametr Tavsif
    availablePaymentMethods Mijoz uchun mavjud to‘lov usullari
    cart Mahsulotlar savatining xususiyatlari, jumladan mahsulot kodi va nomi
    managerId Sotuvchi kodini belgilaydi
    branchId Do‘kon kodini belgilaydi

  4. Xizmat ishlashini test muhitida tekshiring:

    1. Sahifaning yuqori o‘ng burchagidagi Settings bo‘limida Test dataopsiyasini yoqing.
    2. Agar Yandex Split Merchant API orqali bildirishnoma yuborishini istasangiz, Callback URL Test maydonini to‘ldiring.
    3. Xabarlarni dekodlashni sozlang.
    4. Test oʻtkazing.

  5. Xizmat ulanganligi haqida bildirishnoma olgandan so‘ng, muhitni test rejimidan ishchi rejimga o‘tkazing:

    1. Settings bo‘limida test sozlamalarini yashiring va Test dataopsiyasini faolsizlantiring.
    2. Callback URL maydonini to‘ldiring.
    3. API kalitini chiqaring.

  6. Fiskallashtirishni unutmang. Endi siz to‘lovlarni qabul qilishga tayyorsiz.

Oflayn do‘konlar uchun to‘lov usullari va metodlari

Toʻlov usullari

Doʻkoningiz xaridorlari xaridlarni Yandex ID hisobiga biriktirilgan istalgan bank kartasi bilan toʻlashlari mumkin.

To‘lov metodlari

Yandex Split xizmati ulangan oflayn do‘konda to‘lovni to‘g‘ridan-to‘g‘ri QR orqali amalga oshirish mumkin.

Bevosita QR – foydalanuvchi dinamik QR kodni skanerlaydigan to‘lov turi bo‘lib, u sotuv nuqtasidagi turli joylarda joylashtirilishi mumkin: monitorlarda, menejer telefonlari ekranida, chekda, narx yorliqlarida va boshqa tashuvchilarda.

Xarid uchun to‘lov bir nechta bosqichdan iborat.

  1. Bevosita QR kod yaratish.

    1. Foydalanuvchi sotib olmoqchi bo‘lgan mahsulotlarni tanlaydi.

    2. Sotuvchi kassa dasturida tovar savatini shakllantiradi.

      Foydalanuvchi mahsulotlar uchun to‘lashga tayyor bo‘lganda, sotuvchi to‘lov turini tanlaydi va buyurtma yaratish tugmasini bosadi.

    3. Hamkor tomonidagi toʻlov tugmasi bosilgandan soʻng, mahsulot savatchasi bloklanadi va buyurtma yaratiladi, u doʻkon zaxirasi orqali /orders usuli yordamida Yandex Splitga uzatiladi. Javob sifatida foydalanuvchi to‘lovni amalga oshirishi uchun Yandex Split to‘lov shakliga havola qaytariladi.

      Diqqat

      /orders metodida sotuvchi kodi managerId va to‘lov amalga oshirilayotgan do‘kon kodi branchIdni uzatish zarur. Shuningdek, sotuvchi ushbu buyurtma uchun mavjud to‘lov usullarini ham uzatadi.

    4. Olingan to‘lov havolasi asosida QR kod generatsiya qilish va uni foydalanuvchi telefon kamerasi yoki Yandex Split ilovasi orqali skanerlashi mumkin bo‘lgan tashuvchilardan birida ko‘rsatish kerak:

      • ekranlar va monitorlarda;
      • chekda yoki QR kod chop etilgan qog‘ozda.

      Havoladan QR kod yaratish uchun uchinchi tomon servisidan foydalanish mumkin. Masalan, QR Code Generator servisidan foydalanish mumkin.

  2. Foydalanuvchi tomonidan to‘lov.

    1. Foydalanuvchi sotuvchi yaratgan QR kodni telefon kamerasi yoki Yandex Split ilovasi orqali skanerlaydi:

      • Agar foydalanuvchida Yandex Split ilovasi o‘rnatilmagan bo‘lsa, havola orqali o‘tilganda yoki QR kod skanerlanganda to‘lov jarayoni brauzerda amalga oshiriladi.
      • Agar foydalanuvchida Yandex Split ilovasi o‘rnatilgan bo‘lsa, havola orqali o‘tilganda yoki QR kod skanerlanganda to‘lov jarayoni ilova ichida amalga oshiriladi.

    2. Foydalanuvchi Yandex Split to‘lov shakliga o‘tadi – unda savat va to‘lanishi kerak bo‘lgan summa ko‘rsatiladi.

    3. Foydalanuvchi usulni tanlaydi (qismlarga boʻlib) va toʻlov tugmasini bosadi.

      Bo‘lib toʻlashda foydalanuvchi toʻlovlar sonini tanlaydi va Yandex'da saqlangan bank kartasi orqali birinchi toʻlovni amalga oshiradi.

  3. Toʻlovni amalga oshirish.

    1. Yandex Split tanlagan kartadan pul mablagʻlarini yechib, toʻlovni amalga oshiradi.

    2. Yandex Split Callback URL sozlangan bo‘lsa, /webhook chaqiruvi orqali do‘kon backendini toʻlov holati haqida xabardor qiladi.

      Doʻkon backend'i /orders/{order_id} soʻrovi orqali buyurtma holatini mustaqil ravishda soʻrab olishi mumkin.

      Toʻlov holatlari

      • PENDING – to‘lov hali jarayonda, to‘lov holatini keyinroq so‘rash kerak. Bu holat bildirishnomada yuborilmaydi.

        Sotuvchi quyidagi holatlardan birida /orders/{orderId}/rollbackusuli yordamida toʻlovni toʻxtatishi mumkin:

        • foydalanuvchi xariddan voz kechsa;
        • xaridni bekor qilish zarurati yuzaga kelsa;
        • kassa dasturi toʻxtab qolsa.

      • FAILED – to‘lov muvaffaqiyatsiz yakunlandi. Yakuniy muvaffaqiyatsiz holat.

      • CAPTURED – to‘lov muvaffaqiyatli amalga oshirildi, chekni chop etish mumkin. Yakuniy muvaffaqiyatli holat.

    3. Chekni kassa dasturi orqali chop etish zarur. Xarid muvaffaqiyatli amalga oshirildi.

Keyingi ish kunida xaridning toʻliq qiymatiga teng mablagʻ oflayn doʻkon tashkilotining hisob raqamiga oʻtkaziladi.

To‘lov jarayoni sxemasi

Qaytarishni amalga oshirish

Qaytarishni ikki usulda amalga oshirish mumkin:

  • shaxsiy kabinetdagi Payments bo‘limida;
  • API orqali so‘rov yuborish yordamida.
Avvalgisi
Toʻlovlarni qaytarish
Keyingisi
Test qilish