Return Feedback

post

https://api.signifyd.com/v3/orders/events/returns/feedback

Use this endpoint to provide Signifyd with information regarding the quality of a return/refund/exchange (i.e. if it was later discovered to be an "abusive" return or a confirmed "good" return). If your company is currently performing any analysis on the quality of its returns, sending that information via this endpoint will become available to custom policies in created in Signifyd's Decision Center and appear in our Insights dashboards.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

orderId

string

required

Unique identifier for the order.

returnId

string

required

Unique identifier for the Return.

returnedItems

array of objects

A list of products that are going to be returned by the buyer.

returnedItems

returnOutcome

string

enum

required

The outcome of the return once received by your return team.

GOOD - the return was accepted and processed.
ABUSIVE - the return violates the return policy.
FRAUD - the return is fraudulent.
NO_ITEM_RETURNED - the return was not received.

Allowed:

returnOutcomeReason

string

The reason for the return outcome. Any reason will be accepted, but we strongly recommend mapping to one of the following keys if possible:

Used Item
Wrong Item
Empty Box
Missing Items
Trash Returned
Damaged Item

feedbackAt

date-time

Timestamp indicating when the outcome was determined.

200If Feedback has been created in the Signifyd system with the same orderId and returnId, then no updates to the Feedback will occur. We will simply return the existing Feedback details.

201Feedback for the order and return is created

400Response if there was a problem with the request, such as when a required field is missing or otherwise fails validation.

401Response if the provided authentication credentials are not known or do not match what is on file for the specified user.

403Response if the authenticated user does not have permission to perform the requested action.

404Response if the requested entity can't be found.

500Response if an unexplained error occurs on the server.