Xabarnomalar

Tranzaksiya holatidagi oʻzgarishlar haqidagi bildirishnomalar orqa tomonimizdan notify_url parametrida (prepare_payment usuli) koʻrsatilgan manzilga qayta qoʻngʻiroq qilish orqali yuboriladi va faqat Octo tizimi API orqali yaratilgan toʻlovlar uchun olinadi.

Callback xabarnomalari

Callback strukturasi

{
  "shop_transaction_id": "7339d5be-871b-45d8-ab07-dbbd51364c2f",
  "octo_payment_UUID": "4556a13e-f763-4b91-9387-92395fd51ccf",
  "status": "succeeded",
  "signature": "64F35398F22FE63FE780583F8BEEDE170094CE5D",
  "hash_key": "e27d3f79-3189-44e9-8a66-566a141025df",
  "total_sum": 1,
  "transfer_sum": 0.97,
  "refunded_sum": 0,
  "card_country": "UZ",
  "maskedPan": "427831** **** 3011",
  "rrn": "436456776123",
  "riskLevel": 0,
  "payed_time": "2024-12-25 15:25:14",
  "card_type": "internationalVisa"
}

Callback parametrlari

Parametr	Turi	Majburiy	Tavsif
shop_transaction_id	String	Ha	Hamkor tizimidagi noyob tranzaksiya identifikatori
octo_payment_UUID	String	Ha	Octo tizimidagi noyob to‘lov identifikatori
status	String	Ha	To‘lov holati
signature	string	Ha	Ma'lumotlarning haqiqiyligini tekshirish uchun kriptografik imzo
hash_key	String	Ha	Ma'lumotlarni tasdiqlash uchun xesh kaliti
total_sum	Decimal	Yo‘q	To‘lovning umumiy summasi
transfer_sum	Decimal	Yo‘q	Komissiya ushlab qolingandan keyin hamkorga tushgan summa
refunded_sum	Decimal	Yo‘q	Mijozga qaytarilgan summa (agar qaytarish bo‘lsa)
card_country	String	Yo‘q	Karta chiqarilgan davlat
maskedPan	String	Yo‘q	Mijoz kartasining maskirovka qilingan raqami
rrn	String	Yo‘q	Retrieval Reference Number — protsessing tizimidagi noyob identifikator
riskLevel	Integer	Yo‘q	Tranzaksiya xavf darajasi (0 dan 5gacha bo‘lishi mumkin)
payed_time	String	Yo‘q	Muvaffaqiyatli to‘lov sanasi va vaqti (YYYY-MM-DD HH:MM:SS formatida)
card_type	String	Yo‘q	Karta turi
is_physical_card	Boolean	Yo‘q	Karta jismoniy (true) yoki virtual (false) ekanligini bildiruvchi bayroq

Eslatma

signature va hash_key ni tekshirish quyidagi formula orqali amalga oshiriladi:
sha1(sha1(secret, hash_key), uuid, status) bunda:

• secret – faqat jo‘natuvchi va qabul qiluvchi biladigan maxfiy kalit;
• hash_key – har bir tranzaksiya uchun noyob bo‘lishi mumkin bo‘lgan xesh kaliti;
• uuid – to‘lov identifikatori (masalan, octo_payment_UUID);
• status – to‘lov holati (succeeded, failed va boshqalar).

Bildirishnomalarni sozlash

• Bildirishnoma olish uchun havola do‘konning **Shaxsiy kabinetida (SK) ** ko‘rsatilishi kerak.
• Ko‘rsatilgan havola ushbu to‘lovlarga tegishli barcha so‘rovlarda notify_url parametrida aks ettiriladi.

Eslatma

Ko‘rsatilgan URL to‘g‘ri ekaniga va Octo bildirishnomalari qayta ishlanishi mumkinligiga ishonch hosil qiling.