Starex Pay

Starex Pay — to'lov sahifasi. Siz xaridorni buyurtma raqami va summasi bilan shu sahifaga yo'naltirasiz, u to'lov usulini tanlab to'laydi. To'lov tizimlari bilan ishlashni Starex Pay o'z zimmasiga oladi — sizga bitta havola yasash va ikkita endpoint yozish qoladi.

1. Umumiy

PAY_URL va SECRET_KEY Starex tomonidan beriladi; prepare va complete manzillarini siz Starex'ga berasiz.

Ma'lumot	Tavsif
`PAY_URL`	To'lov sahifasining bazaviy manzili
`SECRET_KEY`	Imzo uchun maxfiy kalit — faqat server tomonida ishlatiladi
`prepare` URL	Buyurtmani tekshirish endpointi
`complete` URL	To'lovni tasdiqlash endpointi

2. Ishlash sxemasi

yashil so'rovlar — siz yozadigan endpointlar; qolganini Starex Pay o'zi bajaradi.

3. To'lov havolasi

GET {PAY_URL}/checkout

Parametr	Tur	Tavsif
`order_id`	string	Sizning tizimingizdagi buyurtma raqami
`amount`	integer	To'lov summasi (tiyinda)
`sign`	string	Tekshiruv satri (SHA-256): `sha256(order_id + amount + SECRET_KEY)`

Xaridor shu havola bo'yicha to'lov usulini tanlaydi, to'lov tizimida to'laydi va natija sahifasiga qaytadi.

Havolani yasash

$sign = hash('sha256', $orderId . $amount . $secretKey);

$link = $payUrl . '/checkout?' . http_build_query([
    'order_id' => $orderId,
    'amount'   => $amount,
    'sign'     => $sign,
]);

header('Location: ' . $link);

const sign = crypto.createHash('sha256')
  .update(`${orderId}${amount}${secretKey}`).digest('hex');

const link = `${payUrl}/checkout?` + new URLSearchParams({
  order_id: orderId, amount: String(amount), sign,
});

res.redirect(link);

sign = hashlib.sha256(f"{order_id}{amount}{secret_key}".encode()).hexdigest()

link = f"{pay_url}/checkout?" + urlencode({
    "order_id": order_id, "amount": amount, "sign": sign,
})

Har bir to'lov uchun unikal order_id ishlating.
Havola 24 soat amal qiladi — keyin yangisini yasang.
To'langan buyurtma qayta to'lanmaydi — xaridorga to'lov holati ko'rsatiladi.

4. So'rovlar

Har ikki so'rov ham JSON tanasi bilan POST orqali yuboriladi. Javob HTTP 200 bo'lishi va 10 soniya ichida qaytishi shart.

Prepare

POST {SIZNING_PREPARE_URL}

{
  "ext_trans_id": 1042,
  "ext_payment_id": 3311,
  "order_id": "A-10245",
  "amount": 4500000,
  "action": 0,
  "sign_time": "2026-07-28 14:05:21",
  "sign_string": "9c2f...b81d"
}

Maydon	Tur	Tavsif
`ext_trans_id`	integer	Starex Pay tizimidagi to'lov raqami
`ext_payment_id`	integer	Starex Pay tizimidagi tranzaksiya raqami
`order_id`	string	Sizning tizimingizdagi buyurtma raqami
`amount`	integer	To'lov summasi (tiyinda)
`action`	integer	Bajarilayotgan amal. `0` — Prepare
`sign_time`	string	So'rov vaqti. Format `YYYY-MM-DD HH:MM:SS`
`sign_string`	string	Tekshiruv satri (SHA-256): `sha256(ext_trans_id + SECRET_KEY + order_id + amount + action + sign_time)`

Javob

{
  "error": 0,
  "error_note": "OK",
  "prepare_id": "778812"
}

Maydon	Tur	Tavsif
`error`	integer	Amal natijasi. `0` — muvaffaqiyatli
`error_note`	string	Natija izohi
`prepare_id`	string	Sizning tizimingizdagi to'lov identifikatori

Complete

POST {SIZNING_COMPLETE_URL}

{
  "ext_trans_id": 1042,
  "ext_payment_id": 3311,
  "order_id": "A-10245",
  "prepare_id": "778812",
  "amount": 4500000,
  "action": 1,
  "sign_time": "2026-07-28 14:07:03",
  "sign_string": "1ae4...7c02"
}

Maydon	Tur	Tavsif
`ext_trans_id`	integer	Starex Pay tizimidagi to'lov raqami
`ext_payment_id`	integer	Starex Pay tizimidagi tranzaksiya raqami
`order_id`	string	Sizning tizimingizdagi buyurtma raqami
`prepare_id`	string	Sizning tizimingizdagi to'lov identifikatori, `prepare` so'roviga javoban qaytarilgan
`amount`	integer	To'lov summasi (tiyinda)
`action`	integer	Bajarilayotgan amal. `1` — Complete
`sign_time`	string	So'rov vaqti. Format `YYYY-MM-DD HH:MM:SS`
`sign_string`	string	Tekshiruv satri (SHA-256): `sha256(ext_trans_id + SECRET_KEY + order_id + prepare_id + amount + action + sign_time)`

Javob

{
  "error": 0,
  "error_note": "OK",
  "confirm_id": "990145"
}

Maydon	Tur	Tavsif
`error`	integer	Amal natijasi. `0` — muvaffaqiyatli
`error_note`	string	Natija izohi
`confirm_id`	string	Sizning tizimingizdagi tasdiqlash identifikatori

complete javobida qaytarilgan xatolik to'lovni muvaffaqiyatsiz deb belgilaydi.

5. Qaytariladigan xato kodlari

Kod	Xaridor ko'radigan xabar	Qachon qaytariladi
`0`	Amal muvaffaqiyatli bajarildi	Hammasi joyida
`-1`	To'lovni tekshirib bo'lmadi	`sign_string` mos kelmadi
`-2`	To'lov summasi noto'g'ri	`amount` buyurtma summasiga teng emas
`-3`	So'ralgan amal mavjud emas	`action` qiymati noma'lum
`-4`	Bu buyurtma allaqachon to'langan	Takroriy to'lov urinishi
`-5`	Buyurtma topilmadi	`order_id` bo'yicha buyurtma yo'q
`-6`	Tranzaksiya topilmadi	`prepare_id` bo'yicha to'lov topilmadi
`-7`	Buyurtmani yangilab bo'lmadi, qayta urinib ko'ring	Ichki nosozlik
`-8`	Noto'g'ri to'lov so'rovi	Majburiy maydon yetishmayapti
`-9`	Bu tranzaksiya allaqachon bekor qilingan	Bekor qilingan to'lovni davom ettirish urinishi

Ro'yxatda yo'q kod muvaffaqiyatsiz to'lov sifatida qaraladi.