v2.returns.upload_proof
POST /api/v2/returns/upload_proof
Support sellers to upload evidence, including text and pictures and videos converted into URLs.
Đường dẫn Endpoint
URL: https://partner.shopeemobile.com/api/v2/returns/upload_proof
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 |
|---|---|---|---|---|
| return_sn | string | True | 211019111701669 | Mã số của yêu cầu hoàn trả. |
| photo | object[] | False | ||
| url | string | True | https://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.png | Uploaded proof image link, it is recommended to pass in the return url of api called convert_image. |
| thumbnail | string | True | https://file-proxy.seller.test.shopee.com/api/v2/files/c2hvcGVlLWRyYzAx/6cd5662c25964655827057bb2bfa69e2.png | URL ảnh đại diện của bằng chứng. |
| description | string | False | test | text description in the dispute proof |
Tham số Response
| Name | Type | Sample | Description |
|---|---|---|---|
| request_id | string | openapi-a158bf23ecfa3f34a17a19ed8b12dbc9 | Mã định danh của yêu cầu API dùng để theo dõi lỗi. |
| error | string | Indicate error code if hit error. Empty if no error happened | |
| message | string | success | Cho biết chi tiết lỗi nếu xảy ra. Trống nếu không có lỗi. |
| response | object | Thông tin chi tiết bạn đang truy vấn. API này sẽ trả về null. |