Статикалық әмиян жасау
post
https://api.cryptomus.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 WebHook әмиянның әр толтырылғаннан кейін жіберілетін URL мекенжайы |
from_referral_code | string | null | Сұраныс жасаған саудагерге сілтеме жасаушыға код бойынша қосылады.Мысалы, сіз Cryptomus API арқылы шот-фактураларды жасайтын қосымшасыз, ал сіздің клиенттеріңіз басқа дүкендер болып табылады. Олар сіздің API кілті мен сауда идентификаторын қосымшаңызға енгізеді және сіз олардың тіркелгі деректері бойынша сұраныстарды жіберіп, жүгіндік кодыңызды жібересіз.Осылайша, сіздің клиенттеріңіз сіздің Cryptomus есептік жазбаңызға жіберіліп, олардың айналымынан табыс алады. |
Параметр түрі
stringАнықтама
Валюта кодексіПараметр түрі
stringАнықтама
BlockChain желілік кодыПараметр түрі
stringmin: 1max: 100alpha_dashАнықтама
Сіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id Сатушы шот-фактуралар / статикалық әмияндар / қайталану төлемдерінде ерекше болуы керекБіз order_id бар шот-фактураны тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа шот-фактура жасалмайды.Параметр түрі
stringmin: 6max: 255urlАнықтама
WebHook WebHook әмиянның әр толтырылғаннан кейін жіберілетін URL мекенжайыПараметр түрі
stringАнықтама
Сұраныс жасаған саудагерге сілтеме жасаушыға код бойынша қосылады.Мысалы, сіз Cryptomus API арқылы шот-фактураларды жасайтын қосымшасыз, ал сіздің клиенттеріңіз басқа дүкендер болып табылады.
Олар сіздің API кілті мен сауда идентификаторын қосымшаңызға енгізеді және сіз олардың тіркелгі деректері бойынша сұраныстарды жіберіп, жүгіндік кодыңызды жібересіз.Осылайша, сіздің клиенттеріңіз сіздің Cryptomus есептік жазбаңызға жіберіліп, олардың айналымынан табыс алады.
* - Міндетті параметр
Мысал сұрау
curl https://api.cryptomus.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 |
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 "address": "TTEtddVZyNtLD9wbq4PzomjBhtxenSMXbb",
7 "network": "tron",
8 "currency": "USDT",
9 "url": "https://pay.cryptomus.com/wallet/3901446a-4b74-4796-b50a-14e14dafe3ed"
10 }
11}
ЕліктеуМүмкін қателер
Тексеру қателері
код : 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}
Еліктеу