Tworzenie statycznego portfela

post

https://api.cryptomus.com/v1/wallet

KOPIUJ

Wniosek

Parametry zapytania

Nazwa	Typ parametru	Domyślna wartość	Definicja
currency*	string		Kod waluty
network*	string		Kod sieci Blockchain
order_id*	stringmin: 1max: 100alpha_dash		Zamów identyfikator w twoim systemieParametr powinien być łańcuchem składającym się z znaków alfabetycznych, liczb, podkreśleń i dystansów. Nie powinien zawierać żadnych przestrzeni ani znaków specjalnych. order_id musi być unikalny na faktach handlowych/statycznych portfelach/płatnościach nawrotówKiedy znajdziemy istniejącą fakturę z order_id , zwracamy jego szczegóły, nie zostanie utworzona nowa faktura.
url_callback	stringmin: 6max: 255url	null	URL, do którego Webhook zostanie wysłany po każdym doładowaniu portfela
from_referral_code	string	null	Kupiec, który składa żądanie, łączy się z poleceniem według kodu.Na przykład jesteś aplikacją, która generuje faktury za pośrednictwem Cryptomus API, a Twoi klienci to inne sklepy. Wprowadzają swój klucz API i identyfikator handlowy w aplikacji, a ty wysyłasz żądania z ich poświadczeniami i przekazując kod polecający.W ten sposób Twoi klienci stają się poleceniami na koncie kryptomus i otrzymasz dochód z ich obrotu.

Typ parametru

string

Definicja

Kod waluty

Typ parametru

string

Definicja

Kod sieci Blockchain

Typ parametru

stringmin: 1max: 100alpha_dash

Definicja

Zamów identyfikator w twoim systemieParametr powinien być łańcuchem składającym się z znaków alfabetycznych, liczb, podkreśleń i dystansów. Nie powinien zawierać żadnych przestrzeni ani znaków specjalnych. order_id musi być unikalny na faktach handlowych/statycznych portfelach/płatnościach nawrotówKiedy znajdziemy istniejącą fakturę z order_id , zwracamy jego szczegóły, nie zostanie utworzona nowa faktura.

Typ parametru

stringmin: 6max: 255url

Definicja

URL, do którego Webhook zostanie wysłany po każdym doładowaniu portfela

Typ parametru

string

Definicja

Kupiec, który składa żądanie, łączy się z poleceniem według kodu.Na przykład jesteś aplikacją, która generuje faktury za pośrednictwem Cryptomus API, a Twoi klienci to inne sklepy.
Wprowadzają swój klucz API i identyfikator handlowy w aplikacji, a ty wysyłasz żądania z ich poświadczeniami i przekazując kod polecający.W ten sposób Twoi klienci stają się poleceniami na koncie kryptomus i otrzymasz dochód z ich obrotu.

* - obowiązkowy parametr

Przykład żądania


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

KOPIUJ

Odpowiedź

Parametry odpowiedzi

Nazwa	Definicja
wallet_uuid	uuid z portfela
uuid	UUID portfela w określonej sieci
address	Adres portfela w określonej sieci
network	Kod sieciowy portfela
currency	Waluta sieciowa w portfelu
url	Link do formularza płatności

: Definicja
uuid z portfela
: Definicja
UUID portfela w określonej sieci
: Definicja
Adres portfela w określonej sieci
: Definicja
Kod sieciowy portfela
: Definicja
Waluta sieciowa w portfelu
: Definicja
Link do formularza płatności

Przykład odpowiedzi


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}

KOPIUJ

Możliwe błędy

Błędy walidacji

kod : 422

Przykładowe odpowiedzi:

Jeśli wymagany jest jakiś parametr i nie jest przekazany:


1{
2	"state": 1,
3	"errors": {
4		"currency": ["validation.required"]
5	}
6}

KOPIUJ

Jeśli twoje płatności są zablokowane. W takim przypadku musisz skontaktować się z wsparciem.


1{
2    "state": 1,
3    "message": "You are forbidden"
4}
5

KOPIUJ

Jeśli nie znajdziemy usługi płatności z currency i Network :


1{
2    "state": 1,
3    "message": "The service was not found"
4}

KOPIUJ

Jeśli nastąpi praca techniczna, a płatność jest tymczasowo niedostępna, możesz otrzymać ten komunikat o błędzie:


1{
2    "state": 1,
3    "message": "The terminal was not found"
4}

KOPIUJ


1{
2    "state": 1,
3    "message": "Server error"
4}

KOPIUJ


1{
2    "state": 1,
3    "message": "Wallet not found"
4}

KOPIUJ