Request the return of a store purchase

post

https://customer.services.drelife.com/returns/store-request

Return request of a shop or B2B purchase with no online order (customer#1211), sent with the store purchase entry session (Returns OTP). Creates a Drelife-only order for the catalog products picked and a return that the shop validates (invoice and amount) before the customer gets a label. Answers with the return, its amounts hidden until then, and a session bound to that order for the next steps. A retry with the same requestId answers with the same return: it must carry the same products, variants and units (another draft answers 409), and any other change under that id is ignored, so a changed draft needs a new requestId.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

lang

string

enum

Language of the localized texts of the response (ISO 639-1). A region suffix is ignored (en-US reads as en). An unsupported or missing value falls back to the language stored with the request (returns, purchases and repairs remember the language they were created in) and then to the marketplace locale.

Allowed:

Body Params

requestId

string

required

Id the client generates once per draft and reuses on retries: a retried submission answers with the same return instead of creating another one. A changed draft must use a new id.

products

array of objects

required

Catalog products returned.

products*

firstName

string

≤ 100

First name of the customer, so the shop can match the invoice holder.

lastName

string

≤ 100

Last name of the customer.

termsAndConditionsAcceptance

boolean

required

Whether the customer accepts the terms and conditions. It is mandatory and must be true; the request is rejected otherwise.

Responses

403

Not the store purchase entry session, or store purchase returns are not enabled.

409

The requestId was used for another draft: submit it with a new one.

429

Rate limit exceeded. Retry after the window (60 seconds by default).

StorePurchaseDailyLimit: <max>: the customer already sent the maximum of new requests of the last 24 hours (a retry of a sent request is not counted).

201The return request (or the one of a retried requestId) and the session of its order.

400Bad request: no attachment (the invoice), a product not available for returns, or an invalid item.

401Missing, invalid or expired Bearer token.

405StorePurchaseRequestLocked: another request of the customer is being created, retry in a few seconds.

500Unexpected error.

503The API is under maintenance or the database is unreachable.