POST Approve Return
Phê duyệt Trả hàng Shop Scope yêu cầu: seller.return_refund.basic Sử dụng API này để phê duyệt yêu cầu trả hàng của người mua. Hiệu lực cụ thể phụ thuộc vào loại trả hàng và trạng thái trả hàng. Trước khi gọi API này, hãy đảm bảo yêu cầu trả hàng vẫn đang chờ một hành động của người bán khớp với quyết định mà bạn đang gửi. Version 202309
POST/return_refund/202309/returns/{return_id}/approve
Request
Path
| Properties | Type | Description |
|---|---|---|
| return_id Required | string | Mã định danh duy nhất của yêu cầu trả hàng cần được người bán phê duyệt. |
Header
| Properties | Type | Description |
|---|---|---|
| content-type Required | string | Loại được phép: application/json |
| x-tts-access-token Required | string | Giá trị seller access_token từ Get Access Token, khi user_type = 0. Làm theo hướng dẫn này để lấy seller access_token. |
Query
| Properties | Type | Description |
|---|---|---|
| app_key Required | string | Mỗi app sẽ có một key duy nhất. Vui lòng sử dụng key cụ thể được gán cho app của bạn. |
| sign Required | string | Chữ ký được tạo bởi thuật toán gen. Khi bạn gửi các yêu cầu API đến TTS, bạn phải ký chúng để TTS có thể nhận diện người gửi. |
| timestamp Required | int | Unix timestamp GMT (UTC+00:00). Timestamp này được sử dụng trên tất cả các yêu cầu API. Nhà phát triển có thể sử dụng giá trị này để chuyển đổi sang giờ địa phương. |
| idempotency_key | string | Idempotency key là một giá trị duy nhất do client tạo ra mà server sử dụng để nhận diện cùng một yêu cầu. Cách bạn tạo các key duy nhất là tùy bạn, nhưng chúng tôi khuyến nghị sử dụng UUID, hoặc một chuỗi ngẫu nhiên khác có đủ entropy để tránh trùng lặp. Idempotency key có thể dài tối đa 255 ký tự. |
| shop_cipher Required | string | Sử dụng property này để truyền thông tin shop khi gọi API. Nếu không truyền đúng giá trị khi gọi API cho các shop xuyên biên giới sẽ trả về response không chính xác. Lấy bằng API Get Authorization Shop |
Body
| Properties | Type | Description |
|---|---|---|
| decision Required | string | Quyết định của người bán cho yêu cầu trả hàng, các giá trị khả dụng:- APPROVE_REFUND: người bán phê duyệt yêu cầu chỉ hoàn tiền- APPROVE_RETURN: người bán phê duyệt yêu cầu trả hàng và hoàn tiền ban đầu- APPROVE_RECEIVED_PACKAGE: người bán phê duyệt yêu cầu trả hàng và hoàn tiền sau khi người mua đã gửi hoặc bàn giao mặt hàng.- APPROVE_REPLACEMENT: người bán phê duyệt yêu cầu thay thế- ISSUE_REPLACEMENT_REFUND: người bán từ chối yêu cầu thay thế và hoàn tiền trực tiếp cho người mua thay vào đó.- OFFER_PARTIAL_REFUND: người bán đề nghị một khoản hoàn tiền một phần cho người mua mà không yêu cầu trả lại mặt hàng.- DIRECT_REFUND: người bán thực hiện hoàn tiền không cần trả hàng, nghĩa là người mua nhận được hoàn tiền đầy đủ và giữ lại mặt hàng |
| buyer_keep_item | bool | Tùy chọn. Chỉ sử dụng trường này khi decision được đặt là APPROVE_RETURN. Nếu đặt là true, người bán thực hiện hoàn tiền không cần trả hàng, nghĩa là người mua nhận được hoàn tiền đầy đủ và giữ lại mặt hàng. |
| partial_refund | object | Bắt buộc. khi decision được đặt là OFFER_PARTIAL_REFUND Bỏ qua trường này cho tất cả các decision khác. |
Example
CurlGoNode.jsJavaEnable word wrap
Response Parameters
| Properties | Type | Description |
|---|---|---|
| code | int | Mã trạng thái thành công hoặc thất bại được trả về trong response của API. |
| message | string | Các thông báo thành công hoặc thất bại được trả về trong response của API. Lý do thất bại sẽ được mô tả trong message. |
| request_id | string | Request log |
| data | object | Thông tin trả hàng cụ thể |
Example
JSONEnable word wrap
Error Code
View common error codes
| Code | Message | | --- | --- | | 11050001 | invalid param | | 25001001 | An invalid request parameter was passed. Please check that you have the correct parameter type(s) and format. | | 25001003 | Invalid order status. | | 25001028 | reverse lock failed | | 25001044 | ConfirmReceive fulfillment order failed | | 25001058 | reverse downstream data load error | | 25007006 | Order not found. | | 25007007 | ReverseOrderExistNegotiate | | 25011010 | request has been transferred to platform operator | | 25011012 | reverse status cannot approve application | | 25011013 | reverse status cannot approve receive | | 25011023 | forbid process authentic guarantee order | | 25011026 | forbid process receive for FBT order | | 25011032 | ReverseInvalidStatusPartialRefund | | 25020004 | decision not match reverse type | | 25020005 | No permission to process this order | | 25020008 | Internal error. Please try again. If the issue persists after multiple attempts, please contact platform support. | | 25020009 | reverse already cancelled |
Nội dung này có hữu ích không?Hữu ích
Không hữu ích
PreviousNext