Транзакции

post https://api.cryptomus.com/v2/user-api/transaction/list Скопировать

Запрос

Параметры запроса

ИмяТип параметраОписание
date_fromstringфильтрация по дате создания, от (формат: "ГГГГ-ММ-ДД Ч:мм:сс")
date_tostringфильтрация по дате создания, по (формат: «ГГГГ-ММ-ДД Ч:мм:сс»)
typestringТип транзакции

Тип параметра

string

Описание

фильтрация по дате создания, от (формат: "ГГГГ-ММ-ДД Ч:мм:сс")

Тип параметра

string

Описание

фильтрация по дате создания, по (формат: «ГГГГ-ММ-ДД Ч:мм:сс»)

Тип параметра

string

Описание

Тип транзакции

Пример запроса


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"
  }'
Скопировать

Типы

Типы запросов

ИмяОписание
paymentПлатежные операции
payoutОперации по выплатам
transferПеревод с/на транзакции Бизнес-кошелька

Описание

Платежные операции

Описание

Операции по выплатам

Описание

Перевод с/на транзакции Бизнес-кошелька

Ответ

Параметры отклика

ИмяТип параметраОписание
itemsarray Структура
paginateobject Структура

Тип параметра

array

Описание

Структура

Тип параметра

object

Описание

Структура

Параметры ответа на элементы

ИмяТип параметраОписание
uuidstringUUID транзакции
typestringТип транзакции
statusstring|null Структура
created_atstringВремя транзакции
amountstringКоличество
amount_equivalentstring|nullСумма в эквиваленте
currency_equivalentstring|nullСумма в валютном эквиваленте (Валюта, указанная в личном кабинете)
currencystringКод валюты
networkstring|nullСетевой код блокчейна
txidstring|nullХэш транзакции
addressstring|nullАдрес кошелька для оплаты
commentstring|nullКомментарий

Тип параметра

string

Описание

UUID транзакции

Тип параметра

string

Описание

Тип транзакции

Тип параметра

string|null

Описание

Структура

Тип параметра

string

Описание

Время транзакции

Тип параметра

string

Описание

Количество

Тип параметра

string|null

Описание

Сумма в эквиваленте

Тип параметра

string|null

Описание

Сумма в валютном эквиваленте (Валюта, указанная в личном кабинете)

Тип параметра

string

Описание

Код валюты

Тип параметра

string|null

Описание

Сетевой код блокчейна

Тип параметра

string|null

Описание

Хэш транзакции

Тип параметра

string|null

Описание

Адрес кошелька для оплаты

Тип параметра

string|null

Описание

Комментарий

Параметры ответа на страницы

ИмяТип параметраОписание
countintegerКоличество элементов на текущей странице
hasPagesbooleanДостаточно ли элементов для разделения на несколько страниц (true / false)
nextCursorstring|nullКурсор на следующую страницу
previousCursorstring|nullКурсор на предыдущую страницу
perPageintegerМаксимальное количество элементов на странице

Тип параметра

integer

Описание

Количество элементов на текущей странице

Тип параметра

boolean

Описание

Достаточно ли элементов для разделения на несколько страниц (true / false)

Тип параметра

string|null

Описание

Курсор на следующую страницу

Тип параметра

string|null

Описание

Курсор на предыдущую страницу

Тип параметра

integer

Описание

Максимальное количество элементов на странице

Параметры ответа на статус

ИмяОписание
checkОжидание появления транзакции в блокчейне
paidТранзакция прошла успешно
failОшибка транзакции
cancelТранзакция отменена
lockedСредства заблокированы из-за программы AML

Описание

Ожидание появления транзакции в блокчейне

Описание

Транзакция прошла успешно

Описание

Ошибка транзакции

Описание

Транзакция отменена

Описание

Средства заблокированы из-за программы AML

Чтобы получить записи следующей/предыдущей страницы, укажите в параметрах запроса хеш следующего/предыдущего курсора. (?cursor=<nextCursorHash>)

Пример:


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 '{}'
Скопировать

Пример ответа


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      
Скопировать