v2.payment.get_wallet_transaction_list
GET /api/v2/payment/get_wallet_transaction_list
Sử dụng API này để lấy danh sách giao dịch ví. Chỉ áp dụng cho cửa hàng nội địa.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/payment/get_wallet_transaction_list
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 dùng để truy cập API, 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_no | int | True | Chỉ định mục bắt đầu của dữ liệu cần trả về. Mặc định là 0. Nếu dữ liệu nhiều hơn một trang, offset có thể là mục bắt đầu cho lần gọi tiếp theo. | |
| page_size | int | True | Nếu có nhiều giao dịch cần lấy, bạn có thể cần gọi GetTransactionList nhiều lần. Mỗi kết quả được trả về theo trang. Mặc định là 40. Dùng bộ lọc Phân trang để kiểm soát số lượng mục tối đa (<= 100) mỗi trang. Giá trị này xác định số lượng mục tối đa trả về trong một "trang" dữ liệu. | |
| create_time_from | int | False | Trường create_time_from là ngày bắt đầu của khoảng thời gian. Khoảng thời gian tối đa có thể chỉ định với create_time_from và create_time_to là 15 ngày. | |
| create_time_to | int | False | Trường create_time_to là ngày kết thúc của khoảng thời gian. Khoảng thời gian tối đa có thể chỉ định là 15 ngày. | |
| wallet_type | string | False | Trường này cho biết loại ví. | |
| transaction_type | string | False | Các loại giao dịch. ESCROW_VERIFIED_ADD = 101: Escrow đã được xác minh và thanh toán cho người bán; ESCROW_BANK_TRANSFER_ADD = 103: Thêm từ chuyển khoản ngân hàng; và các loại khác. | |
| money_flow | string | False | It's to indicate whether user wants to only return : MONEY_IN = addition MONEY_OUT = Deduction if not specified, we will return all Note special case for TW JKO Pay, we will ignore Money_flow | |
| transaction_tab_type | string | False | LƯU Ý: Chỉ nên truyền 1 giá trị 'transaction tab type'. Truyền nhiều hơn 1 giá trị sẽ dẫn đến kết quả không mong muốn. Xem Định nghĩa Dữ liệu - TransactionTabType để biết các giá trị khả dụng. |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| response | object | ||
| transaction_list | object[] | ||
| status | string | Trạng thái của giao dịch. Giá trị khả dụng: FAILED, COMPLETED, PENDING, INITIAL. | |
| transaction_type | string | Loại giao dịch. | |
| amount | float | Số tiền giao dịch. | |
| current_balance | float | Số dư hiện tại của tài khoản này. | |
| create_time | int | Thời gian tạo giao dịch. | |
| order_sn | string | Mã định danh duy nhất của Shopee cho một đơn hàng. | |
| refund_sn | string | Số serial của yêu cầu trả hàng. | |
| withdrawal_type | string | Loại rút tiền. | |
| transaction_fee | float | Trường này cho biết phí giao dịch. | |
| description | string | Mô tả chi tiết của TOPUP SUCCESS và TOPUP FAILED. | |
| buyer_name | string | Tên người mua. | |
| pay_order_list | object[] | ||
| order_sn | string | Mã định danh duy nhất của Shopee cho một đơn hàng. | |
| shop_name | string | Tên cửa hàng. | |
| shop_name | string | Name of the shop. | |
| withdrawal_id | int | ID rút tiền khi loại giao dịch là withdraw_created, withdrawal_completed, withdrawal_cancelled. | |
| reason | string | Lý do cho ADJUSTMENT_ADD và ADJUSTMENT_MINUS. | |
| root_withdrawal_id | int | Dùng trường này để cho biết sự kiện một lần rút tiền được tách thành nhiều lần rút do giới hạn rút tiền. | |
| transaction_tab_type | string | Tham số phản hồi mới được thêm vào. Xem Định nghĩa Dữ liệu - TransactionTabType để biết thêm chi tiết. | |
| money_flow | string | New response parameter provided after: https://confluence.shopee.io/display/SPCT/%5BPRD%5D+%5BOpen+API%5D+Update+on+New+Open+API+to+fetch+Seller+wallet+Transaction It's to indicate the money flow MONEY_IN = addition MONEY_OUT = deduction if not specified in request, will return both Note special case for TW JKO Pay, we will ignore Money_flow | |
| outlet_shop_name | string | Tên cửa hàng outlet nơi giao dịch outlet này đến từ. (Trong khái niệm Instant Mart gốc, giao dịch outlet được chuyển hướng đến Mart.) | |
| more | boolean | ||
| request_id | string | xduiwekui134 | |
| message | string | ||
| error | string |
No Request Example Set.
No Response Example Set.