Ishni boshlash
Ushbu hujjat XonSaroyPay ning onlayn to‘lovlarni qabul qilish mahsulotlarini va ular bilan integratsiya tartibini tavsiflaydi. Mos stsenariyni tanlang — har bir bo‘lim mustaqil.
Integratsiya stsenariylari
Stsenariy | Merchant harakatlari | Bo‘lim |
|---|---|---|
Saytdagi «To‘lash» tugmasi | Havola yoki HTML-forma joylashtiriladi; to‘lov formasini XonSaroyPay ko‘rsatadi | Internet-ekvayering bilan integratsiya |
Merchantning o‘z to‘lov sahifasi | Freymning REST metodlarini chaqirasiz: buyurtma yaratish, yechish, OTP orqali tasdiqlash | Checkout API |
Kartalarni saqlash va mijoz ishtirokisiz yechish | Karta tokenlashtiriladi va token bo‘yicha, jumladan muntazam ravishda yechiladi | Acquiring API |
Merchant billingidagi hisoblarni to‘lash | Merchant JSON-RPC metodlarini o‘z tomonida amalga oshiradi; ularni XonSaroyPay chaqiradi | Billing API integratsiyasi uchun talablar |
Nimadan boshlash kerak
Ulanishni XonSaroyPay menejeri bilan kelishing va kirish rekvizitlarini oling: Service ID, SECRET_KEY, Acquiring API uchun esa Basic-avtorizatsiya login va paroli. Bu ma’lumotlar faqat ulanish paytida beriladi va mustaqil yaratilmaydi.
Ishlab chiqish va sozlashni STAGING stendida olib boring, jangovar konturga stsenariylarni tekshirgandan keyin ulaning.
Barcha murojaatlar faqat HTTPS orqali amalga oshiriladi. Barcha metodlarda summalar tiyinda uzatiladi: 1 UZS = 100 tiyin.
Umumiy qoidalar
Buyurtma va operatsiya identifikatorlari — UUID formatidagi satrlar. Ular merchant tomonida saqlanadi: solishtirish va bahsli holatlarni ko‘rib chiqish shular asosida amalga oshiriladi.
Operatsiyaning yakuniy holatini faqat to‘lov javobiga tayanib emas, holatni tekshirish so‘rovi orqali tasdiqlash kerak — ba’zi operatsiyalar asinxron yakunlanadi.
Kalitlar va parollar faqat merchant serverida saqlanadi. SECRET_KEY ni frontend va mobil ilovalar kodiga joylashtirmang.