Статикалық әмиян жасау
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 әмиянның әр толтырылғаннан кейін жіберілетін URL мекенжайы |
| from_referral_code | string | null | Сұраныс жасаған саудагерге сілтеме жасаушыға код бойынша қосылады.Мысалы, сіз 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_uuid | string | саудагердің әмиянының uuid |
| uuid | string | Белгілі бір желідегі әмиянның uuid |
| order_id | string|null | Сіздің жүйеңіздегі идентификатор |
| currency | string | Әмиян желінің валютасы |
| network | string | Әмияндық желі коды |
| address | string | Әмиян мекен-жайы белгілі бір желідегі |
| url | string | Төлем формасына сілтеме |
Параметр түрі
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}Көшіру