Створення статичного гаманця
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 | URL, на який буде надіслано webhook після кожного поповнення гаманця |
from_referral_code | string | null | Торговець, який робить запит, підключається до реферату за кодом.Наприклад, ви - додаток, який генерує рахунки -фактури через API Cryptomus, а ваші клієнти - інші магазини. Вони вводять свій ключ API та ідентифікатор торговця у вашій заявці, і ви надсилаєте запити з їх обліковими повідомленнями та передаючи свій реферальний код.Таким чином, ваші клієнти стають рефералами на вашому обліковому записі Cryptomus, і ви отримаєте дохід від їх обороту. |
Тип параметра
stringВизначення
Валютний кодТип параметра
stringВизначення
Мережевий код BlockchainТип параметра
stringmin: 1max: 100alpha_dashВизначення
Ідентифікатор замовлення у вашій системіПараметр повинен бути рядок, що складається з алфавітних символів, цифр, підкреслення та тире. Він не повинен містити жодних пробілів чи спеціальних символів. order_id повинен бути унікальним у торгових рахунках/статичних гаманцях/рецидивахКоли ми знайдемо існуючу рахунок -фактуру з order_id , ми повертаємо його деталі, новий рахунок -фактура не буде створено.Тип параметра
stringmin: 6max: 255urlВизначення
URL, на який буде надіслано webhook після кожного поповнення гаманцяТип параметра
stringВизначення
Торговець, який робить запит, підключається до реферату за кодом.Наприклад, ви - додаток, який генерує рахунки -фактури через API Cryptomus, а ваші клієнти - інші магазини.
Вони вводять свій ключ 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}
Копіювати