To'lovni yaratish — API orqali mablag'larni qanday yuborish kerak

Asosiy

To'lovlar

To'lovni yaratish

post

https://api.heleket.com/v1/payout

Nusxalash

API orqali to'lovlar faqat sizning biznes hamyoningiz balansidan qilingan.

To'lovlarni turli yo'llar bilan amalga oshirish mumkin:

To'lovni ma'lum bir kriptofiystratsiyada qabul qilishni tanlashingiz mumkin va to'lov avtomatik ravishda ushbu o'ziga xos kriptokrenarlikda avtomatik ravishda qayta ishlanadi. Buning uchun barcha valyutada barcha valyutada etarli miqdorda muvozanat borligiga ishonch hosil qiling.
Shu bilan bir qatorda, siz Fiat valyutasida to'lov miqdorini belgilash imkoniyati mavjud. Bunday holda, summa avtomatik ravishda mavjud balansingizdan ma'lum bir kriptocurriga aylantiriladi. Masalan, agar siz LTC-da 20 AQSh dollari to'langanligini so'rasangiz, unga ekvivalent qiymati sizning LTC balansingizdan ushlab qolinadi. Barcha tegishli to'lovlarni qoplash uchun tegishli kriptofiylikda mablag 'etishishi muhimdir.
Yana bir imkoniyat - Fiat valyutadagi to'lov miqdorini belgilash. Ushbu parametr ayniqsa avtokonvert yoqilganda foydalidir, chunki sizning hisob-fakturalaringizdan mablag 'avtomatik ravishda USDtiga aylantiriladi. Masalan, agar siz LTCda 20 AQSh dollari to'lamoqchi bo'lsangiz, faqat AQSh dollarida balansda qoling, barcha to'lovlarni qoplash uchun USDT mablag'lari etarli ekanligingizga ishonch hosil qiling.
Bundan tashqari, siz o'zingizning xohishingizning istalgan kriptokrulytensistensivligida to'lov miqdorini belgilashni tanlashingiz mumkin. To'lovni avtomatik ravishda amalga oshiradigan o'ziga xos kriptofiylik bo'yicha avtomatik ravishda amalga oshiriladi va mavjud USDT qoldig'ini ishlatadi. Barcha tegishli to'lovlarni qoplash uchun AQSh dollari miqdorida mablag 'yetarli darajada muhimdir.

Talab qilmoq

So‘rov tanasi parametrlari

Ism	Parametr turi	Standart qiymat	Ta'rif
amount*	string		To'lov summasi
currency*	string		To'lov uchun valyuta kodiAgar Fiat bo'lsa, Fiat, to_currency parametri kerak .
order_id*	stringmin:1max:100alpha_dash		Tizimingizda buyurtma identifikatoriParametr alifbo harflari, raqamlar, pastki chiziqlar, pastki chiziqlardan iborat satr bo'lishi kerak. U hech qanday bo'sh joy yoki maxsus belgilar bo'lmasligi kerak. order_id savdogar to'lovlari ichida noyob bo'lishi kerakMavjud to'lovni order_id bilan topsak, biz uning tafsilotlarini qaytaramiz, yangi to'lovlar yaratilmaydi.
address*	string		Chiqarilgan holda hamyonning manzili
is_subtract*	boolean		Kutish to'lovi ushlab qolinadiligini aniqlaydihaqiqiy - balansingizdanFALSE - to'lov summasidan to'lov summasi kamayadi
network*	string		BlockChain tarmog'i kodiAgar valyuta/to_currency kriptovalyuta bo'lsa va faqat bitta tarmoqka ega bo'lsa, masalan, BTC, bu holda talab qilinmaydi.
url_callback	string		To'lov holati bilan qaysi webhook yuboriladi
to_currency	string		methods.Cryptocurrency code in which the payout will be made
course_source	stringMavjud qiymatlar• Binance• BinanceP2p• Exmo• Kucoin	Savdogarning sozlamalaridan qiymati	Hisobot stavkalari hisob-fakturada qabul qilinganligi uchun xizmat.Agar valyuta Fiat bo'lsa, parametr faqat qo'llaniladi, aks holda standart qiymat savdogarning sozlamalaridan olinadi.
from_currency	string	null	Avtomatik ravishda pul mablag'larini o'zgartirishi va_currenity balansidan foydalanishga imkon beradi. Faqat USDT mavjud.
priority	stringmin: 4max: 11Mavjud qiymatlar• recommended• economy• high• highest	recommended	Pulni olish ustuvorligini tanlash parametri. Pul olish uchun to'lovning narxi tanlangan parametrga bog'liq.Ushbu parametr faqat BTC, na poligon va bid'atchi bo'lgan taqdirda qo'llaniladi.
memo	stringmin: 1max: 30		Ton uchun qo'shimcha identifikator, ma'lum bir qabul qiluvchi yoki maqsadni belgilash uchun ishlatiladi

