Historia wypłaty

post https://api.cryptomus.com/v1/payout/list Kopia

Wniosek

Parametry zapytania

NazwaTyp parametruDomyślna wartośćDefinicja
date_fromstringformat: YYYY-MM-DD H:mm:ssnullFiltrowanie według daty stworzenia, od
date_tostringformat: YYYY-MM-DD H:mm:ssnullFiltrowanie według daty stworzenia, do

Typ parametru

stringformat: YYYY-MM-DD H:mm:ss

Domyślna wartość

null

Definicja

Filtrowanie według daty stworzenia, od

Typ parametru

stringformat: YYYY-MM-DD H:mm:ss

Domyślna wartość

null

Definicja

Filtrowanie według daty stworzenia, do

Przykład żądania


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' 
Kopia

Aby filtrować wypłaty według daty utworzenia od 4 maja do 16 maja.


curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{
	"date_from": "2023-05-04 00:00:00",
	"date_to": "2023-05-16 23:59:59"
}'
Kopia

Odpowiedź

Parametry odpowiedzi

NazwaTyp parametruDefinicja
merchant_uuidstringUUID Merchant
itemsTablica wypłat. Struktura
paginateDane dotyczące paginacji. Struktura

Typ parametru

string

Definicja

UUID Merchant

Definicja

Tablica wypłat. Struktura

Definicja

Dane dotyczące paginacji. Struktura

Struktura przedmiot

NazwaTyp parametruDefinicja
uuidstringuuid wypłaty
amountstringKwota wypłaty w currency
currencystringKod waluty wypłaty
networkstring|nullKod sieci Blockchain, w której dokonywana jest wypłata
payer_currencystring|nullKod kryptowaluty, w którym faktycznie zostanie wykonana wypłata. Adres wypłaty otrzyma walutę wypłat.
payer_amountstring|nullKwota w Payer_Currency wypłaty.
addressstringAdres portfela, do którego dokonana jest płatność
txidstring|nullID transakcji w blockchain
statusstringStatus wypłaty statusy
payment_statusstringStatus płatności
is_finalbooleanCzy wypłata jest sfinalizowanaProces wypłaty jest uważany za sfinalizowany po jego pomyślnym opłaceniu lub jeśli się nie udało. W przypadku awarii wypłaty fundusze zostaną zwrócone do twojego salda, wymagające ponownego zainicjowania procesu wypłaty.
balancestring|nullPozostałe fundusze na portfelu handlowca.
order_idstring|nullZamów identyfikator w twoim systemie
commissionstring|nullKwota Komisji Cryptomus
merchant_amountstring|nullKwota, która jest pobierana z salda sprzedawcy, w tym wszystkie prowizje.
created_atstring|nullData utworzenia wypłaty. Strefa czasowa to UTC+3
updated_atstring|nullOstatnia wypłata zaktualizowana. Strefa czasowa to UTC+3
convertInformacje o walucie, do której płatność zostanie automatycznie przekonwertowana. Konwersja odbywa się z płatnika_currency do USDTObecny, jeśli przekazano from_currency
convert.to_currencystring|nullKod waluty, do którego płatność zostanie przekonwertowana
convert.from_currencystringZ waluty
convert.commissionstringOpłata za konwersję
convert.ratestring|nullWspółczynnik konwersji
convert.from_amountstring|nullKwota od

Typ parametru

string

Definicja

uuid wypłaty

Typ parametru

string

Definicja

Kwota wypłaty w currency

Typ parametru

string

Definicja

Kod waluty wypłaty

Typ parametru

string|null

Definicja

Kod sieci Blockchain, w której dokonywana jest wypłata

Typ parametru

string|null

Definicja

Kod kryptowaluty, w którym faktycznie zostanie wykonana wypłata. Adres wypłaty otrzyma walutę wypłat.

Typ parametru

string|null

Definicja

Kwota w Payer_Currency wypłaty.

Typ parametru

string

Definicja

