Ishni boshlash
Ushbu hujjat XonSaroyPay ning onlayn to‘lovlarni qabul qilish mahsulotlarini va ular bilan integratsiya tartibini tavsiflaydi. O‘zingizga mos stsenariyni tanlang — har bir bo‘lim mustaqil.
Integratsiya stsenariylari
Stsenariy | Siz nima qilasiz | Bo‘lim |
|---|---|---|
Saytdagi «To‘lash» tugmasi | Havola yoki HTML-forma joylashtirasiz, to‘lov formasini biz ko‘rsatamiz | Internet-ekvayering bilan integratsiya |
O‘zingizning to‘lov sahifangiz | Freymning REST metodlarini chaqirasiz: buyurtma yaratish, yechish, OTP orqali tasdiqlash | Checkout API |
Kartalarni saqlash va mijoz ishtirokisiz yechish | Kartani tokenlashtirasiz va token bo‘yicha, jumladan muntazam ravishda yechasiz | Acquiring API |
Sizning billingingizdagi hisoblarni to‘lash | JSON-RPC metodlarini o‘zingizda amalga oshirasiz, ularni biz chaqiramiz | Billing API integratsiyasi uchun talablar |
Nimadan boshlash kerak
Ulanishni menejer 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. Ularni o‘zingizda saqlang: 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 sizning serveringizda saqlanadi. SECRET_KEY ni frontend va mobil ilovalar kodiga joylashtirmang.