Parametr turi string Ta'rif To'lov summasi
Parametr turi string Ta'rif To'lov uchun valyuta kodiAgar Fiat bo'lsa, Fiat, to_currency parametri kerak .
Parametr turi stringmin:1max:100alpha_dash Ta'rif Tizimingizda buyurtma identifikatoriParametr alifbo harflari, raqamlar, pastki chiziqlar, pastki chiziqlardan iborat satr bo'lishi kerak. U hech qanday bo'sh joy yoki maxsus belgilar bo'lmasligi kerak. order_id savdogar to'lovlari ichida noyob bo'lishi kerakMavjud to'lovni order_id bilan topsak, biz uning tafsilotlarini qaytaramiz, yangi to'lovlar yaratilmaydi.
Parametr turi string Ta'rif Chiqarilgan holda hamyonning manzili
Parametr turi boolean Ta'rif Kutish to'lovi ushlab qolinadiligini aniqlaydihaqiqiy - balansingizdanFALSE - to'lov summasidan to'lov summasi kamayadi
Parametr turi string Ta'rif BlockChain tarmog'i kodiAgar valyuta/to_currency kriptovalyuta bo'lsa va faqat bitta tarmoqka ega bo'lsa, masalan, BTC, bu holda talab qilinmaydi.
Parametr turi string Ta'rif To'lov holati bilan qaysi webhook yuboriladi
Parametr turi string Ta'rif methods.Cryptocurrency code in which the payout will be made
Parametr turi string Mavjud qiymatlar- Binance- BinanceP2p- Exmo- Kucoin Ta'rif Hisobot stavkalari hisob-fakturada qabul qilinganligi uchun xizmat.Agar valyuta Fiat bo'lsa, parametr faqat qo'llaniladi, aks holda standart qiymat savdogarning sozlamalaridan olinadi.
Parametr turi string Ta'rif Avtomatik ravishda pul mablag'larini o'zgartirishi va_currenity balansidan foydalanishga imkon beradi. Faqat USDT mavjud.
Parametr turi stringmin: 4max: 11 Mavjud qiymatlar- recommended- economy- high- highest Ta'rif Pulni olish ustuvorligini tanlash parametri. Pul olish uchun to'lovning narxi tanlangan parametrga bog'liq.Ushbu parametr faqat BTC, na poligon va bid'atchi bo'lgan taqdirda qo'llaniladi.
Parametr turi stringmin: 1max: 30 Ta'rif Ton uchun qo'shimcha identifikator, ma'lum bir qabul qiluvchi yoki maqsadni belgilash uchun ishlatiladi

* - Majburiy parametr

Misolga misol


curl https://api.heleket.com/v1/payout \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
    "amount": "5",
    "currency": "USDT",
    "network": "TRON",
    "order_id": "1",
    "address": "TDD97yguPESTpcrJMqU6h2ozZbibv4Vaqm",
    "url_callback": "https://your.site/callback",
    "is_subtract": "1"
}'

Nusxalash

Javob

Javob parametrlari

Ism	Ta'rif
uuid	To'lovning UUID
amount	To'lov summasi currency
currency	To'lov uchun valyuta kodi
network	To'lov amalga oshiriladigan blockchayn tarmog'ining kodi
address	To'lov amalga oshiriladigan hamyonning manzili
txid	Blokchinda tranzaktsiya identifikatori
status	To'lov holati Barcha mavjud holatlarni ko'ring
is_final	To'lov yakunlanmaydimi yoki yo'qmiTo'lov jarayoni muvaffaqiyatli to'langanidan yoki u muvaffaqiyatsiz bo'lsa, yakunlanadi. To'lovning amalga oshmagan taqdirda, mablag 'balansingizga qaytariladi, bu to'lov jarayonini yana boshlashingizni talab qiladi.
balance	Savdogarning balansidagi qoldiqlar.
payer_currency	To'lovni amalga oshiradigan kriptocurring kodi. To'lov manzili to'lov valyutasini oladi.
payer_amount	To'lovning payer_currencydagi summasi
commission	Xizmat komissiyasi
merchant_amount	Barcha to'lovlarni hisobga olgan holda balansdan yechib olingan summa
convert	Konversiya haqida ma'lumot. Konversiya valyutadan_valyutaga_o'tkaziladi.Agar valyutadan_valyutaga o'tmasangiz yoki u to_valyuta bilan bir xil bo'lsa, aylantirish maydoni mavjud bo'lmaydi. Tuzilish