Adres portfela, do którego dokonana jest płatność

Typ parametru

string|null

Definicja

ID transakcji w blockchain

Typ parametru

string

Definicja

Status wypłaty statusy

Typ parametru

string

Definicja

Status płatności

Typ parametru

boolean

Definicja

Czy wypłata jest sfinalizowanaProces wypłaty jest uważany za sfinalizowany po jego pomyślnym opłaceniu lub jeśli się nie udało. W przypadku awarii wypłaty fundusze zostaną zwrócone do twojego salda, wymagające ponownego zainicjowania procesu wypłaty.

Typ parametru

string|null

Definicja

Pozostałe fundusze na portfelu handlowca.

Typ parametru

string|null

Definicja

Zamów identyfikator w twoim systemie

Typ parametru

string|null

Definicja

Kwota Komisji Cryptomus

Typ parametru

string|null

Definicja

Kwota, która jest pobierana z salda sprzedawcy, w tym wszystkie prowizje.

Typ parametru

string|null

Definicja

Data utworzenia wypłaty. Strefa czasowa to UTC+3

Typ parametru

string|null

Definicja

Ostatnia wypłata zaktualizowana. Strefa czasowa to UTC+3

Definicja

Informacje o walucie, do której płatność zostanie automatycznie przekonwertowana. Konwersja odbywa się z płatnika_currency do USDTObecny, jeśli przekazano from_currency

Typ parametru

string|null

Definicja

Kod waluty, do którego płatność zostanie przekonwertowana

Typ parametru

string

Definicja

Z waluty

Typ parametru

string

Definicja

Opłata za konwersję

Typ parametru

string|null

Definicja

Współczynnik konwersji

Typ parametru

string|null

Definicja

Kwota od
Aby uzyskać następne/poprzednie wpisy strony, określ następny/poprzedni skrót kursora w parametrach zapytania (?cursor=nextCursorHash)

Przykład:


1curl https://api.cryptomus.com/v1/payout/list?cursor=eyJpZCI6MjEyLCJf cG9pbnRzVzVG9OZXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: cb2131ff-a3d4-46dd-94c6-3714fae65f89' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6
Kopia

Przykład odpowiedzi


1{
2"state": 0,
3"result": {
4	"merchant_uuid": "8b03432e-385b-4670-8d06-064591096795",
5	"items": [{
6		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
7		"amount": "3",
8		"currency": "USDT",
9		"network": "TRON",
10		"payer_currency": "USDT",
11		"payer_amount": "3",
12		"address": "TJ...",
13		"txid": null,
14		"status": "process",
15		"payment_status": "process",
16		"is_final": false,
17		"balance": "129.00000000",
18		"order_id": "1",
19		"commission": null,
20		"merchant_amount": null,
21		"created_at": "2023-06-21T17:25:55+03:00",
22		"updated_at": "2023-06-21T17:34:38+03:00"
23	}, {
24		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
25		"amount": "5.40000000",
26		"currency": "DOGE",
27		"network": "doge",
28		"payer_currency": "DOGE",
29		"payer_amount": "5.40000000",
30		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
31		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
32		"status": "paid",
33		"payment_status": "paid",
34		"is_final": true,
35		"balance": "26.77966652",
36		"order_id": null,
37		"commission": "0.00000000",
38		"merchant_amount": "5.40000000",
39		"created_at": "2023-07-21T17:25:55+03:00",
40		"updated_at": "2023-07-21T17:34:38+03:00"
41	},
42	...
43	],
44	"paginate": {
45		"count": 15,
46		"hasPages": true,
47		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
48		"previousCursor": null,
49		"perPage": 15
50	}
51}
52}
Kopia

Możliwe błędy

Błędy walidacji

kod : 422

przykładowe odpowiedzi:

Jeśli parametr data_zadu lub data_to jest przekazywany w niewłaściwym formacie.


1{
2	"state": 1,
3	"errors": {
4	"date_from": ["validation.regex"]
5	}
6}
Kopia