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

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	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}

Копія