Lịch sử thanh toán
post
https://api.cryptomus.com/v1/payout/list
Lời yêu cầu
Tham số truy vấn
| Tên | Kiểu tham số | Giá trị mặc định | Sự định nghĩa |
|---|---|---|---|
| date_from | stringformat: YYYY-MM-DD H:mm:ss | null | Lọc theo ngày tạo, từ |
| date_to | stringformat: YYYY-MM-DD H:mm:ss | null | Lọc theo ngày tạo, để |
Kiểu tham số
stringformat: YYYY-MM-DD H:mm:ssSự định nghĩa
Lọc theo ngày tạo, từKiểu tham số
stringformat: YYYY-MM-DD H:mm:ssSự định nghĩa
Lọc theo ngày tạo, để
Ví dụ yêu cầu
curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json'
Để lọc khoản thanh toán theo ngày tạo từ ngày 4 tháng 5 đến ngày 16 tháng 5.
curl https://api.cryptomus.com/v1/payout/list \
-X POST \
-H 'merchant: 8b03432e-385b-4670-8d06-064591096795' \
-H 'sign: f80fa426a89eb62bd53997326865d850' \
-H 'Content-Type: application/json' \
-d '{
"date_from": "2023-05-04 00:00:00"
"date_to": "2023-05-16 23:59:59"
}'Phản ứng
Các thông số phản hồi
| Tên | Sự định nghĩa |
|---|---|
| merchant_uuid | Uuid của thương gia |
| items | Mảng thanh toán. Kết cấu |
| paginate | Dữ liệu để phân trang. Kết cấu |
Cấu trúc của mục
| Tên | Sự định nghĩa |
|---|---|
| uuid | uuid của khoản thanh toán |
| amount | Số tiền thanh toán bằng tiền tệ |
| currency | Mã tiền tệ để thanh toán |
| network | Mã của mạng blockchain trong đó khoản thanh toán được thực hiện |
| address | Địa chỉ ví mà khoản thanh toán được thực hiện |
| txid | ID giao dịch trong chuỗi khối |
| status | Trạng thái thanh toán trạng thái |
| is_final | Việc thanh toán đã được hoàn tất chưaQuá trình thanh toán được coi là hoàn tất khi giao dịch đã được thanh toán thành công hoặc thất bại. Trong trường hợp thanh toán không thành công, tiền sẽ được hoàn lại vào số dư của bạn, yêu cầu bạn phải thực hiện lại quy trình thanh toán. |
| balance | Số tiền còn lại trong ví của người bán. |
| created_at | Ngày tạo khoản thanh toán. Múi giờ là UTC+3 |
| updated_at | Ngày cập nhật thanh toán gần nhất. Múi giờ là UTC+3 |
Sự định nghĩa
uuid của khoản thanh toánSự định nghĩa
Số tiền thanh toán bằng tiền tệSự định nghĩa
Mã tiền tệ để thanh toánSự định nghĩa
Mã của mạng blockchain trong đó khoản thanh toán được thực hiệnSự định nghĩa
Địa chỉ ví mà khoản thanh toán được thực hiệnSự định nghĩa
ID giao dịch trong chuỗi khốiSự định nghĩa
Trạng thái thanh toán trạng tháiSự định nghĩa
Việc thanh toán đã được hoàn tất chưaQuá trình thanh toán được coi là hoàn tất khi giao dịch đã được thanh toán thành công hoặc thất bại. Trong trường hợp thanh toán không thành công, tiền sẽ được hoàn lại vào số dư của bạn, yêu cầu bạn phải thực hiện lại quy trình thanh toán.Sự định nghĩa
Số tiền còn lại trong ví của người bán.Sự định nghĩa
Ngày tạo khoản thanh toán. Múi giờ là UTC+3Sự định nghĩa
Ngày cập nhật thanh toán gần nhất. Múi giờ là UTC+3
Để có được các mục 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ụ:
1curl https://api.cryptomus.com/v1/payout/list?cursor=eyJpZCI6MjEyLCJf cG9pbnRzVzVG9OZXh0SXRlbXMiOnRydWV9 \
2-X POST \
3-H 'merchant: cb2131ff-a3d4-46dd-94c6-3714fae65f89' \
4-H 'sign: f80fa426a89eb62bd53997326865d850' \
5-H 'Content-Type: application/json' \
6Ví dụ phản hồi
1{
2"state": 0,
3"result": {
4 "items": [{
5 "uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
6 "amount": "3",
7 "currency": "USDT",
8 "network": "TRON",
9 "address": "TJ...",
10 "txid": null,
11 "status": "process",
12 "is_final": false,
13 "balance": "129.00000000",
14 "created_at": "2023-06-21T17:25:55+03:00",
15 "updated_at": "2023-06-21T17:34:38+03:00"
16 }, {
17 "uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
18 "amount": "5.40000000",
19 "currency": "DOGE",
20 "network": "doge",
21 "address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
22 "txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
23 "order_id": null,
24 "payment_status": null,
25 "status": "paid",
26 "is_final": true,
27 "balance": "26.77966652",
28 "created_at": "2023-07-21T17:25:55+03:00",
29 "updated_at": "2023-07-21T17:34:38+03:00"
30 },
31 ...
32 ],
33 "paginate": {
34 "count": 15,
35 "hasPages": true,
36 "nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
37 "previousCursor": null,
38 "perPage": 15
39 }
40}
41}Lỗi có thể xảy ra
Lỗi xác thực
mã số : 422
ví dụ phản hồi:
Nếu tham số date_from hoặc date_to được truyền theo định dạng không đúng.
1{
2 "state": 1,
3 "errors": {
4 "date_from": ["validation.regex"]
5 }
6}