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

post https://api.cryptomus.com/v1/wallet Көшіру

Өтініш

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

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

Параметр түрі

string

Анықтама

Валюта кодексі

Параметр түрі

string

Анықтама

BlockChain желілік коды

Параметр түрі

stringmin: 1max: 100alpha_dash

Анықтама

Сіздің жүйеңіздегі идентификаторПараметр алфавиттік таңбалардан, сандардан, астында сызбалардан және сызықшалардан тұратын жол болуы керек. Ол ешқандай кеңістік немесе арнайы таңбалар болмауы керек. order_id Сатушы шот-фактуралар / статикалық әмияндар / қайталану төлемдерінде ерекше болуы керекБіз order_id бар шот-фактураны тапқан кезде, біз оның мәліметтерін қайтарамыз, жаңа шот-фактура жасалмайды.

Параметр түрі

stringmin: 6max: 255url

Әдепкі мән

null

Анықтама

Webhook әмиянның әр толтырылғаннан кейін жіберілетін URL мекенжайы

Параметр түрі

string

Әдепкі мән

null

Анықтама

Сұраныс жасаған саудагерге сілтеме жасаушыға код бойынша қосылады.Мысалы, сіз 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_uuidstringсаудагердің әмиянының uuid
uuidstringБелгілі бір желідегі әмиянның uuid
order_idstring|nullСіздің жүйеңіздегі идентификатор
currencystringӘмиян желінің валютасы
networkstringӘмияндық желі коды
addressstringӘмиян мекен-жайы белгілі бір желідегі
urlstringТөлем формасына сілтеме

Параметр түрі

string

Анықтама

саудагердің әмиянының uuid

Параметр түрі

string

Анықтама

Белгілі бір желідегі әмиянның uuid

Параметр түрі

string|null

Анықтама

Сіздің жүйеңіздегі идентификатор

Параметр түрі

string

Анықтама

Әмиян желінің валютасы

Параметр түрі

string

Анықтама

Әмияндық желі коды

Параметр түрі

string

Анықтама

Әмиян мекен-жайы белгілі бір желідегі

Параметр түрі

string

Анықтама

Төлем формасына сілтеме

Жауаптың мысалы


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		"currency": "USDT",
8		"network": "tron",
9		"address": "TTEtddVZyNtLD9wbq4PzomjBhtxenSMXbb",
10		"url": "https://pay.cryptomus.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}
Көшіру