Статикалық әмиян жасау

post
https://api.cryptomus.com/v1/wallet
Еліктеу

Өтініш

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

ЕсімПараметр түріӘдепкі мәнАнықтама
currency*stringВалюта кодексі
network*stringBlockChain желілік коды
order_id*stringmin: 1max: 100alpha_dashСіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id Сатушы шот-фактуралар / статикалық әмияндар / қайталану төлемдерінде ерекше болуы керекБіз order_id бар шот-фактураны тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа шот-фактура жасалмайды.
url_callbackstringmin: 6max: 255urlnullWebHook WebHook әмиянның әр толтырылғаннан кейін жіберілетін URL мекенжайы
from_referral_codestringnullСұраныс жасаған саудагерге сілтеме жасаушыға код бойынша қосылады.Мысалы, сіз 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}
Еліктеу