v2.payment.get_payout_detail

GET /api/v2/payment/get_payout_detail

API này chỉ áp dụng cho người bán Cross Border (CB) để lấy dữ liệu thanh toán của cửa hàng, bao gồm số tiền thanh toán, đơn vị tiền tệ, tỷ giá ngoại hối, thu nhập từ đơn hàng liên quan và hồ sơ điều chỉnh.

Đường dẫn Endpoint

URL: https://partner.shopeemobile.com/api/v2/payment/get_payout_detail

Tham số chung

Name	Type	Sample	Description
partner_id	int	1	Partner ID được gán khi đăng ký thành công. Bắt buộc cho tất cả các yêu cầu.
timestamp	timestamp	1610000000	Dùng để chỉ định thời điểm gửi yêu cầu. Bắt buộc cho tất cả các yêu cầu. Hết hạn sau 5 phút.
access_token	string	c09222e3fc40ffb25fc947f738b1abf1	Token để truy cập API, dùng để xác định quyền của bạn. Có thể dùng nhiều lần và hết hạn sau 4 giờ.
shop_id	int	600000	Mã định danh duy nhất của Shopee cho một cửa hàng. Tham số bắt buộc cho hầu hết các API.
sign	string	e318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2	Chữ ký được tạo từ partner_id, đường dẫn api, timestamp, access_token, shop_id và partner_key qua thuật toán HMAC-SHA256. Chi tiết: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Tham số Request

Name	Type	Required	Sample	Description
page_size	int	True	10	Số lượng trang trả về, tối đa 100.
page_no	int	True	1	Số trang, tối thiểu 1, mặc định 1.
payout_time_from	timestamp	True	1643365068	Thời gian bắt đầu. Khoảng thời gian tối đa là 15 ngày.
payout_time_to	timestamp	True	1659003469	Thời gian kết thúc.

Tham số Response

Name	Type	Sample	Description
error	string		Mã lỗi.
message	string		Thông báo lỗi.
request_id	string	5bd2a33faed0007f4883797f590e2a26	Mã định danh duy nhất của yêu cầu.
response	object		Nội dung nghiệp vụ của phản hồi.
more	boolean	false
payout_list	object[]
payout_info	object		Thông tin thanh toán.
from_currency	string	VND	Đơn vị tiền tệ thanh toán của các đơn hàng.
payout_currency	string	USD	Đơn vị tiền tệ thực tế của khoản thanh toán.
from_amount	float	591797912.0	Số tiền thanh toán.
payout_amount	float	25678.64	Số tiền thực tế của khoản thanh toán.
exchange_rate	string	0.00	Tỷ giá hối đoái.
payout_time	timestamp	1651842208	Thời gian thanh toán.
pay_service	string	Payoneer	Nhà cung cấp dịch vụ của người bán. Giá trị khả dụng: payoneer, pingpong, lianlian.
payee_id	string	279016275538	Tài khoản của người bán để nhận thanh toán.
escrow_list	object[]
escrow_amount	float	20865.0	Tổng số tiền người bán dự kiến nhận được cho đơn hàng.
currency	string	VND	Đơn vị tiền tệ dùng để tính số tiền escrow.
order_sn	string	220404NF3CFFNY	Mã định danh duy nhất của Shopee cho một đơn hàng.
offline_adjustment_list	object[]		Danh sách các điều chỉnh ngoại tuyến.
adjustment_amount	float	2.0	Số tiền điều chỉnh ngoại tuyến.
module	string	Commission Fee	Lý do điều chỉnh ngoại tuyến.
remark	string	DRC commission fee adjustment	Ghi chú cho lý do điều chỉnh.
scenario	string	Commission Fee Adjustment	Kịch bản điều chỉnh.
adjustment_level	string	shop	Chiều của điều chỉnh ngoại tuyến. Giá trị khả dụng: shop, order.
order_sn	string	220322JUMMT0S0	Shopee's unique identifier for an order.