Kirish

API hujjatlari
  • Asosiy
  • API kalitlarini olishSo'rov formati
  • To'lovlar
    Ishni boshlash Hisob-fakturani yaratish Statik hamyonni yaratish QR-kodni yaratish Statik hamyon blokirovkasi Bloklangan manzil bo'yicha to'lovlarni qaytarish To'lov haqida ma'lumot Qaytarmoq Webhookni qayta yuboring Test maqsadli webhook Xizmatlar ro'yxati To'lov tarixi Webhook To'lov holati AML havolalari
    To'lovlar
    Ishni boshlash Pul yechib olish miqdorini hisoblash To'lovni yaratish To'lov haqida ma'lumot To'lov tarixi To'lov holatlari Webhook Xizmatlar ro'yxati Shaxsiy hamyonga o'tish Biznes hamyoniga o'tish
  • PHP SDK
  • CMS modullari
  • Chegirma to'lovi
    Chegirmalar ro'yxati To'lov usuliga chegirma qo'ying
  • Valyuta kurslari ro'yxatiQoldiqMa'lumotnoma

Asosiy

/

To'lovlar

/

Bloklangan manzil bo'yicha to'lovlarni qaytarish

/

To'lovlar

/

Qaytarmoq

FAQAPIKontaktlar

Ⓒ 2026 Heleket

Privacy policy

Terms of use

AML

FAQAPIKontaktlar

Bloklangan manzil bo'yicha to'lovlarni qaytarish

post
https://api.heleket.com/v1/wallet/blocked-address-refund
Nusxalash

Siz faqat bir marta qaytarib berishingiz mumkin.

Talab qilmoq

So'rov parametrlari

IsmParametr turiTa'rif
uuidstringuuidrequired_without: order_idstatik hamyonning uuid
order_idstringmin:1max:32alpha_dashrequired_without: uuidStatik hamyonning buyurtma identifikatori
address*stringmin:10max:128alpha_dashUshbu manzilga barcha bloklangan mablag'larni qaytarish

Parametr turi

stringuuidrequired_without: order_id

Ta'rif

statik hamyonning uuid

Parametr turi

stringmin:1max:32alpha_dashrequired_without: uuid

Ta'rif

Statik hamyonning buyurtma identifikatori

Parametr turi

stringmin:10max:128alpha_dash

Ta'rif

Ushbu manzilga barcha bloklangan mablag'larni qaytarish

* - Majburiy parametr

To'lovlarni qaytarish uchun siz uuid yoki order_id ni taqdim etishingiz kerak, agar ikkalasini ham taqdim etsangiz, statik hamyon aniqlanadi uuid

Misolga misol


curl https://api.heleket.com/v1/wallet/blocked-address-refund \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "order_id": "1",
      "address": "TK8..."
}'
Nusxalash

Javob

Javob parametrlari

IsmTa'rif
commissionTo'lovni qaytarish komissiyasi
amountTo'lovlar miqdori

Ta'rif

To'lovni qaytarish komissiyasi

Ta'rif

To'lovlar miqdori

Javob namunasi


1{
2    "state": 0,
3    "result": {
4        "commission": "0.50",
5        "amount": "9.50"
6    }
7}
Nusxalash

Mumkin bo'lgan xatolar

Tasdiqlash xatolari

kod : 422

Misol javoblar:

Agar siz uuid va order_id, siz ushbu xabarni olasiz. Bu shuni anglatadiki, kamida parametrlardan biri talab qilinadi.


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}
Nusxalash

Agar statik hamyon topilmasa:


1{
2    "state": 1,
3    "message": "Not found"
4}
Nusxalash

Chiqarilgan holda, agar olib chiqilgan statikarli hamyondan faqat bir marta blokirovka qilingan statik hamyondan ruxsat beriladi, agar siz allaqachon ushbu xato xabarini olasiz:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
Nusxalash

Uzoq vaqt davomida blokirovka qilingan statik hamyondan kirishga ruxsat beriladi, agar siz statik hamyondan, agar siz statik hamyonni to'sib qo'ysangiz, agar siz statik hamyonni to'sib qo'ysangiz, agar siz ushbu xato haqida xabar yuborildi va siz ushbu xato xabarini olasiz:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
Nusxalash

Agar to'lov allaqachon amalga oshirilsa:


1{
2    "state": 1,
3    "message": "Refund is in process"
4}
Nusxalash

Agar to'lovingiz savdogaringiz yoki foydalanuvchingiz bloklangan bo'lsa, siz ushbu xato xabarini olasiz. Bu, masalan, parolingizni o'zgartirganingizda sodir bo'ladi va to'lovlar 24 soat davomida bloklanadi.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
Nusxalash

Agar statik hamyonga to'lovlar kiritilmagan bo'lsa:


1{
2    "state": 1,
3    "message": "Nothing to withdraw"
4}
Nusxalash

Agar to'lov summasi kriptcolatsiya uchun eng kam qo'llab-quvvatlanadigan miqdordan kam bo'lsa, ushbu xato xabarini olasiz:


1{
2    "state": 1,
3    "message": "The amount is too small"
4}
Nusxalash

Agar texnik ish sodir bo'lsa yoki to'lov vaqtincha mavjud bo'lmasa, ushbu xato xabarlarini olasiz:


1{
2    "state": 1,
3    "message": "Server error"
4}
Nusxalash


1{
2    "state": 1,
3    "message": "The service was not found"
4}
Nusxalash

Serverdagi ichki xatolik

kod : 500

Misol javoblar:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
Nusxalash