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

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}

Копіювати