Asosiy
/To'lovlar
/Hisob-fakturani yaratish
Sahifani nusxalash
| Ism | Parametr turi | Standart qiymat | Ta'rif |
|---|---|---|---|
| amount* | string | To'lanishi kerak bo'lgan miqdor.Agar miqdorda pennies bo'lsa, ularni ajratuvchi bilan yuboring'.' : 10.28 | |
| currency* | string | Valyuta kodi | |
| order_id* | stringmin: 1max: 128alpha_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 schyot-fakturalar / statik hamyon / takrorlash to'lovlari ichida noyob bo'lishi kerakMavjud schyot-fakturani topganda order_id bilan biz o'z ma'lumotlarini qaytaramiz, yangi faktura yaratilmaydi. | |
| network | string | null | BlockChain tarmog'i kodi |
| url_return | stringmin: 6max: 255url | null | To'lovni to'lashdan oldin foydalanuvchi to'lov shaklida tugmachani bosishi va ushbu URL manzilidagi do'kon sahifasiga qaytishi mumkin. |
| url_success | stringmin: 6max: 255url | null | Muvaffaqiyatli to'lovdan so'ng foydalanuvchi to'lov shaklidagi tugmachani bosishi va ushbu URL manziliga qaytishi mumkin. |
| url_callback | stringmin: 6max: 255url | null | To'lov holati bilan qaysi webhook yuboriladi |
| is_payment_multiple | boolean | true | Foydalanuvchi qolgan miqdorni to'lashiga ruxsat beriladimi. Bu foydalanuvchi bitta bitimga schyot-fakturaning to'liq miqdorini to'lamagan bo'lsa, siz unga to'liq miqdorni to'lashga ruxsat berishni xohlaysiz. Agar siz ushbu xususiyatni o'chirib qo'ysangiz, faktura birinchi to'lovni olgandan so'ng yakunlanadi va siz hisobingizga mablag 'olasiz. |
| lifetime | integermin: 300max: 43200 | 3600 | Berilgan hisob-fakturaning ishlashi (soniyalarda) |
| to_currency | string | Parametr fakturaning miqdorini almashtirish uchun maqsadli valyutani belgilash uchun ishlatiladi. Hisob-fakturani yaratishda siz miqdor va valyutani taqdim etasiz va API ushbu summani to_currency Mdagi ekvivalent qiymatga o'zgartirasiz.methods.For example, to create an invoice for 20 USD in bitcoinAPI 20 AQSh dollari miqdorini BTCda joriy ayirboshlash kursi asosida va foydalanuvchi BTCda to'laydi to_currency har doim Fiat valyuta kodi emas, balki CryptoSurrencection Kodeksi bo'lishi kerak. | |
| subtract | integermin: 0max: 100 | 0 | Mijozga to'lanadigan to'lov komissiyasining foiziAgar sizda 1% stavka bo'lsa, unda 100 AQSh dollari uchun schyot-fakturani yaratsangiz (Mijoz 100% komissiya to'laydi), mijoz 101 USDt to'lashi kerak bo'ladi. |
| accuracy_payment_percent | numericmin: 0max: 5 | 0 | To'lovda tushunarli xato.Masalan, agar siz 5 qiymatdan o'tsangiz, schyot-faktura mijoz atigi 95% to'lagan bo'lsa ham, hisob-fakturasi to'lanadi.Haqiqiy to'lov miqdori balansga tushadi |
| additional_data | stringmax: 255 | null | Siz uchun qo'shimcha ma'lumot (mijozga ko'rsatilmagan) |
| currencies | array | Savdogarlaringiz sozlamalaridan mavjud valyutalar qo'llaniladi (agar parametr o'rnatilmagan bo'lsa, qo'llab-quvvatlanadigan krapbatlar sukut bo'yicha qo'llaniladi).Mavjud valyutalar savdogar sozlamalari bo'limiga o'rnatiladi. | To'lov uchun ruxsat berilgan valyutalar ro'yxati. Agar siz o'z mijozlaringiz schyot-fakturalarni to'lash uchun foydalanishi mumkin bo'lgan tangalar ro'yxatini cheklamoqchi bo'lsangiz, bu foydalidir. Tuzilish |
| except_currencies | array | null | To'lov uchun chiqariladigan valyutalar ro'yxati Tuzilish |
| course_source | stringmin: 4max: 20Mavjud qiymatlar• Binance• BinanceP2P• Exmo• Kucoin | Agar o'tgan bo'lsa, Heleket almashinuvi kurslari qo'llaniladi. | Hisobot stavkalari hisob-fakturada qabul qilinganligi uchun xizmat. |
| from_referral_code | string | null | So'rovni kiritadigan savdogar elektron pochta manziliga kiradi.Masalan, siz Heleket API orqali schyot-fakturalarni keltirib chiqaradigan dasturingiz va mijozlaringiz boshqa do'konlardir. ular sizning arizangizda API kaliti va savdo markazi identifikatorini kiritadilar va siz so'rovlarni o'z ma'lumotlari bilan yuborasiz va tavsiyanoma kodini topshirasiz.Shunday qilib, sizning mijozlaringiz sizning Heleket hisob qaydnomangizda tavba qilishadi va siz ularning aylanmasidan daromad olasiz. |
| discount_percent | integermin: -99max: 100 | null | Ijobiy raqamlar: chegirma o'rnatishga imkon beradi. hi to'lov uchun 5% chegirmani belgilash uchun siz qiymatdan o'tishingiz kerak: 5Salbiy raqamlar: sizga maxsus qo'shimcha komissiya o'rnatishga imkon beradi.To'lov uchun 10% qo'shimcha komissiyani belgilash uchun siz qiymatdan o'tishingiz kerak: -10Hisob-fakturani yaratishda chegirma foizi hisobga olinadi, agar hisob-fakturaning o'ziga xos kriptofiysti bo'lsa. |
| is_refresh | boolean | false | Ushbu parametrdan foydalanib, siz umr bo'yi yangilashingiz va faktura muddati tugagan bo'lsa, fakturaning yangi manzilini olishingiz mumkin.Buning uchun siz barcha kerakli parametrlarni yuborishingiz kerak va buyurtmani o'tkazib yuborilgan schyot-faktura yangilanadi.Faqat address, payment_status va expired_at o'zgartirilgan. Boshqa hech qanday maydonlar o'zgarmaydi, parametrlardan qat'i nazar, parametrlardan qat'iy nazar. |
| payer_email | stringnull | null | To'lovchining elektron pochta manzili |
| theme | stringnullMavjud qiymatlar• dark• light | null | Mavzu |
* - Majburiy parametr
| Ism | Ta'rif |
|---|---|
| currency* | Valyuta kodi |
| network | BlockChain tarmog'i kodi |
* - Majburiy parametr
| Ism | Ta'rif |
|---|---|
| currency* | Valyuta kodi |
| network | BlockChain tarmog'i kodi |
* - Majburiy parametr
Quyida zarur bo'lgan minimal parametrlar bo'yicha namunaviy misol keltirilgan. Bunday holda, Fiat valyuta AQSh dollari bilan schyot-faktura yaratiladi. To'lov sahifasida foydalanuvchi ushbu to'lovni to'lash uchun kriptocujlik va tarmoqni tanlashi mumkin.
curl https://api.heleket.com/v1/payment \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"amount": "15",
"currency": "USD",
"order_id": "1"
}'| Ism | Ta'rif |
|---|---|
| uuid | Uuid hisob-fakturasi |
| order_id | Tizimingizda buyurtma identifikatori |
| amount | Hisob-faktura miqdori |
| payment_amount | Mijoz tomonidan to'langan summa |
| payer_amount | payer_currency Tab германдық идентификаторында. URL мекен-жайы мен сипаттамаларын енгізіп, Жіберу түймесін басыңыз. |
| payer_amount_exchange_rate | Invoys yaratilgan paytdagi payer_currency kursi |
| discount_percent | Talabnoma parametrlarida o'tkazilgan chegirma yoki qo'shimcha komissiya foizi |
| discount | Kriptcolatsiyada chegirma yoki qo'shimcha komissiya.Masalan, hisob-faktura miqdori 15 AQSh dollari va chegirma_5, chegirma qiymati 80.75 ga teng bo'ladiI.E. amount discount = payer_amount |
| payer_currency | Mijoz to'lovni amalga oshirishi kerak bo'lgan valyuta. |
| currency | Hisob-faktura valyuta kodi |
| comments | To‘lov bo‘yicha xizmat izohlari, agar bo‘lmasa — null |
| merchant_amount | Sizning muvozanatingizga kiritiladigan kripto-da. Agar foto-faktura to'lovi_currentation ko'rsatilmagan bo'lsa, qiymat nol bo'ladi. |
| network | BlockChain tarmog'i kodi |
| address | To'lov uchun hamyon manzili |
| from | To'lov amalga oshirilgan hamyonning manzili |
| txid | Blokcheyndagi tranzaksiya xeshi.Agar txid maydoni mavjud bo'lmasa1) To'lov p2p orqali amalga oshirildi (To'lovchi Heleket hisobidan hisob-fakturada ko'rsatilgan manzilga mablag' yechib oldi va to'lov blokcheynsiz, faqat bizning tizimimizda amalga oshirildi)2) To'lov amalga oshirilmadi3) To'lov bilan bog'liq muammo yuz berdi yoki mijoz xato qildi va biz uni qo'lda "to'langan" deb belgiladik |
| payment_status | To'lov holati Barcha to'lov holatlari |
| status | payment_status maydonini takrorlaydi, orqaga moslik uchun saqlangan |
| url | URL to'lov sahifasi |
| expired_at | Hisob-faktura muddati tugashi |
| is_final | Hisob-faktura yakunlanadimi.Hisob-faktura tugagach, hisob-fakturani to'lash mumkin emas (u to'langan yoki muddati tugagan) |
| additional_data | Qo'shimcha ma'lumot |
| created_at | Hisob-fakturaning yaratilishi. Vaqtzone - UTC + 3 |
| updated_at | Oxirgi schyot-faktura yangilangan sanasi. Vaqtzone - UTC + 3 |
| address_qr_code | To'lov uchun hamyon manzili ko'rsatilgan QR kod |
| payment_amount_usd | Mijoz tomonidan AQSh dollarida aslida to'langan summa |
| commission | Heleket komissiyasi miqdori |
| convert | To'lov avtomatik ravishda o'zgartirilgan valyuta haqidagi ma'lumotlar. Konversiya to'lovchi_currenience dan USDT uchun amalga oshiriladimethods.The convert field will not exist if you have not enabled the automatic conversion function for payer_currency Tuzilish |
| Ism | Ta'rif |
|---|---|
| to_currency | To'lovni amalga oshiradigan valyuta kodi |
| commission | Konversiya to'lovi |
| rate | Konversiya darajasi |
| amount | Savdogarning muvozanatiga qo'shilgan to_currency aylantirish miqdori, barcha komissiyalar olib tashlandi.Mumkin Bu erda savdogar_amount * stavkaga teng |
1{
2 "state": 0,
3 "result": {
4 "uuid": "1ec87133-b22d-4643-988f-cac29a6ac85d",
5 "order_id": "3",
6 "amount": "20000.00",
7 "payment_amount": null,
8 "payment_amount_usd": "0.00",
9 "payer_amount": "254.92",
10 "payer_amount_exchange_rate": "78.45392451",
11 "discount_percent": 0,
12 "discount": "0.00",
13 "payer_currency": "USDT",
14 "currency": "RUB",
15 "comments": null,
16 "merchant_amount": "249.82816502",
17 "network": "bsc",
18 "address": "0x2b...",
19 "from": null,
20 "txid": null,
21 "payment_status": "check",
22 "url": "https://new-pay.heleket.com/pay/1ec87133-b22d-4643-988f-cac29a6ac85d?theme=light",
23 "expired_at": 1753202502,
24 "status": "check",
25 "is_final": false,
26 "additional_data": null,
27 "created_at": "2025-07-22T18:41:42+03:00",
28 "updated_at": "2025-07-22T18:42:31+03:00",
29 "commission": "5.09853397",
30 "address_qr_code": "data:image/png;base64 ..."
31 }
32}Tenon tarmog'ida 20 AQSh dollari uchun schyot-fakturani yaratish uchun ma'lumotlarni talab qiling. Hisob-faktura yaratish paytida manzil bo'ladi.
1{
2 "amount": "20",
3 "currency": "USDT",
4 "order_id": "1",
5 "network": "tron"
6}25 AQSh dollari uchun schyot-fakturani yaratish va mijozlarga har qanday tarmoqda faqat USDT orqali to'lashiga ruxsat bering.
1{
2 "amount": "25",
3 "currency": "USD",
4 "order_id": "1",
5 "to_currency": "USDT"
6}25 AQSh dollari uchun schyot-fakturani yaratish va mijozlarga faqat tron tarmog'ida faqat USDT orqali to'lashlarini so'rang. Hisob-faktura yaratish paytida manzil bo'ladi.
1{
2 "amount": "25",
3 "currency": "USD",
4 "order_id": "1",
5 "to_currency": "USDT",
6 "network": "tron"
7}20 USDT uchun schyot-fakturani yaratish va mijozlarga barcha mavjud tarmoqlarda to'lashiga ruxsat bering
1{
2 "amount": "20",
3 "currency": "USDT",
4 "order_id": "1"
5}20 AQSh dollari uchun schyot-fakturani yaratish va mijozlarga faqat bitikdan to'lashga ruxsat berish uchun ma'lumotlarni talab qiling. Hisob-faktura yaratish paytida manzil bo'ladi.
1{
2 "amount": "20",
3 "currency": "USD",
4 "order_id": "1",
5 "to_currency": "BTC"
6}0,5 BTC uchun schyot-fakturani yaratish va mijozlarga faqat bitkoinda to'lashiga ruxsat berish. Hisob-faktura yaratish paytida manzil bo'ladi.
1{
2 "amount": "0.5",
3 "currency": "BTC",
4 "order_id": "1"
5}kod : 422
Misol javoblar:
Agar ba'zi parametr talab qilinsa va berilmasa:
1{
2 "state": 1,
3 "errors": {
4 "amount": ["validation.required"]
5 }
6}Agar siz qo'llab-quvvatlanmaydigan tarmoq kodini taqdim qilsangiz
1{
2 "state": 1,
3 "message": "The network was not found"
4}Agar biz currency parametrida taqdim eta olmaymiz:
1{
2 "state": 1,
3 "message": "The currency was not found"
4}Agar sizning to'lovlaringiz bloklangan bo'lsa. Bunday holda siz yordam berishingiz kerak.
1{
2 "state": 1,
3 "message": "You are forbidden"
4}Agar biz to_currency parametrida o'tgan valyutaning to'lov xizmatini topmasak:
1{
2 "state": 1,
3 "message": "Not found service to_currency"
4}Agar tasodifan to_currency o'zgartirganda:
1{
2 "state": 1,
3 "message": "Error convert to_currency"
4}Agar to'lov summasi kriptcolatsiya uchun eng kam qo'llab-quvvatlanadigan summadan kam bo'lsa, ushbu xato xabarini olasiz:
1{
2 "state": 1,
3 "message": "Minimum amount 0.5 USDT"
4}Agar to'lov miqdori kriptofiystit uchun qo'llab-quvvatlanadigan maksimal miqdordan katta bo'lsa, siz ushbu xato xabarini olasiz:
1{
2 "state": 1,
3 "message": "Maximum amount 10000000 USDT"
4}Agar siz to'lovning kriptcolatsial yordamida faol savdo-sotiq hamyoningiz bo'lmasa, siz ushbu xatoni olasiz:
1{
2 "state": 1,
3 "message": "Wallet not found"
4}Agar texnik ish sodir bo'lsa va to'lov vaqtincha mavjud bo'lmasa, ushbu xato xabarlarini olishingiz mumkin:
1{
2 "state": 1,
3 "message": "Gateway error"
4}
1{
2 "state": 1,
3 "message": "The terminal was not found"
4}
1{
2 "state": 1,
3 "message": "Server error"
4}kod : 500
Misol javoblar:
1{
2 "message": "Server error, #1",
3 "code": 500,
4 "error": null
5}