Giao dịch

get
https://api.cryptomus.com/v2/user-api/transaction/list
Sao chép

Lời yêu cầu

Tham số truy vấn

TênSự định nghĩa
date_fromlọc theo ngày tạo, từ (định dạng: "YYYY-MM-DD H:mm:ss")
date_tolọc theo ngày tạo, thành (định dạng: "YYYY-MM-DD H:mm:ss")
typeLoại giao dịch

Sự định nghĩa

lọc theo ngày tạo, từ (định dạng: "YYYY-MM-DD H:mm:ss")

Sự định nghĩa

lọc theo ngày tạo, thành (định dạng: "YYYY-MM-DD H:mm:ss")

Sự định nghĩa

Loại giao dịch

Ví dụ yêu cầu


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"
  }'
Sao chép

Các loại

Các loại yêu cầu

TênSự định nghĩa
paymentGiao dịch thanh toán
payoutGiao dịch thanh toán
transferChuyển từ/đến giao dịch ví doanh nghiệp

Sự định nghĩa

Giao dịch thanh toán

Sự định nghĩa

Giao dịch thanh toán

Sự định nghĩa

Chuyển từ/đến giao dịch ví doanh nghiệp

Phản ứng

Các thông số phản hồi

TênSự định nghĩa
items Kết cấu
paginate Kết cấu

Sự định nghĩa

Kết cấu

Sự định nghĩa

Kết cấu

Các tham số phản hồi của mục

TênSự định nghĩa
uuidUUID giao dịch
typeLoại giao dịch
status Kết cấu
amountSố lượng
amount_equivalentSố tiền tương đương
currency_equivalentSố tiền tương đương (Tiền tệ được thiết lập trong tài khoản cá nhân của bạn)
currencyMã tiền tệ
commentBình luận
networkMã mạng Blockchain
addressĐịa chỉ ví để thanh toán
txidBăm giao dịch
created_atThời gian giao dịch

Sự định nghĩa

UUID giao dịch

Sự định nghĩa

Loại giao dịch

Sự định nghĩa

Kết cấu

Sự định nghĩa

Số lượng

Sự định nghĩa

Số tiền tương đương

Sự định nghĩa

Số tiền tương đương (Tiền tệ được thiết lập trong tài khoản cá nhân của bạn)

Sự định nghĩa

Mã tiền tệ

Sự định nghĩa

Bình luận

Sự định nghĩa

Mã mạng Blockchain

Sự định nghĩa

Địa chỉ ví để thanh toán

Sự định nghĩa

Băm giao dịch

Sự định nghĩa

Thời gian giao dịch

Phân trang các tham số phản hồi

TênSự định nghĩa
countSố lượng mục trên trang hiện tại
hasPagesCó đủ các thành phần để chia thành nhiều trang hay không (đúng / sai)
nextCursorCon trỏ đến trang tiếp theo
previousCursorCon trỏ đến trang trước
perPageSố lượng phần tử tối đa trên mỗi trang

Sự định nghĩa

Số lượng mục trên trang hiện tại

Sự định nghĩa

Có đủ các thành phần để chia thành nhiều trang hay không (đúng / sai)

Sự định nghĩa

Con trỏ đến trang tiếp theo

Sự định nghĩa

Con trỏ đến trang trước

Sự định nghĩa

Số lượng phần tử tối đa trên mỗi trang

Tham số phản hồi trạng thái

TênSự định nghĩa
checkĐang chờ giao dịch xuất hiện trên blockchain
paidGiao dịch đã thành công
failLỗi giao dịch
cancelGiao dịch đã bị hủy
lockedTiền bị khóa do chương trình AML

Sự định nghĩa

Đang chờ giao dịch xuất hiện trên blockchain

Sự định nghĩa

Giao dịch đã thành công

Sự định nghĩa

Lỗi giao dịch

Sự định nghĩa

Giao dịch đã bị hủy

Sự định nghĩa

Tiền bị khóa do chương trình AML

Để lấy các bản ghi của trang tiếp theo/trước đó, hãy chỉ định băm con trỏ tiếp theo/trước đó trong các tham số truy vấn (?cursor=<nextCursorHash>)

Ví dụ:


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 '{}'
Sao chép

Ví dụ phản hồi


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
Sao chép