To'lov API Hujjatlari

Ushbu API orqali to'lov operatsiyalarini boshqarishingiz mumkin.

Asosiy URL

API endpointi: https://payment.api-link.uz/api

Autentifikatsiya

Barcha so'rovlar uchun shop_id va shop_key kerak bo'ladi.

Endpointlar

Yangi To'lov Yaratish

POST ?method=create

Tavsif

Yangi to'lov buyurtmasini yaratish.

Parametrlar

Parametr Turi Tavsif
shop_id number Do'kon identifikatori
shop_key string Do'kon maxfiy kaliti
amount number To'lov miqdori

Muvaffaqiyatli Javob

{
    "status": "success",
    "order": "owld1002",
    "insert_id": 123,
    "data": {
        "amount": 10000,
        "shop_id": "shop123",
        "shop_key": "key456"
    }
}

Xato Javoblari

{
    "status": "error",
    "message": "Do'kon topilmadi!"
}

To'lov Statusini Tekshirish

GET ?method=check&order=ORDER_CODE

Tavsif

Buyurtma statusini tekshirish.

Parametrlar

Parametr Turi Tavsif
order string Buyurtma kodi

Javob

{
    "status": "success",
    "order": "owld1002",
    "data": {
        "amount": 10000,
        "status": "pending",
        "date": "2023-05-15"
    }
}

To'lovni Bekor Qilish

POST ?method=cancel

Tavsif

To'lovni bekor qilish (faqat "pending" statusidagi to'lovlar uchun).

Parametrlar

Parametr Turi Tavsif
order string Bekor qilinadigan buyurtma kodi

Javob

{
    "status": "success",
    "message": "Buyurtma muvaffaqiyatli bekor qilindi.",
    "order": "owld1002"
}

Do'kon Ma'lumotlari

GET ?shop_id=ID&shop_key=KEY

Tavsif

Do'kon haqida ma'lumot olish.

Javob

{
    "status": "success",
    "data": {
        "user_id": 123,
        "shop_id": "shop123",
        "shop_key": "key456",
        "shop_name": "Mening Do'konim",
        "shop_info": "Do'kon haqida ma'lumot",
        "phone": "998901234567",
        "status": "confirm",
        "month_status": "To'landi",
        "balance": 500000,
        "over_day": "0"
    }
}

Xatolik Kodlari

Xato Tavsif
Do'kon topilmadi! shop_id yoki shop_key noto'g'ri
Do'kon faol emas! Do'kon admin tomonidan faollashtirilmagan
Oylik to'lov qilinmagan! Do'kon oylik to'lovni amalga oshirmagan
Hisob ulanmagan! Do'konga telefon raqam biriktirilmagan

To'lov Statuslari

Eslatmalar