Qaytarmalar orqali pulni qaytarish

refund usuli muvaffaqiyatli amalga oshirilgan to‘lovlar (succeeded holatida) uchun pulni qaytarish uchun qo‘llaniladi. Qaytariladigan minimal summa 1 AQSh dollaridan (yoki UZSdagi ekvivalentidan) kam bo‘lmasligi, maksimal summa esa operatsiyaning dastlabki miqdoridan oshmasligi kerak.

Muhim!

Qaytariladigan to'lov miqdori bittasi uchun 10 million so'mdan oshmasligi kerak tranzaksiya, lekin bitimlar soni bo'yicha hech qanday cheklovlar yo'q.

refund usuli haqida

• URL: https://secure.octo.uz/refund
• Method: POST
• Content-type: application/json

So‘rovnoma namunasi

{
    "octo_shop_id": "{{merchant_id}}",
    "shop_refund_id": "{{$randomUUID}}",
    "octo_secret": "{{merchant_secret}}",
    "octo_payment_UUID": "{{octo_payment_UUID}}",
    "amount": 1000.00
}

So‘rov parametrlari

Parametr	Turi	Majburiylik	Tavsif
octo_shop_id	int	Ha	Do'konning noyob identifikatori (Shaxsiy kabinetda mavjud).
shop_refund_id	string	Ha	Qaytarma so‘rovining noyob identifikatori, tizim tomonidan yaratiladi.
octo_secret	string	Ha	Do'konning maxfiy kaliti (Shaxsiy kabinetda yaratiladi).
octo_payment_UUID	string	Ha	OCTO tizimi tomonidan yaratilgan to'lovning noyob identifikatori.
amount	decimal	Ha	Qaytariladigan summa.

---

Muvaffaqiyatli javob namunasi

{
    "error": 0,
    "errMessage": null,
    "data": {
        "octo_payment_UUID": "6b6b4477-ab8b-49dc-97eb-638b15b9b3e9",
        "refund_id": "9ddd6a6c-e8c7-4859-9943-70c5bf7b4405",
        "refund_time": "2024-12-18 16:59:39",
        "status": "succeeded"
    },
    "errorMessage": null,
    "apiMessageForDevelopers": "errorMessage maydoni eskirgan, javoblarni unifikatsiya qilish uchun errMessage-ga o'tishni so'raymiz."
}

Muvaffaqiyatli javob parametrlari

Parametr	Turi	Majburiylik	Tavsif
error	int	Ha	Xato kodi. 0 qiymati muvaffaqiyatli so‘rovni anglatadi.
errMessage	string	Yo'q	Xato haqida xabar. Agar xato bo'lmasa, null.
data.octo_payment_UUID	string	Ha	To'lovning Octo tizimidagi noyob identifikatori.
data.refund_id	string	Ha	Qaytarma so‘rovining noyob identifikatori.
data.refund_time	string	Ha	ISO 8601 formatidagi qaytarma vaqti.
data.status	string	Ha	Qaytarma holati: succeeded, failed, pending.
apiMessageForDevelopers	string	Yo'q	Ishlab chiquvchilar uchun API holati yoki o‘zgarishlar haqida xabar.

---

Muvaffaqiyatsiz javoblar namunasi

Qaytarma summasi noto'g'ri

{
  "error": 22,
  "errMessage": "Wrong amount to refund.",
  "data": null,
  "errorMessage": "Wrong amount to refund.",
  "apiMessageForDevelopers": "errorMessage maydoni eskirgan, javoblarni unifikatsiya qilish uchun errMessage-ga o'tishni so'raymiz."
}

Maxfiy kalit noto'g'ri

{
  "error": 2,
  "errMessage": "Wrong secret",
  "data": null,
  "errorMessage": "Wrong secret",
  "apiMessageForDevelopers": "errorMessage maydoni eskirgan, javoblarni unifikatsiya qilish uchun errMessage-ga o'tishni so'raymiz."
}

Muvaffaqiyatsiz javob parametrlari

Parametr	Turi	Majburiylik	Tavsif
error	int	Ha	Xato kodi.
errMessage	string	Ha	Xato haqida xabar.
data	object	Yo'q	Operatsiyaga oid asosiy ma'lumotlar (xato bo'lsa, null).
errorMessage	string	Ha	Eskirgan maydon, xato haqida xabar (errMessage ishlatilishi tavsiya etiladi).
apiMessageForDevelopers	string	Yo'q	Ishlab chiquvchilar uchun API holati yoki o‘zgarishlar haqida xabar.

---

Eslatma

Metod faqat succeeded holatidagi tranzaksiyalar uchun qo'llaniladi. Minimal qaytarma miqdori – 1 AQSh dollari (yoki UZSdagi ekvivalent). Savollar tug‘ilsa, texnik yordam xizmatiga murojaat qiling.