Lịch sử thanh toán

post https://api.cryptomus.com/v1/payout/list Sao chép

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:ss
Giá trị mặc định
null
Sự định nghĩa
Lọc theo ngày tạo, từ
: Kiểu tham số
stringformat: YYYY-MM-DD H:mm:ss
Giá trị mặc định
null
Sự đị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'

Sao chép

Để 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"
}'

Sao chép

Phản ứng

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

Tên	Kiểu tham số	Sự định nghĩa
merchant_uuid	string	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

: Kiểu tham số
string
Sự định nghĩa
Uuid của thương gia
: Sự định nghĩa
Mảng thanh toán. Kết cấu
: Sự định nghĩa
Dữ liệu để phân trang. Kết cấu

Cấu trúc của mục

Tên	Kiểu tham số	Sự định nghĩa
uuid	string	uuid của khoản thanh toán
amount	string	Số tiền thanh toán bằng tiền tệ
currency	string	Mã tiền tệ để thanh toán
network	string\|null	Mã của mạng blockchain trong đó khoản thanh toán được thực hiện
payer_currency	string\|null	Mã tiền điện tử mà khoản thanh toán thực tế sẽ được thực hiện. Địa chỉ thanh toán sẽ nhận được loại tiền thanh toán.
payer_amount	string\|null	Số tiền thanh toán bằng tiền_thanh_toán.
address	string	Địa chỉ ví mà khoản thanh toán được thực hiện
txid	string\|null	ID giao dịch trong chuỗi khối
status	string	Trạng thái thanh toán trạng thái
payment_status	string	Trạng thái thanh toán
is_final	boolean	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	string\|null	Số tiền còn lại trong ví của người bán.
order_id	string\|null	ID đơn hàng trong hệ thống của bạn
commission	string\|null	Số tiền hoa hồng của Cryptomus
merchant_amount	string\|null	Số tiền được trừ vào số dư của người bán, bao gồm tất cả hoa hồng.
created_at	string\|null	Ngày tạo khoản thanh toán. Múi giờ là UTC+3
updated_at	string\|null	Ngày cập nhật thanh toán gần nhất. Múi giờ là UTC+3
convert		Thông tin về loại tiền tệ mà khoản thanh toán sẽ được tự động chuyển đổi. Việc chuyển đổi được thực hiện từ payer_currency sang USDTHiển thị nếu tham số from_currency được truyền vào.
convert.to_currency	string\|null	Mã tiền tệ mà khoản thanh toán sẽ được chuyển đổi
convert.from_currency	string	Từ tiền tệ
convert.commission	string	Phí chuyển đổi
convert.rate	string\|null	Tỷ lệ chuyển đổi
convert.from_amount	string\|null	Số tiền từ

: Kiểu tham số
string
Sự định nghĩa
uuid của khoản thanh toán
: Kiểu tham số
string
Sự định nghĩa
Số tiền thanh toán bằng tiền tệ
: Kiểu tham số
string
Sự định nghĩa
Mã tiền tệ để thanh toán
: Kiểu tham số
string|null
Sự định nghĩa
Mã của mạng blockchain trong đó khoản thanh toán được thực hiện
: Kiểu tham số
string|null
Sự định nghĩa
Mã tiền điện tử mà khoản thanh toán thực tế sẽ được thực hiện. Địa chỉ thanh toán sẽ nhận được loại tiền thanh toán.
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền thanh toán bằng tiền_thanh_toán.
: Kiểu tham số
string
Sự định nghĩa
Địa chỉ ví mà khoản thanh toán được thực hiện
: Kiểu tham số
string|null
Sự định nghĩa
ID giao dịch trong chuỗi khối
: Kiểu tham số
string
Sự định nghĩa
Trạng thái thanh toán trạng thái
: Kiểu tham số
string
Sự định nghĩa
Trạng thái thanh toán
: Kiểu tham số
boolean
Sự đị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.
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền còn lại trong ví của người bán.
: Kiểu tham số
string|null
Sự định nghĩa
ID đơn hàng trong hệ thống của bạn
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền hoa hồng của Cryptomus
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền được trừ vào số dư của người bán, bao gồm tất cả hoa hồng.
: Kiểu tham số
string|null
Sự định nghĩa
Ngày tạo khoản thanh toán. Múi giờ là UTC+3
: Kiểu tham số
string|null
Sự định nghĩa
Ngày cập nhật thanh toán gần nhất. Múi giờ là UTC+3
: Sự định nghĩa
Thông tin về loại tiền tệ mà khoản thanh toán sẽ được tự động chuyển đổi. Việc chuyển đổi được thực hiện từ payer_currency sang USDTHiển thị nếu tham số from_currency được truyền vào.
: Kiểu tham số
string|null
Sự định nghĩa
Mã tiền tệ mà khoản thanh toán sẽ được chuyển đổi
: Kiểu tham số
string
Sự định nghĩa
Từ tiền tệ
: Kiểu tham số
string
Sự định nghĩa
Phí chuyển đổi
: Kiểu tham số
string|null
Sự định nghĩa
Tỷ lệ chuyển đổi
: Kiểu tham số
string|null
Sự định nghĩa
Số tiền từ

Để 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' \
6

Sao chép

Ví dụ phản hồi


1{
2"state": 0,
3"result": {
4	"merchant_uuid": "8b03432e-385b-4670-8d06-064591096795",
5	"items": [{
6		"uuid": "a7c0caec-a594-4aaa-b1c4-77d511857594",
7		"amount": "3",
8		"currency": "USDT",
9		"network": "TRON",
10		"payer_currency": "USDT",
11		"payer_amount": "3",
12		"address": "TJ...",
13		"txid": null,
14		"status": "process",
15		"payment_status": "process",
16		"is_final": false,
17		"balance": "129.00000000",
18		"order_id": "1",
19		"commission": null,
20		"merchant_amount": null,
21		"created_at": "2023-06-21T17:25:55+03:00",
22		"updated_at": "2023-06-21T17:34:38+03:00"
23	}, {
24		"uuid": "92c39264-d180-4503-9c16-ee16f083bbb8",
25		"amount": "5.40000000",
26		"currency": "DOGE",
27		"network": "doge",
28		"payer_currency": "DOGE",
29		"payer_amount": "5.40000000",
30		"address": "DEw8CJLfxg9fhumeXP1zvVNjZicsqtDv7V",
31		"txid": "5e5810946152ea569d2a2aa9aa32a45c0e4223a4f9aad8e31d2fc660d2cdedb8",
32		"status": "paid",
33		"payment_status": "paid",
34		"is_final": true,
35		"balance": "26.77966652",
36		"order_id": null,
37		"commission": "0.00000000",
38		"merchant_amount": "5.40000000",
39		"created_at": "2023-07-21T17:25:55+03:00",
40		"updated_at": "2023-07-21T17:34:38+03:00"
41	},
42	...
43	],
44	"paginate": {
45		"count": 15,
46		"hasPages": true,
47		"nextCursor": "eyJpZCI6MjkxNTU0MywiX3BvaW50c1RvTmV4dEl0ZW1zIjp0cnVlfQ",
48		"previousCursor": null,
49		"perPage": 15
50	}
51}
52}

Sao chép

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}

Sao chép