Skip to content

Processing an Order

Overview

This guide demonstrates a production-ready workflow for processing Depop orders. We will move beyond the basics of the Your first sale and show you how to automate order management from the moment a sale occurs to the point of dispatch.

At a high level, these are the steps:

Processing Order Overview

Setup endpoint to receive New Order webhooks

We will send a webhook as soon as there's an order placed on your shop. Reach out to us with the URL and we'll configure this for you.

Once this is set up, you can use the testing environment to list an item and then trigger the simulate purchase endpoint which will trigger the webhook.

Handling the webhook request

  1. Validate the webhook. Ensure the webhook is from Depop and contains the expected data. You can learn how to do this in the Validating webhooks guide.
  2. Async processing. If you need to perform any time-consuming tasks, such as checking inventory or updating your database, do this asynchronously to avoid blocking the webhook response.
  3. Decrement stock to prevent overselling. Keep your inventory accurate by decreasing the stock of the sold items.
  4. Mark as sold on other platforms. If you sell on multiple platforms, update the status of the item on those platforms to prevent overselling.

Processing the order

  1. Follow your own internal processes. Do your usual fulfilment process and keep a record of the tracking code for the order.
  2. Notify Depop of the tracking code. Use the /api/v1/orders/{purchase_id}/parcels/{parcel_id}/mark-as-shipped/ endpoint to send the tracking code back to Depop. This will update the order status and notify the buyer.

Periodic reconciliation

We strive to keep our webhooks as reliable and timely as possible but the occasional webhook might be missed, for example, your webhook endpoint is unreachable from Depop.

Set up a periodic job to fetch orders and check for those that still have SHIPPING_PENDING state. Run this job once a day. Our Get All Orders endpoint supports filtering by time range so you can keep track of the most recent order that has been processed.