Transakcje

get
https://api.cryptomus.com/v2/user-api/transaction/list
KOPIUJ

Wniosek

Parametry zapytania

NazwaDefinicja
date_fromfiltrowanie według daty utworzenia, od (format: „RRRR-MM-DD H:mm:ss”)
date_tofiltrowanie według daty utworzenia, do (format: „RRRR-MM-DD H:mm:ss”)
typeTyp transakcji

Definicja

filtrowanie według daty utworzenia, od (format: „RRRR-MM-DD H:mm:ss”)

Definicja

filtrowanie według daty utworzenia, do (format: „RRRR-MM-DD H:mm:ss”)

Definicja

Typ transakcji

Przykład żądania


curl https://api.cryptomus.com/v2/user-api/transaction/list \
    -X POST \
    -H 'userId: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: fe99035f86fa436181717b302b95bacff1' \
    -H 'Content-Type: application/json' \
    -d '{
    "date_from": "2023-05-16 00:00:00"
    "date_to": "2023-05-16 23:59:59"
    "type": "payment"
  }'
KOPIUJ

Typy

Typy żądań

NazwaDefinicja
paymentTransakcje płatnicze
payoutTransakcje wypłat
transferPrzelew z/do transakcji portfela biznesowego

Definicja

Transakcje płatnicze

Definicja

Transakcje wypłat

Definicja

Przelew z/do transakcji portfela biznesowego

Odpowiedź

Parametry odpowiedzi

NazwaDefinicja
items Struktura
paginate Struktura

Definicja

Struktura

Definicja

Struktura

Parametry odpowiedzi elementów

NazwaDefinicja
uuidUUID transakcji
typeTyp transakcji
status Struktura
amountKwota
amount_equivalentKwota w ekwiwalencie
currency_equivalentKwota stanowiąca równowartość w walucie (waluta ustawiona na Twoim koncie osobistym)
currencyKod waluty
commentKomentarz
networkKod sieci Blockchain
addressAdres portfela do płatności
txidHash transakcji
created_atCzas transakcji

Definicja

UUID transakcji

Definicja

Typ transakcji

Definicja

Struktura

Definicja

Kwota

Definicja

Kwota w ekwiwalencie

Definicja

Kwota stanowiąca równowartość w walucie (waluta ustawiona na Twoim koncie osobistym)

Definicja

Kod waluty

Definicja

Komentarz

Definicja

Kod sieci Blockchain

Definicja

Adres portfela do płatności

Definicja

Hash transakcji

Definicja

Czas transakcji

Parametry odpowiedzi paginacji

NazwaDefinicja
countLiczba elementów na bieżącej stronie
hasPagesCzy istnieje wystarczająca liczba elementów, aby podzielić na wiele stron (prawda / fałsz)
nextCursorKursor na następną stronę
previousCursorKursor do poprzedniej strony
perPageMaksymalna liczba elementów na stronę

Definicja

Liczba elementów na bieżącej stronie

Definicja

Czy istnieje wystarczająca liczba elementów, aby podzielić na wiele stron (prawda / fałsz)

Definicja

Kursor na następną stronę

Definicja

Kursor do poprzedniej strony

Definicja

Maksymalna liczba elementów na stronę

Parametry odpowiedzi na stan

NazwaDefinicja
checkOczekiwanie na pojawienie się transakcji na blockchainie
paidTransakcja przebiegła pomyślnie
failBłąd transakcji
cancelTransakcja anulowana
lockedFundusze są zablokowane z powodu programu AML

Definicja

Oczekiwanie na pojawienie się transakcji na blockchainie

Definicja

Transakcja przebiegła pomyślnie

Definicja

Błąd transakcji

Definicja

Transakcja anulowana

Definicja

Fundusze są zablokowane z powodu programu AML

Aby uzyskać rekordy następnej/poprzedniej strony, w parametrach zapytania określ skrót kursora następnego/poprzedniego (?cursor=<nextCursorHash>)

Przykład:


curl https://api.cryptomus.com/v2/user-api/transaction/list?cursor=eyJpZCI6MjEyLCJ fcG9pbnRzVzVG9OZhXh0SXRlbXMiOnRydWV9 \
    -X POST \
    -H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
    -H 'sign: f80fa426a89eb62bd53997326865d850' \
    -H 'Content-Type: application/json' \
    -d '{}'
KOPIUJ

Przykład odpowiedzi


1{
2  "state": 0,
3  "result": {
4    "items": [
5      {
6        "uuid": "3a3efbe5-4835-48f3-95c0-7b63e2c8a0b6",
7        "type": "transfer",
8        "status": "paid",
9        "created_at": "2022-07-22T15:11:46.000000Z",
10        "amount": "10.00",
11        "amount_equivalent": "10.1679",
12        "currency_equivalent": "USD",
13        "currency": "USDT",
14        "network": null,
15        "txid": null,
16        "address": null,
17        "comment": null
18      },
19      {
20        "uuid": "d4953ea1-6f55-46f1-b1c9-f72c04badc45",
21        "type": "payout",
22        "status": "paid",
23        "created_at": "2022-09-01T14:46:44.000000Z",
24        "amount": "10.00",
25        "amount_equivalent": "10.1679",
26        "currency_equivalent": "USD",
27        "currency": "USDT",
28        "network": "tron",
29        "txid": null,
30        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
31        "comment": null
32      },
33      {
34        "uuid": "690f745a-6b0c-42e1-a6ee-0de34485cab7",
35        "type": "payment",
36        "status": "fail",
37        "created_at": "2022-09-02T08:32:03.000000Z",
38        "amount": "2.00",
39        "amount_equivalent": "10.63359",
40        "currency_equivalent": "USD",
41        "currency": "USDT",
42        "network": "tron",
43        "txid": null,
44        "address": "TSV1JBNzp71tucPrEsRPG5iLD1DkftzWzF",
45        "comment": null
46      }
47    ],
48    "paginate": {
49      "count": 3,
50      "hasPages": true,
51      "nextCursor": "eyJpdiI6IlFIZnd5Lzd0VUN3TGtUNUF6ckV5TEE9PSIsInZhbHVlIjoiUHcvZm1rWmRqdDVKL25NMW5EVEQ1OW9JS0NiSjhJcHd1byt5SGhmVG95UjhGaUlCa3djT1ZSOU5Lc29Id3B3bC80T0VBSnhhZEZBWk1yZUN5RTByN2pKK0dNVUZ0QnFlcThwMU93d0NSR2pXMHJOQWZIa3N6cStmT0YxOG9VVDJyT1Q2NmVhbU9JU1N6cTJsM3JLTitRPT0iLCJtYWMiOiI2M2E4OWVmZTk3MDNjYzUwNjY0ZWY4ZjcxMjUyOGUzMmI4NzNkNWU4YzNlYmUxNmNmMThhM2JhN2RjNTkyYjgxIiwidGFnIjoiIn0=",
52      "previousCursor": null,
53      "perPage": 15
54    }
55  }
56}
57
KOPIUJ