Return API | eBay Community

Home
News & Updates
Buying & Selling
Explore Categories
About
Community Events
eBay Help

Categories

Special Categories

eBay Developers Program

Post Order APIs

Return API

Created May 5, 2026

0 members

17 discussions

charhe6271
Deleting a reason for returning an item
How can I change the reason for a return from "defective item" to "doesn't fit"? I can't seem to delete "defective item" to start over with "doesn't fit." How can I do that?
4 days agolast reply 3 days ago
5
myakku24
Upload a return pdf File as returnLabel from the seller
Hello, while accepting a return request by using the "process return request" the return request itself is waiting for the seller to send the label. After that we can buy a label at ebay or provide our own label - this is what we wanna do. To do this we used the "upload Return File" call from the ebay post-order-return calls. This call is used to send pictures (jpeg, png, bmp, gif) for the item purpose AND ALSO pdf files for using this call to send the returnLabel. However, you will not be able to send detailed informations about the file you send, so we think the file type is interpreted by the file name, whitch is given in the call? We send the binary64 code from the pdf, the file name "file_1234.pdf" and the purpose "LABEL_RELATED" in the request call. The response is Code 200, everything fine, but when receiving the file infos from the related return request the file type is still "unknown". But when we will use the Code stored to the given fileID it is the complete pdf dokument, no problem with decoding the base64 code. So why is the fileType still "unknown" and also at the eBay website there is nothing to see about this document in the return request. What shall we do to set the correct fileType and that the buyer will be able to see the document for printing it? We're confused what might happen? Will there be more payload data needed whitch is not corresponded in the API documentation? This ist the API docu für uploading: https://developer.ebay.com/devzone/post-order/post-order_v2_return-returnid_file_upload__post.html
5 months ago
0
sabinabieber1994
Received a counterfeit item. 30 day-window expired and the seller account removed
Hello. I have purchased a counterfeit item. The seller and the item listing are removed from ebay. Due to personal issues, I have opened the package late and did not find time to deal with return. I opened return request after 30 days and obviously did not fall under the ebay Money Back Guarantee. How can I get this resolved and receive refund? I have photos as proof of non-authenticity. Please disregard the Chargeback option, because the banks in my country don't offer this service.
7 months ago
0
anliant_voma0aqokp
Disappointment
I will not recommend anyone buying eBay gift card. I have an eBay gift card that was purchased September 2024 and I scratched the redemption code around 2-3 days ago. (January 2025). There are 3 digits missing from the 13 digit code. Seems like they were missing when the card was being made. I contacted eBay customer support and gave them info on the card and the receipt. They got back to me with the missing redemption codes, but also said someone else used the money before I even scratched open the cover of the redemption codes. I went to the store that the card was purchased, and the store said this is an eBay problem because the card is defected. I called eBay customer support again and they said they pretty much said they can not help because the card was being scammed and I should’ve open the card and check the balance. And they said I can call the police for this. So this is none of the store and eBay’s fault. Is it my fault to purchase a defective card and not redeem it in time even though the card says it will never expire? Is it my fault that eBay’s physical gift card is easily scammed? There was not much “support” in this customer support. I have been using eBay for a couple of years now and I lost all of my trust and respect to eBay for this. I will actively discourage people I know in live and online to stay away from purchasing gift cards or using this website.
1 year ago
0
kaminplus_de
How I can change sellerReturnAddress on return.
On ebay site when buyer initiate return, seller can change return address, and provide RMA. Using api I can set RMA using " POST /post-order/v2/return/{returnId}/decide" but I can't find any method to change return addres. This option is on case or inquiry. Any ideas how to set it on return?
1 year ago
0
richud2202
Return am item
I have received a video games Fallout 76. It is defective. I can't play the game because of an error has occurred. How do I send it back to get another one to replace it
1 year ago
0
73rivy
Dishonesty
I was sold an old phone from 2020 as new. Can't make phone calls. Still in warranty
1 year ago
0
yt896_3
About eBay API return interface problem
Hello! I am now calling: /post-order/v2/return/search I cannot call it, please answer my doubts Return parameters: sun.net. www.MessageHeader@59f88c4e34 pairs: {null: HTTP/1.1 400 Bad Request}{Server: nginx/1.20.1}{Date: Thu, 11 Jul 2024 08:56:49 GMT}{Content-Type: application/json}{Content-Length: 208}{Connection: keep-alive}{x-ebay-c-request-id: ri=vwkhAvntKQyS,rci=d15e4c5ef5db5e9f}{rlogid: t6q%60rrqkuq%60fiiw%3F%3Cufqsumvpd%60jhs.0%602%3Aa0%3E%3A%3D3*g%3Dd%3Ei-190a1026fd1-0x228}{x-ebay-c-version: 1.0.0}{x-frame-options: SAMEORIGIN}{x-content-type-options: nosniff}{x-xss-protection: 1; mode=block}{x-ebay-svc-tracking-data: <a>ul=en-US&uc=1&eprlogid=t6q%2560rrqkuq%2560fiiw%253F%253Cufqsumvpd%2560jhs.0%25602%253Aa0%253E%253A%253D3*g%253Dd%253Ei-190a1026fd1-0x228&hrc=400&**bleep**=0&!_epec=7,6&epcalenv=</a>}{Accept-CH: sec-ch-ua-model,sec-ch-ua-platform-version,sec-ch-ua-full-version}{x-envoy-upstream-service-time: 65}{x-ebay-mesh-server-pod-ip: 10.42.109.195}{x-ebay-mesh-server-duration: 32}{x-ebay-mesh-server-start: 2024-07-11T08:56:49.870Z}{x-ebay-mesh-server-response-flag: -}{x-ebay-mesh-gw-name: istioingressgateway-production-slcaz02-03}{x-ebay-mesh-gw-pod-name: istio-ingressgateway-03-79c87d6f86-28n94}{x-ebay-mesh-gw-pod-ip: 10.115.160.95}{x-ebay-mesh-gw-upstream-duration: 38}{x-ebay-mesh-gw-duration: 39}{x-ebay-mesh-gw-start: 2024-07-11T08:56:49.865Z}{x-ebay-mesh-gw-response-flag: -}{x-ebay-pop-id: UFES2-SLCAZ01-api}{Expires: Thu, 11 Jul 2024 08:56:49 GMT}{Cache-Control: max-age=0, no-cache, no-store}{Pragma: no-cache}{Set-Cookie: ebay=%5Esbf%3D%23%5E;Domain=.ebay.com;Path=/; Secure}{Set-Cookie: dp1=bu1p/QEBfX0BAX19AQA**6a520551^;Domain=.ebay.com;Expires=Sat, 11-Jul-2026 08:56:49 GMT;Path=/; Secure}{x-CDN: AKAMAI}{Strict-Transport-Security: max-age=31536000} Another interface: post-order/v2/return/{returnId}/issue_refund is also unavailable Return parameter: "errorMsg": "400 Bad Request: [{\"error\":[{\"errorId\":1760,\"domain\":\"returnErrorDomain\",\"severity\":\"ERROR\",\"category\":\"REQUEST\",\"message\":\"Refund amount deduction not allowed.\",\"parameter\":[{\"value\":\"refundFeeType\",\"name\":\"parameter\"}],\"inputRefIds\":[],\"httpStatusCode\":400}]}]",
2 years ago
0
gabi-mode
Getting 403 on Search Returns / Get Return requests
Hi, Since this morning, I'm getting a 403 HTTP status code, when trying to get Returns via Search Returns or Get Return requests. The same Auth'n'Auth token works correctly with other Post-Order requests, e.g.: Search Cancellations / Get Cancellation. Additionally, once I could get returns - but after this one success I'm getting 403 again. The OAuth token doesn't work too.
3 years agolast reply 2 years ago
1
tristartreasures
Ebay actively rewarding buyers who manipulate return process?
So I sold an item on 17 May and shipped it out on the 20th via UPS ground. The estimated delivery time shown to the buyer was May 24. I am located in Tennessee and they are located in California. UPS does a good job updating the tracking every few hours every day as it’s moving and eventually on Thursday the 23rd says that the item will be arriving one day later than advertised. There is no reason given other than it is delayed. On Friday the 24th they update the tracking and say that the item will be delivered the next available business day due to holiday closures. This means that it would be delivered on Tuesday the 28th. The buyer opens a return case on Monday the 27th claiming item does not match the photos or description. Under the comment section of the case they say “item was delivered late and has not arrived. I don’t need it anymore. I want a refund. “ of course, I immediately reply with all of the information they have from the tracking and screenshot showing the progression in the acknowledgment of shipping delays. I also refer them back to the return policy that they agreed to in my description that says I do not accept returns for change of mind such as not warning the item anymore. I also included screenshots from Ebay’s own seller policy protection where it says we are not responsible for a carrier delays. It’s buyers remorse and it’s opening a false claim under the pretense that the item is not as described before they even received it. This is pretty clear. I’m not real sure how any Ebay representative would have a problem. Understanding the facts but here we are. I talked to two representative before I was able to get through to a leadership member who reluctantly Agreed to close the case in my favor after I continually had to throw Ebay‘s own policies regarding return manipulation and buyers remorse back at them. My whole point was as a small business owner. I should not have to accept the loss of a shipping and return shipping and time loss because someone can’t wait an extra day or two due to holiday delays. anyways, the leadership member agreed to close the case in my favor and made it sound like everything was done under Ebay policies, and that the buyer actively manipulated the process and that they should be reported for the behavior. Then I get a notification saying that Ebay has issued a refund to the buyer and is allowing them to keep the item and it does not affect me. Essentially ebay let this person express open remorse and submit a false claim paid them their money back and let them keep the item. Granted they did protect me and now I don’t have to worry about it, but this person was rewarded with a free $100 keyboard.
2 years agolast reply 2 years ago
3
yao-1219
about attribute missing in "/post-order/v2/return/search" api
my shop use this api for several years . But last week , from 22nd March ,2024. 04:00 am they miss an attribute 'flags' in 'members' in response, i don't know how to get the state now , previous it is in 'members.flags. autoRefundTriggered'
2 years ago
0
reskinnedtest
Digital signatures on post order API
We implemented digital signatures on our app quite some time ago, as we are using the order-level issue_refund endpoint on the fulflilmnt API: https://developer.ebay.com/api-docs/sell/fulfillment/resources/order/methods/issueRefund We were able to successfully implement this and it is still working to date. However we now have need to utilise some of the Post Order API endpoints that also require a signature, specifically Approve Cancel Request, Issue Return Refund and Process Return Request. For these endpoints we are consistently getting the error "Signature validation failed to fulfil the request" - despite the fact that we are using the same code util to create the signature headers. Has anyone else experienced this?
2 years ago
0