Update PostSale Action

put

https://api.signifyd.com/v3/orders/events/postsale/actions

Use this to report status changes or final actions taken on a post-sale action.

Common updates include:

Refund issued
Replacement sent
Request canceled or declined
Guarantee cancellation when status is REFUNDED or PARTIAL_SETTLEMENT

Update PostSale Action helps Signifyd track request outcomes, refund timing (e.g., instant vs post-verification), and alignment with policies.

This call is important to:

Close the loop on Create PostSale Requested Action
Trigger guarantee cancellation logic (when applicable)

Call this as the request progresses through stages (e.g., OPEN → IN_ANALYSIS → REFUNDED).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

orderId

string

required

The unique identifier for the order. This must be the same order ID originally provided in the Checkout/Sale event.

postSaleActionId

string

required

Unique identifier for this return, refund, or appeasement request.

status

string

enum

Updated status of the post-sale action. If no Status is provided, the default will be OPEN.

OPEN - The request has been created and is awaiting further updates or resolution.
CANCELED - The request was canceled before fulfillment, refund, or processing.
REFUNDED - A refund has been issued for the request.
REPLACED - A replacement item has been issued to the buyer.
IN_ANALYSIS - The request is under review, either manually or through automated evaluation.
DECLINED - The request was reviewed and denied (e.g., due to policy or abuse).
RETURN_PENDING - The buyer has been asked to return the item before a refund or replacement is issued.
PARTIAL_SETTLEMENT - A partial refund, appeasement, or resolution has been granted.

The CANCELED, PARTIAL_SETTLEMENT, REFUNDED, REPLACED & DECLINED statuses are considered final. No more updates will be accepted once one of these statuses is reached.

updatedAt

date-time

Timestamp of when the update occurred. If not provided, the current timestamp will be used.

Formatted as yyyy-MM-dd'T'HH:mm:ssZ per ISO 8601."

refund

object

Object containing details about a refund that was issued for the post-sale action. Include only if a refund has been issued.

replacement

object

Object containing details about any replacement that was issued for the post-sale action. Include only if a replacement has been issued.

201

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.