Giao dịch

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

Lời yêu cầu

Tham số truy vấn

TênKiểu tham sốSự định nghĩa
date_fromstringlọc theo ngày tạo, từ (định dạng: "YYYY-MM-DD H:mm:ss")
date_tostringlọc theo ngày tạo, thành (định dạng: "YYYY-MM-DD H:mm:ss")
typestringLoại giao dịch

Kiểu tham số

string

Sự định nghĩa

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

Kiểu tham số

string

Sự định nghĩa

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

Kiểu tham số

string

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ênKiểu tham sốSự định nghĩa
itemsarray Kết cấu
paginateobject Kết cấu

Kiểu tham số

array

Sự định nghĩa

Kết cấu

Kiểu tham số

object

Sự định nghĩa

Kết cấu

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

TênKiểu tham sốSự định nghĩa
uuidstringUUID giao dịch
typestringLoại giao dịch
statusstring|null Kết cấu
created_atstringThời gian giao dịch
amountstringSố lượng
amount_equivalentstring|nullSố tiền tương đương
currency_equivalentstring|nullSố 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)
currencystringMã tiền tệ
networkstring|nullMã mạng Blockchain
txidstring|nullBăm giao dịch
addressstring|nullĐịa chỉ ví để thanh toán
commentstring|nullBình luận

Kiểu tham số

string

Sự định nghĩa

UUID giao dịch

Kiểu tham số

string

Sự định nghĩa

Loại giao dịch

Kiểu tham số

string|null

Sự định nghĩa

Kết cấu

Kiểu tham số

string

Sự định nghĩa

Thời gian giao dịch

Kiểu tham số

string

Sự định nghĩa

Số lượng

Kiểu tham số

string|null

Sự định nghĩa

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

Kiểu tham số

string|null

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)

Kiểu tham số

string

Sự định nghĩa

Mã tiền tệ

Kiểu tham số

string|null

Sự định nghĩa

Mã mạng Blockchain

Kiểu tham số

string|null

Sự định nghĩa

Băm giao dịch

Kiểu tham số

string|null

Sự định nghĩa

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

Kiểu tham số

string|null

Sự định nghĩa

Bình luận

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

TênKiểu tham sốSự định nghĩa
countintegerSố lượng mục trên trang hiện tại
hasPagesbooleanCó đủ các thành phần để chia thành nhiều trang hay không (đúng / sai)
nextCursorstring|nullCon trỏ đến trang tiếp theo
previousCursorstring|nullCon trỏ đến trang trước
perPageintegerSố lượng phần tử tối đa trên mỗi trang

Kiểu tham số

integer

Sự định nghĩa

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

Kiểu tham số

boolean

Sự định nghĩa

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

Kiểu tham số

string|null

Sự định nghĩa

Con trỏ đến trang tiếp theo

Kiểu tham số

string|null

Sự định nghĩa

Con trỏ đến trang trước

Kiểu tham số

integer

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