Skip to main content

v2.returns.get_return_dispute_reason

GET /api/v2/returns/get_return_dispute_reason

To get the dispute return reason.

Endpoint URL

URL: https://partner.shopeemobile.com/api/v2/returns/get_return_dispute_reason

Common Request Parameters

NameTypeSampleDescription
partner_idint1Partner ID is assigned upon registration is successful. Required for all requests.
timestamptimestamp1610000000This is to indicate the timestamp of the request. Required for all requests. Expires in 5 minutes.
access_tokenstringc09222e3fc40ffb25fc947f738b1abf1The token for API access, using to identify your permission to the api. Valid for multiple use and expires in 4 hours.
shop_idint600000Shopee's unique identifier for a shop. Required param for most APIs.
signstringe318d3e932719916a9f9ebb57e2011961bd47abfa54a36e040d050d8931596e2Signature generated by partner_id, api path, timestamp, access_token, shop_id and partner_key via HMAC-SHA256 hashing algorithm. More details: https://open.shopee.com/documents?module=87&type=2&id=58&version=2

Request Parameters

NameTypeRequiredSampleDescription
return_snstringTrue24112301K66SQXMThe serial number of return.

Response Parameters

NameTypeSampleDescription
request_idstringopenapi-e3e3e7f32a7c6d903377b902ac7e7a00:01000237d706e07e:0000004e4d5c1f2fThe identifier for an API request for error tracking
errorstringIndicate error type if hit error. Empty if no error happened.
messagestringIndicate error details if hit error. Empty if no error happened.
responseobjectDetail informations you are querying.
dispute_reason_listobject[]The dispute_reason and associated evidence list.
dispute_reasonint3250The dispute_reason for one specific case. See Data Definition - DisputeReason.
dispute_requirementstringRegarding to your refund request, Shopee would like to request more information as follows :Indicate the importance of uploading required proof.
sample_evidenceobject[]The URL of sample evidence to upload.
typeint321The type of sample evidence. Applicable value: - 1: Image
urlstringhttps://fileproxy.scsusercontent.com/api/v2/files/c2hvcGVlLWRyYzAx/bf10d801\_e9c9e5473d3345d08671a8cc3bc1a6de.jpgThe link of sample evidence.
thumbnailstringhttps://fileproxy.scsusercontent.com/api/v2/files/c2hvcGVlLWRyYzAx/bf10d801\_e9c9e5473d3345d08671a8cc3bc1a6de\_tn.jpgThe link of the thumbnail of sample evidence.
evidence_module_listobject[]The associated evidence module list for current dispute reason.
module_indexint321The index of current evidence module.
requirementstringPhoto(s) or Video of unboxing the returned parcel with the consignment note (Airway Bill).The specific requirement of current evidence module.
is_requiredbooleantrueIndicate if current evidence module is mandatory or not.