транзакції

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Мережевий код Blockchain
txidstring|nullХеш транзакції
addressstring|nullАдреса гаманця для оплати
commentstring|nullКоментар

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

string

Визначення

UUID транзакції

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

string

Визначення

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

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

string|null

Визначення

Структура

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

string

Визначення

Час транзакції

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

string

Визначення

Сума

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

string|null

Визначення

Сума в еквіваленті

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

string|null

Визначення

Валютний еквівалент (Валюта, встановлена ​​в особистому кабінеті)

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

string

Визначення

Валютний код

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

string|null

Визначення

Мережевий код Blockchain

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

string|null

Визначення

Хеш транзакції

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

string|null

Визначення

Адреса гаманця для оплати

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

string|null

Визначення

Коментар

Параметри відповіді на сторінки

НазваТип параметраВизначення
countintegerКількість елементів на поточній сторінці
hasPagesbooleanЧи достатньо елементів, щоб розділити на кілька сторінок (правда / хибна)
nextCursorstring|nullКурсор на наступну сторінку
previousCursorstring|nullКурсор на попередню сторінку
perPageintegerМаксимальна кількість елементів на сторінку

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

integer

Визначення

Кількість елементів на поточній сторінці

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

boolean

Визначення

Чи достатньо елементів, щоб розділити на кілька сторінок (правда / хибна)

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

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      
Копія