Статикалық әмиянды жасау кезінде 2 TRX комиссия алынады. Бұл комиссия әмиянды жасау құнын жабады және бірінші транзакция кезінде бір рет қана қолданылады.
post
https://api.heleket.com/v1/wallet
Өтініш
Сұрау параметрлері
| Есім | Параметр түрі | Әдепкі мән | Анықтама |
|---|---|---|---|
| currency* | string | Валюта кодексі | |
| network* | string | BlockChain желілік коды | |
| order_id* | stringmin: 1max: 100alpha_dash | Сіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id Сатушы шот-фактуралар / статикалық әмияндар / қайталану төлемдерінде ерекше болуы керекБіз order_id бар шот-фактураны тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа шот-фактура жасалмайды. | |
| url_callback | stringmin: 6max: 255url | null | Webhook әмиянның әр толтырылғаннан кейін жіберілетін URL мекенжайы |
| from_referral_code | string | null | Сұраныс жасаған саудагерге сілтеме жасаушыға код бойынша қосылады.Мысалы, сіз Heleket API арқылы шот-фактураларды жасайтын қосымшасыз, ал сіздің клиенттеріңіз басқа дүкендер болып табылады. Олар сіздің API кілті мен сауда идентификаторын қосымшаңызға енгізеді және сіз олардың тіркелгі деректері бойынша сұраныстарды жіберіп, жүгіндік кодыңызды жібересіз.Осылайша, сіздің клиенттеріңіз сіздің Heleket есептік жазбаңызға жіберіліп, олардың айналымынан табыс алады. |
Параметр түрі
stringАнықтама
Валюта кодексіПараметр түрі
stringАнықтама
BlockChain желілік кодыПараметр түрі
stringmin: 1max: 100alpha_dashАнықтама
Сіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id Сатушы шот-фактуралар / статикалық әмияндар / қайталану төлемдерінде ерекше болуы керекБіз order_id бар шот-фактураны тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа шот-фактура жасалмайды.Параметр түрі
stringmin: 6max: 255urlАнықтама
Webhook әмиянның әр толтырылғаннан кейін жіберілетін URL мекенжайыПараметр түрі
stringАнықтама
Сұраныс жасаған саудагерге сілтеме жасаушыға код бойынша қосылады.Мысалы, сіз Heleket API арқылы шот-фактураларды жасайтын қосымшасыз, ал сіздің клиенттеріңіз басқа дүкендер болып табылады.
Олар сіздің API кілті мен сауда идентификаторын қосымшаңызға енгізеді және сіз олардың тіркелгі деректері бойынша сұраныстарды жіберіп, жүгіндік кодыңызды жібересіз.Осылайша, сіздің клиенттеріңіз сіздің Heleket есептік жазбаңызға жіберіліп, олардың айналымынан табыс алады.
* - Міндетті параметр
Мысал сұрау
curl https://api.heleket.com/v1/wallet \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: fe99035f86fa436181717b302b95bacff1' \
-H 'Content-Type: application/json' \
-d '{
"currency": "USDT",
"network": "tron",
"order_id": "1",
"url_callback": "https://your.site/callback"
}'Жауап
Жауап параметрлері
| Есім | Анықтама |
|---|---|
| wallet_uuid | саудагердің әмиянының uuid |
| uuid | Белгілі бір желідегі әмиянның uuid |
| order_id | Жүйедегі тапсырыс идентификаторы (тапсырысты анықтау үшін) |
| address | Әмиян мекен-жайы белгілі бір желідегі |
| network | Әмияндық желі коды |
| currency | Әмиян желінің валютасы |
| url | Төлем формасына сілтеме |
Анықтама
саудагердің әмиянының uuidАнықтама
Белгілі бір желідегі әмиянның uuidАнықтама
Жүйедегі тапсырыс идентификаторы (тапсырысты анықтау үшін)Анықтама
Әмиян мекен-жайы белгілі бір желідегіАнықтама
Әмияндық желі кодыАнықтама
Әмиян желінің валютасыАнықтама
Төлем формасына сілтеме
Жауаптың мысалы
1{
2 "state": 0,
3 "result": {
4 "wallet_uuid": "de15b0f6-883f-4585-b27b-73a648044a92",
5 "uuid": "87961ae5-80c5-413a-a4fe-d38199894940",
6 "order_id": "1",
7 "address": "TTEtddVZyNtLD9wbq4PzomjBhtxenSMXbb",
8 "network": "tron",
9 "currency": "USDT",
10 "url": "https://pay.heleket.com/wallet/3901446a-4b74-4796-b50a-14e14dafe3ed"
11 }
12}Мүмкін қателер
Тексеру қателері
код : 422
Мысал жауаптары:
Егер кейбір параметрлер қажет болса және жіберілмесе:
1{
2 "state": 1,
3 "errors": {
4 "currency": ["validation.required"]
5 }
6}Егер сіздің төлемдеріңіз бұғатталған болса. Бұл жағдайда қолдау қызметіне хабарласу керек.
1{
2 "state": 1,
3 "message": "You are forbidden"
4}
5Егер біз currencyбірге төлем қызметін таба алмасақ, network:
1{
2 "state": 1,
3 "message": "The service was not found"
4}Егер техникалық жұмыс орын алса және төлем уақытша қол жетімді болмаса, сіз осы қате туралы хабарламаны ала аласыз:
1{
2 "state": 1,
3 "message": "The terminal was not found"
4}
1{
2 "state": 1,
3 "message": "Server error"
4}
1{
2 "state": 1,
3 "message": "Wallet not found"
4}