v41

latestOpenAPI 3.0.0UNLICENSEDraw.githubusercontent.com2026-07-0839165177.6 KB

Test Helpers

Deny simulated return

Deny a simulated return.

post/api/v1/test-helpers/returns/{returnId}/deny

Path parameters

returnIdstring required

Request body

notestring

reason'final_sale' | 'return_period_ended' | 'other'

Why a merchant declined a return:

final_sale — the item was sold as final sale and is not returnable.
return_period_ended — the return window had already closed.
other — declined for another reason; see the accompanying note.

Response

The denied simulated return

updatedAtstring date-time required

When the Return record was last updated.

createdAtstring date-time required

When the Return record was created.

Reason a shopper is returning an order, supplied on the create-return call: defective (arrived damaged or faulty), wrong_item (not what was ordered), unwanted (changed their mind), color / size_too_large / size_too_small / style (wrong color, size, or style), not_as_described (differs from the listing), and other (anything else).

checkoutIntentIdstring required

Rye checkout intent id that produced the order being returned.

orderIdstring required

Rye order id (order_<32 hex>) this Return was opened against.

Lifecycle state of a Return:

requested — submitted to the merchant, awaiting approval.
requires_action — approved; the shopper must ship the items back.
processing — approved and in flight (items shipped, or no shipping required), awaiting the refund.
refunded — terminal; the refund has been issued and reconciled.
denied — terminal; the merchant declined the return.
failed — terminal; the return could not be completed.

idstring required

Rye return id (ret_<32 hex>).

Example response

{
  "refunds": [
    {
      "shopperRefundTotal": {
        "currencyCode": "USD",
        "amountSubunits": 1500
      }
    }
  ]
}