Кіру

API құжаттамасы
  • Басты
  • API кілттерін алуСұраныс форматы
  • Төлемдер
    Бастау Шот-фактураны құру Статикалық әмиян жасау QR-код жасаңыз Статикалық әмиянды блоктау Бұғатталған мекен-жай бойынша төлемдерді қайтару Төлем туралы ақпарат Төлеу WebHook-ті қайта жіберіңіз Тесттік webhook Қызметтер тізімі Төлем тарихы Webhook Төлем мәртебесі AML сілтемелері
    Төлемдер
    Бастау Шығарып алу сомасын есептеу Төлем жасау Төлем туралы ақпарат Төлем тарихы Төлемнің күйі Webhook Қызметтер тізімі Жеке әмиянға ауысу Іскери әмиянға ауыстыру
  • PHP SDK
  • CMS модульдері
  • Жеңілдікті төлем
    Жеңілдіктер тізімі Төлем әдісіне жеңілдік қойыңыз
  • Валюта бағамдарының тізіміБалансСілтеме

Басты

/

Төлемдер

/

Бұғатталған мекен-жай бойынша төлемдерді қайтару

/

Төлемдер

/

Төлеу

FAQAPIБайланыстар

Ⓒ 2026 Heleket

Privacy policy

Terms of use

AML

FAQAPIБайланыстар

Бұғатталған мекен-жай бойынша төлемдерді қайтару

post
https://api.heleket.com/v1/wallet/blocked-address-refund
Көшіру

Сіз тек бір рет қайтара аласыз.

Өтініш

Сұрау параметрлері

ЕсімПараметр түріАнықтама
uuidstringuuidrequired_without: order_idстатикалық әмиянның ууидтері
order_idstringmin:1max:32alpha_dashrequired_without: uuidСтатикалық әмиянның идентификаторы
address*stringmin:10max:128alpha_dashОсы мекен-жайға барлық тыйым салынған қаражаттарды қайтарыңыз

Параметр түрі

stringuuidrequired_without: order_id

Анықтама

статикалық әмиянның ууидтері

Параметр түрі

stringmin:1max:32alpha_dashrequired_without: uuid

Анықтама

Статикалық әмиянның идентификаторы

Параметр түрі

stringmin:10max:128alpha_dash

Анықтама

Осы мекен-жайға барлық тыйым салынған қаражаттарды қайтарыңыз

* - Міндетті параметр

Төлемдерді қайтару үшін сізге uuid немесе order_id uuid

Мысал сұрау


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..."
}'
Көшіру

Жауап

Жауап параметрлері

ЕсімАнықтама
commissionҚайтару комиссиясы
amountҚайтару сомасы

Анықтама

Қайтару комиссиясы

Анықтама

Қайтару сомасы

Жауаптың мысалы


1{
2    "state": 0,
3    "result": {
4        "commission": "0.50",
5        "amount": "9.50"
6    }
7}
Көшіру

Мүмкін қателер

Тексеру қателері

код : 422

Мысал жауаптары:

Егер сіз uuid tock_id өтпесеңіз, сіз бұл хабарламаны аласыз. Бұл дегеніміз, кем дегенде, параметрлердің біреуі қажет екенін білдіреді.


1{
2	"state": 1,
3	"errors": {
4		"uuid": ["validation.required_without"],
5		"order_id": ["validation.required_without"]
6	}
7}
Көшіру

Егер статикалық әмиян табылмаса:


1{
2    "state": 1,
3    "message": "Not found"
4}
Көшіру

Алып тастауға дейін бұғатталған статикалық әмияннан бір рет рұқсат етіледі, егер оны алу бұрыннан жасалған болса, сіз осы қате туралы хабарламаны аласыз:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
Көшіру

Егер сіз »шығарылған кезде, егер сіз құрастырылған статикалық әмияннан бір рет рұқсат етіледі, егер сіз статикалық әмиянды, егер сіз тұрақты әмиянды бұғаттасаңыз, егер сіз is_force_refund = true параметрі бар болса, оны алуыңызша, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "You can withdraw only once"
4}
Көшіру

Егер қайтару қазірдің өзінде болса:


1{
2    "state": 1,
3    "message": "Refund is in process"
4}
Көшіру

Егер төлемдеріңізден немесе пайдаланушысыңызда төлемдер бұғатталған болса, сіз осы қате туралы хабарлама аласыз. Бұл, мысалы, парольді өзгерткен кезде және төлемдер 24 сағат бойы бұғатталған кезде.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
Көшіру

Егер тұрақты әмиянға төлем жасалмаса:


1{
2    "state": 1,
3    "message": "Nothing to withdraw"
4}
Көшіру

Егер төлем сомасы криптокуралдылық үшін ең аз қолдау көрсетілетін сомадан аз болса, сіз осы қате туралы хабарлама аласыз:


1{
2    "state": 1,
3    "message": "The amount is too small"
4}
Көшіру

Егер техникалық жұмыс орын алса немесе төлем уақытша қол жетімді болмаса, сіз осы қате туралы хабарламаларды аласыз:


1{
2    "state": 1,
3    "message": "Server error"
4}
Көшіру


1{
2    "state": 1,
3    "message": "The service was not found"
4}
Көшіру

Ішкі қате

код : 500

Мысал жауаптары:


1{
2	"message": "Server error, #1",
3	"code": 500,
4	"error": null
5}
Көшіру