Створення статичного гаманця

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
Значення за замовчуванням
null
Визначення
URL, на який буде надіслано webhook після кожного поповнення гаманця
: Тип параметра
string
Значення за замовчуванням
null
Визначення
Торговець, який робить запит, підключається до реферату за кодом.Наприклад, ви - додаток, який генерує рахунки -фактури через 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	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}

Копія