Historia wypłaty
Wniosek
Parametry zapytania
| Nazwa | Typ parametru | Domyślna wartość | Definicja |
|---|---|---|---|
| date_from | stringformat: YYYY-MM-DD H:mm:ss | null | Filtrowanie według daty stworzenia, od |
| date_to | stringformat: YYYY-MM-DD H:mm:ss | null | Filtrowanie według daty stworzenia, do |
Typ parametru
stringformat: YYYY-MM-DD H:mm:ssDomyślna wartość
nullDefinicja
Filtrowanie według daty stworzenia, odTyp parametru
stringformat: YYYY-MM-DD H:mm:ssDomyślna wartość
nullDefinicja
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'
KopiaAby 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"
}'KopiaOdpowiedź
Parametry odpowiedzi
| Nazwa | Typ parametru | Definicja |
|---|---|---|
| merchant_uuid | string | UUID Merchant |
| items | Tablica wypłat. Struktura | |
| paginate | Dane dotyczące paginacji. Struktura |
Typ parametru
stringDefinicja
UUID Merchant
Struktura przedmiot
| Nazwa | Typ parametru | Definicja |
|---|---|---|
| uuid | string | uuid wypłaty |
| amount | string | Kwota wypłaty w currency |
| currency | string | Kod waluty wypłaty |
| network | string|null | Kod sieci Blockchain, w której dokonywana jest wypłata |
| payer_currency | string|null | Kod kryptowaluty, w którym faktycznie zostanie wykonana wypłata. Adres wypłaty otrzyma walutę wypłat. |
| payer_amount | string|null | Kwota w Payer_Currency wypłaty. |
| address | string | Adres portfela, do którego dokonana jest płatność |
| txid | string|null | ID transakcji w blockchain |
| status | string | Status wypłaty statusy |
| payment_status | string | Status płatności |
| is_final | boolean | 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. |
| balance | string|null | Pozostałe fundusze na portfelu handlowca. |
| order_id | string|null | Zamów identyfikator w twoim systemie |
| commission | string|null | Kwota Komisji Cryptomus |
| merchant_amount | string|null | Kwota, która jest pobierana z salda sprzedawcy, w tym wszystkie prowizje. |
| created_at | string|null | Data utworzenia wypłaty. Strefa czasowa to UTC+3 |
| updated_at | string|null | Ostatnia wypłata zaktualizowana. Strefa czasowa to UTC+3 |
| convert | 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 | |
| convert.to_currency | string|null | Kod waluty, do którego płatność zostanie przekonwertowana |
| convert.from_currency | string | Z waluty |
| convert.commission | string | Opłata za konwersję |
| convert.rate | string|null | Współczynnik konwersji |
| convert.from_amount | string|null | Kwota od |
Typ parametru
stringDefinicja
uuid wypłatyTyp parametru
stringDefinicja
Kwota wypłaty w currencyTyp parametru
stringDefinicja
Kod waluty wypłatyTyp parametru
string|nullDefinicja
Kod sieci Blockchain, w której dokonywana jest wypłataTyp parametru
string|nullDefinicja
Kod kryptowaluty, w którym faktycznie zostanie wykonana wypłata. Adres wypłaty otrzyma walutę wypłat.Typ parametru
string|nullDefinicja
Kwota w Payer_Currency wypłaty.Typ parametru
stringDefinicja
Adres portfela, do którego dokonana jest płatnośćTyp parametru
string|nullDefinicja
ID transakcji w blockchainTyp parametru
stringTyp parametru
stringDefinicja
Status płatnościTyp parametru
booleanDefinicja
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|nullDefinicja
Pozostałe fundusze na portfelu handlowca.Typ parametru
string|nullDefinicja
Zamów identyfikator w twoim systemieTyp parametru
string|nullDefinicja
Kwota Komisji CryptomusTyp parametru
string|nullDefinicja
Kwota, która jest pobierana z salda sprzedawcy, w tym wszystkie prowizje.Typ parametru
string|nullDefinicja
Data utworzenia wypłaty. Strefa czasowa to UTC+3Typ parametru
string|nullDefinicja
Ostatnia wypłata zaktualizowana. Strefa czasowa to UTC+3Definicja
Informacje o walucie, do której płatność zostanie automatycznie przekonwertowana. Konwersja odbywa się z płatnika_currency do USDTObecny, jeśli przekazano from_currencyTyp parametru
string|nullDefinicja
Kod waluty, do którego płatność zostanie przekonwertowanaTyp parametru
stringDefinicja
Z walutyTyp parametru
stringDefinicja
Opłata za konwersjęTyp parametru
string|nullDefinicja
Współczynnik konwersjiTyp parametru
string|nullDefinicja
Kwota od
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' \
6KopiaPrzykł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}KopiaMoż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