Token bilan to‘lovni tasdiqlash

Token bank kartasi ma'lumotlarining raqamli ekvivalentidir to'lovlar va operatsiyalar xavfsizligini ta'minlash uchun foydalaniladi. Buning o'rniga haqiqiy karta ma'lumotlarini uzatish va saqlash (raqam, amal qilish muddati, CVV), tasodifiy to'plam bo'lgan noyob token ishlatiladi belgilar.

---

pay

• URL: https://secure.octo.uz/pay/{octo_payment_UUID}
• Method: POST
• Content-type: application/json

So'rovnoma

{
    "card_token": "token",       // Operatsiyani amalga oshirish uchun ishlatiladigan mijozning tokeni.
    "method": "uzcard",             // To'lov usuli. Ruxsat etilgan qiymatlar: bank_card, uzcard, humo
    "email": "client@mail.com"      // Foydalanuvchining elektron pochtasi.
}

---

Parametrlar tavsifi

Parametr	Turi	Majburiylik	Tavsif
card_token	string	Ha	Operatsiyani amalga oshirish uchun ishlatiladigan mijozning tokeni
method	string	Ha	To'lov usuli.
email	string	Ha	Foydalanuvchining elektron pochtasi.

---

Muvaffaqiyatli Javob

{
    "error": 0,        // Xato kodi: 0 xatolar yo'qligini anglatadi.
    "errMessage": "",  // Xato haqida xabar, agar xato bo'lmasa, bo'sh qoladi.
    "data": {
        "id": 5520,    // Operatsiyaning noyob identifikatori.
        "uuid": "04b7f6dd-4693-4afa-96e9-f42790413de7", // Operatsiyani identifikatsiya etish uchun UUID.
        "merchantId": 242, // Savdogarning identifikatori.
        "initialSum": 1000.00, // Dastlabki to'lov miqdori.
        "totalSum": 1000.00, // Umumiy to'lov miqdori.
        "currency": "UZS", // Valyuta.
        "description": "TEST_PAYMENT", // Operatsiya tavsifi.
        "status": "created", // Operatsiya holati.
        "redirectUrl": "https://pay2.octo.uz/uzcard/sms/04b7f6dd-4693-4afa-96e9-f42790413de7", // To'lov sahifasiga URL.
        "user": {
            "email": "client@mail.com", // Foydalanuvchining elektron pochtasi.
            "phone": "998901234567" // Foydalanuvchining telefon raqami.
        }
    }
}

---

Parametrlar tavsifi

Parametr	Turi	Majburiylik	Tavsif
error	int	Ha	Xato kodi (0 – xatolar yo'q).
errMessage	string	Yo'q	Xato haqida xabar.
data	object	Ha	Operatsiyaning batafsil ma'lumotlarini o'z ichiga oladi.
id	int	Ha	Operatsiyaning noyob identifikatori.
uuid	string	Ha	Operatsiyani identifikatsiya qilish uchun UUID.
merchantId	int	Ha	Savdogarning identifikatori.
initialSum	decimal	Ha	Dastlabki to'lov miqdori.
totalSum	decimal	Ha	Umumiy to'lov miqdori (o'z ichiga komissiyalarni olishi mumkin).
currency	string	Ha	Valyuta (masalan, UZS).
description	string	Ha	Operatsiyaning qisqacha ta'rifi.
status	string	Ha	Operatsiya holati (masalan, "created").
redirectUrl	string	Ha	To'lov sahifasiga qayta yo'naltirish uchun URL.
user.email	string	Yo'q	Foydalanuvchining elektron pochtasi.
user.phone	string	Yo'q	Foydalanuvchining telefon raqami.

---

Muvaffaqiyatsiz Javob

{
    "error": 2,                // Xato kodi.
    "errMessage": "Wrong secret", // Xato haqida xabar.
    "data": null               // Operatsiya haqida ma'lumot yo'q.
}

Parametrlar tavsifi

Parametr	Turi	Majburiylik	Tavsif
error	int	Ha	Xato kodi.
errMessage	string	Ha	Xato haqida xabar.
data	object	Yo'q	Operatsiya haqida batafsil ma'lumot.

---