Kabinet

pay.farik.uz

Obuna

Telegram ID—

Ta'rif—

Amal qiladi—

Limitdan foydalanish

Limit oshirish

+1 kalit +1 karta

Tugma botni ochadi — to'lovdan keyin slot avtomatik qo'shiladi.

API kalitlar

Yangi kalit yaratish

Har bir loyiha uchun alohida kalit tavsiya etiladi.

Loyiha nomi

Mening kartalarim

Karta ulash

Karta darhol faollashadi — to'lovlar avtomatik tasdiqlanadi.

Karta turi Karta raqami (16 xona) Ega ismi (chekda chiqadi) Nom (o'zingiz uchun, ixtiyoriy)

Qo'llanma

API kalit yarating va kartangizni ulang.

Mijoz to'lov qilmoqchi bo'lsa — botga /api orqali invoice yarating.

Bot unikal summa + kartangizni qaytaradi — mijoz aynan shu summani o'tkazadi.

Bank SMS'i kelishi bilan bot to'lovni avtomatik tasdiqlaydi.

Avtomatik: bot serveringizga callback POST yuboradi — mahsulotni bering. Zaxira: invoice.status orqali tekshirish.

Barcha manzillar

Kabinethttps://pay.farik.uz/

Bothttps://t.me/Aqilchabot

API so'rovBot chatiga /api {"method":"...","key":"aqpay_..."}

CallbackSizning serveringiz (har kalitga alohida)

Callback — serveringizga avtomatik xabar

Har bir kalitga Callback URL biriktiriladi (Kalitlar bo'limi → Sozlash). To'lov tasdiqlanishi bilan bot shu URL'ga POST yuboradi:

{"event":"invoice.paid","order_id":"API-...","amount":25000,"unique_amount":25010,"external_ref":"buyurtma-123","card_last4":"1234","paid_at":"2026-09-26 15:30:00"}

Sarlavha: X-AqPay-Secret (secret o'rnatgan bo'lsangiz). Server 2xx qaytarsa — yetkazildi.

PHP qabul qiluvchi (namuna):

$raw = file_get_contents('php://input');
$d = json_decode($raw, true);
$secret = $_SERVER['HTTP_X_AQPAY_SECRET'] ?? '';
if ($secret !== 'maxfiy-so-z-123') { http_response_code(403); exit; }
if (($d['event'] ?? '') === 'invoice.paid') {
    // $d['external_ref'] bo'yicha buyurtmani toping
    // va mahsulotni bering (status=paid)
    file_put_contents('paid.log', $raw . PHP_EOL, FILE_APPEND);
}
http_response_code(200);

Xavfsizlik: secret tekshiring + muhim to'lovlarda invoice.status orqali qayta tasdiqlang.

So'rov yuborish

Botning shaxsiy chatiga (o'z akkauntingizdan) shunday xabar yuboring:

/api {"method":"invoice.create","key":"aqpay_...","amount":25000}

Bot JSON javob qaytaradi. Kalit o'zi autentifikatsiya — xabar qaysi akkauntdan kelgani muhim emas.

Metodlar

invoice.create — invoice yaratish (1 000 – 100 000 000 so'm):

{"method":"invoice.create","key":"aqpay_...","amount":25000,"external_ref":"buyurtma-123"}

invoice.status — holat: pending / success / expired / cancelled

{"method":"invoice.status","key":"aqpay_...","order_id":"API-..."}

invoice.cancel — bekor qilish · invoices — ro'yxat · plans — bot tariflari.

Muhim qoidalar

Mijoz exact unique_amount ni yuborishi shart.
Invoice 7 kun yashaydi; eskirgani expired bo'ladi.
Kalitni begonalarga bermang — tarqalsa, o'chirib yangisini yarating.
Avto-tasdiq: Biznes hisobni botga ulang yoki chekni botga forward qiling.
Karta SMS xabarnomasi yoqilgan bo'lsin.