Report a return decision (approve / reject)

post

https://api.protectplus.io/returns/{return_id}/decision

Notify Get Plus that your OMS has approved or rejected a return
request. On APPROVED, the return stays open awaiting your
shipping-label callback; on REJECTED, the return moves to
EVALUATION_REJECTED. In both cases the customer is notified by email
with your optional note included.

Re-sending the same decision for the same return is idempotent and
returns 200. Sending a different decision once one is recorded
returns 409 — a decision cannot be changed through this API.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

return_id

string

required

The Get Plus return id — return_id from the POST /returns response, data.returns[].id from GET /returns, or data.return.id from GET /returns/{return_id}. NOT the top-level id from POST /returns (that is the return request, not the return).

Body Params

decision

string

enum

required

The outcome decided in your OMS.

Allowed:

note

string

Optional reason, shared with the customer in the notification email.

external_reference

object

Optional reference to the return in your OMS. Stored on the Get Plus
return so both systems share one identity for the return — include it
on every callback so out-of-band and duplicate messages can be
correlated.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

200Decision recorded — or already recorded with the same value (idempotent replay; message says so).

400Rejected by the returns service — e.g. the return is not on a custom-platform order.

401Unauthorized

403Return belongs to another store

404Unknown return_id — callbacks never create returns. The id must be an existing return (see GET /returns).

409A different decision is already recorded for this return.

422Request body failed validation

429Rate limit exceeded