Ta'rif To'lovning UUID
Ta'rif To'lov summasi currency
Ta'rif To'lov uchun valyuta kodi
Ta'rif To'lov amalga oshiriladigan blockchayn tarmog'ining kodi
Ta'rif To'lov amalga oshiriladigan hamyonning manzili
Ta'rif Blokchinda tranzaktsiya identifikatori
Ta'rif To'lov holati Barcha mavjud holatlarni ko'ring
Ta'rif To'lov yakunlanmaydimi yoki yo'qmiTo'lov jarayoni muvaffaqiyatli to'langanidan yoki u muvaffaqiyatsiz bo'lsa, yakunlanadi. To'lovning amalga oshmagan taqdirda, mablag 'balansingizga qaytariladi, bu to'lov jarayonini yana boshlashingizni talab qiladi.
Ta'rif Savdogarning balansidagi qoldiqlar.
Ta'rif To'lovni amalga oshiradigan kriptocurring kodi. To'lov manzili to'lov valyutasini oladi.
Ta'rif To'lovning payer_currencydagi summasi
Ta'rif Xizmat komissiyasi
Ta'rif Barcha to'lovlarni hisobga olgan holda balansdan yechib olingan summa
Ta'rif Konversiya haqida ma'lumot. Konversiya valyutadan_valyutaga_o'tkaziladi.Agar valyutadan_valyutaga o'tmasangiz yoki u to_valyuta bilan bir xil bo'lsa, aylantirish maydoni mavjud bo'lmaydi. Tuzilish

Tarkibi convert

Ism	Ta'rif
to_currency	To'lov o'tkaziladigan valyutaning kodi
from_currency	To'lov almashtiriladigan valyuta
commission	Konversiya to'lovi
rate	Konversiya darajasi
from_amount	Barcha toʻlovlar ayirib tashlangan, from_currency ga almashtirilgan summa.

Ta'rif To'lov o'tkaziladigan valyutaning kodi
Ta'rif To'lov almashtiriladigan valyuta
Ta'rif Konversiya to'lovi
Ta'rif Konversiya darajasi
Ta'rif Barcha toʻlovlar ayirib tashlangan, from_currency ga almashtirilgan summa.

Javob namunasi


1{
2    "state": 0,
3    "result": {
4        "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
5        "amount": "3",
6        "currency": "USDT",
7        "commission": "0.001",
8        "merchant_amount": "3.001",
9        "network": "TRON",
10        "address": "TJ...",
11        "txid": null,
12        "status": "process",
13        "is_final": false,
14        "balance": 129,
15        "payer_currency": "USDT",
16        "payer_amount": 3
17    }
18}
19

Nusxalash

Mumkin bo'lgan xatolar

Tasdiqlash xatolari

kod : 422

Misol javoblar:


1{
2	"state": 1,
3	"errors": {
4		"amount": ["validation.required"]
5	}
6}

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 siz valyuta parametrida taqdim etgan valyuta kodini qo'llab-quvvatlamasak, ushbu xato xabarini olasiz:


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

Nusxalash

Agar to'lovni bajarish uchun xizmatni topa olmasak, siz bu xato xabarini olasiz. Siz kriptovalyutaning qo'llab-quvvatlanishini tekshirishingiz kerak. Valyuta, tarmoq, from_currency, to_currency kiritilgan qiymatlarning to'g'riligini tekshiring:


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

Nusxalash

Agar pul mablag'lari juda kichik bo'lsa, siz ushbu xato xabarini olasiz:


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

Nusxalash

Agar siz to'lovning kriptcolatsi bilan faol savdo-sotiq hamyoningiz bo'lmasa, siz ushbu xatoni olasiz:


1{
2    "state": 1,
3    "message": "Wallet not found"
4}

Nusxalash

Agar to'lov summasi, shu jumladan barcha komissiyalar sizning hisobingizdan ko'proq bo'lsa, siz ushbu xato xabarini olasiz:


1{
2    "state": 1,
3    "message": "Not enough funds"
4}

Nusxalash

Agar to_currency parametrida berilgan valyutaning to'lov xizmati topilmasa, siz ushbu xatolik xabarini olasiz:


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

Nusxalash

Agar to_currency ga konvertatsiya qilishda tasodifan biror narsa sodir bo'lsa, ushbu xato xabarini olasiz:


1{
2    "state": 1,
3    "message": "Error convert to_currency"
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": "Minimum amount 0.5 USDT"
4}

Nusxalash

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


1{
2    "state": 1,
3    "message": "Maximum amount 10000000 USDT"
4}

Nusxalash

Agar siz to'lovni amalga oshirish uchun mablag 'yetarli bo'lmasa, siz ushbu xato xabarini olasiz:


1{
2    "state": 1,
3    "message": "Not enough funds"
4}

Nusxalash

Agar to'lov miqdorini to'lov miqdorini hisoblash uchun mablag 'bo'lmasa, ushbu xato xabarini olasiz:


1{
2    "state": 1,
3    "message": "Not enough balance for convert USDT to LTC"
4}

Nusxalash

Agar texnik ish sodir bo'lsa va to'lov vaqtincha mavjud bo'lmasa, siz ushbu xato xabarini olasiz


1{
2    "state": 1,
3    "message": "The terminal 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