Transakcje

post https://api.cryptomus.com/v2/user-api/transaction/list Kopia

Wniosek

Parametry zapytania

NazwaTyp parametruDefinicja
date_fromstringfiltrowanie według daty utworzenia, od (format: „RRRR-MM-DD H:mm:ss”)
date_tostringfiltrowanie według daty utworzenia, do (format: „RRRR-MM-DD H:mm:ss”)
typestringTyp transakcji

Typ parametru

string

Definicja

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

Typ parametru

string

Definicja

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

Typ parametru

string

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

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

NazwaTyp parametruDefinicja
itemsarray Struktura
paginateobject Struktura

Typ parametru

array

Definicja

Struktura

Typ parametru

object

Definicja

Struktura

Parametry odpowiedzi elementów

NazwaTyp parametruDefinicja
uuidstringUUID transakcji
typestringTyp transakcji
statusstring|null Struktura
created_atstringCzas transakcji
amountstringKwota
amount_equivalentstring|nullKwota w ekwiwalencie
currency_equivalentstring|nullKwota stanowiąca równowartość w walucie (waluta ustawiona na Twoim koncie osobistym)
currencystringKod waluty
networkstring|nullKod sieci Blockchain
txidstring|nullHash transakcji
addressstring|nullAdres portfela do płatności
commentstring|nullKomentarz

Typ parametru

string

Definicja

UUID transakcji

Typ parametru

string

Definicja

Typ transakcji

Typ parametru

string|null

Definicja

Struktura

Typ parametru

string

Definicja

Czas transakcji

Typ parametru

string

Definicja

Kwota

Typ parametru

string|null

Definicja

Kwota w ekwiwalencie

Typ parametru

string|null

Definicja

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

Typ parametru

string

Definicja

Kod waluty

Typ parametru

string|null

Definicja

Kod sieci Blockchain

Typ parametru

string|null

Definicja

Hash transakcji

Typ parametru

string|null

Definicja

Adres portfela do płatności

Typ parametru

string|null

Definicja

Komentarz

Parametry odpowiedzi paginacji

NazwaTyp parametruDefinicja
countintegerLiczba elementów na bieżącej stronie
hasPagesbooleanCzy istnieje wystarczająca liczba elementów, aby podzielić na wiele stron (prawda / fałsz)
nextCursorstring|nullKursor na następną stronę
previousCursorstring|nullKursor do poprzedniej strony
perPageintegerMaksymalna liczba elementów na stronę

Typ parametru

integer

Definicja

Liczba elementów na bieżącej stronie

Typ parametru

boolean

Definicja

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

Typ parametru

string|null

Definicja

Kursor na następną stronę

Typ parametru

string|null

Definicja

Kursor do poprzedniej strony

Typ parametru

integer

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 '{}'
Kopia

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      
Kopia