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

post
https://api.cryptomus.com/v1/wallet
Копіювати

Прохання

Параметри запиту

НазваТип параметраЗначення за замовчуваннямВизначення
currency*stringВалютний код
network*stringМережевий код Blockchain
order_id*stringmin: 1max: 100alpha_dashІдентифікатор замовлення у вашій системіПараметр повинен бути рядок, що складається з алфавітних символів, цифр, підкреслення та тире. Він не повинен містити жодних пробілів чи спеціальних символів. order_id повинен бути унікальним у торгових рахунках/статичних гаманцях/рецидивахКоли ми знайдемо існуючу рахунок -фактуру з order_id , ми повертаємо його деталі, новий рахунок -фактура не буде створено.
url_callbackstringmin: 6max: 255urlnullURL, на який буде надіслано webhook після кожного поповнення гаманця
from_referral_codestringnullТорговець, який робить запит, підключається до реферату за кодом.Наприклад, ви - додаток, який генерує рахунки -фактури через 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_uuidUUID з гаманця торговця
uuidUUID гаманця в певній мережі
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}
Копіювати