Создание статического кошелька
post
https://api.cryptomus.com/v1/wallet
Запрос
Параметры запроса
| Имя | Тип параметра | Значение по умолчанию | Описание |
|---|---|---|---|
| currency* | string | Код валюты | |
| network* | string | Сетевой код блокчейна | |
| order_id* | stringmin: 1max: 100alpha_dash | Идентификатор заказа в Вашей системеПараметр должен представлять собой строку, состоящую из буквенных символов, цифр, подчеркиваний и тире. Он не должен содержать никаких пробелов или специальных символов. order_id должен быть уникальным в счетах продавца/статических кошельках/повторных платежахКогда мы находим существующий счет-фактуру с order_id, мы возвращаем его реквизиты, новый счет-фактура создан не будет. | |
| url_callback | stringmin: 6max: 255url | null | URL, на который будет отправляться webhook после каждого пополнения кошелька |
| from_referral_code | string | null | Продавец, который делает запрос, подключается к рефереру с помощью кода.Например, вы являетесь приложением, которое генерирует счета-фактуры через Cryptomus API, а вашими клиентами являются другие магазины. Они вводят свой api-ключ и идентификатор продавца в ваше приложение, а вы отправляете запросы с их учетными данными и передаете свой реферальный код.Таким образом, ваши клиенты становятся рефералами на вашем аккаунте Cryptomus, и вы будете получать доход от их оборота. |
Тип параметра
stringОписание
Код валютыТип параметра
stringОписание
Сетевой код блокчейнаТип параметра
stringmin: 1max: 100alpha_dashОписание
Идентификатор заказа в Вашей системеПараметр должен представлять собой строку, состоящую из буквенных символов, цифр, подчеркиваний и тире. Он не должен содержать никаких пробелов или специальных символов. order_id должен быть уникальным в счетах продавца/статических кошельках/повторных платежахКогда мы находим существующий счет-фактуру с order_id, мы возвращаем его реквизиты, новый счет-фактура создан не будет.Тип параметра
stringmin: 6max: 255urlОписание
URL, на который будет отправляться webhook после каждого пополнения кошелькаТип параметра
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}