交易
get
https://api.cryptomus.com/v2/user-api/transaction/list
要求
查詢參數
| 姓名 | 定義 |
|---|---|
| date_from | 按建立日期過濾，來自（格式：「YYYY-MM-DD H:mm:ss」） |
| date_to | 依建立日期過濾，格式為：“YYYY-MM-DD H:mm:ss” |
| type | 交易類型 |
定義
按建立日期過濾，來自（格式：「YYYY-MM-DD H:mm:ss」）定義
依建立日期過濾，格式為：“YYYY-MM-DD H:mm:ss”定義
交易類型
請求範例
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 | 從/到企業錢包交易的轉賬 |
定義
支付交易定義
支付交易定義
從/到企業錢包交易的轉賬
回覆
響應參數
商品響應參數
| 姓名 | 定義 |
|---|---|
| uuid | 交易UUID |
| type | 交易類型 |
| status | 結構 |
| amount | 數量 |
| amount_equivalent | 等值金額 |
| currency_equivalent | 等值貨幣金額（您個人帳戶中設定的貨幣） |
| currency | 貨幣代碼 |
| comment | 評論 |
| network | 區塊鏈網路程式碼 |
| address | 支付錢包地址 |
| txid | 交易哈希 |
| created_at | 交易時間 |
定義
交易UUID定義
交易類型定義
結構定義
數量定義
等值金額定義
等值貨幣金額（您個人帳戶中設定的貨幣）定義
貨幣代碼定義
評論定義
區塊鏈網路程式碼定義
支付錢包地址定義
交易哈希定義
交易時間
分頁回應參數
| 姓名 | 定義 |
|---|---|
| count | 目前頁面上的項目數 |
| hasPages | 是否有足夠的元素來拆分成多個頁面（true / false） |
| nextCursor | 遊標移至下一頁 |
| previousCursor | 遊標移至上一頁 |
| perPage | 每頁最大元素數 |
定義
目前頁面上的項目數定義
是否有足夠的元素來拆分成多個頁面（true / false）定義
遊標移至下一頁定義
遊標移至上一頁定義
每頁最大元素數
狀態響應參數
| 姓名 | 定義 |
|---|---|
| check | 等待交易出現在區塊鏈上 |
| paid | 交易成功 |
| fail | 交易錯誤 |
| cancel | 交易已取消 |
| locked | 由於反洗錢計劃，資金被鎖定 |
定義
等待交易出現在區塊鏈上定義
交易成功定義
交易錯誤定義
交易已取消定義
由於反洗錢計劃，資金被鎖定
若要取得下一頁/上一頁的記錄，請在查詢參數中指定下一頁/上一頁遊標哈希 (?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