---
title: "Suspend a BuyBack order"
method: PUT
path: "/ws/buyback/v1/orders/{buybackOrderId}/suspend"
tags: ["BuyBack"]
---

# Suspend a BuyBack order

`PUT /ws/buyback/v1/orders/{buybackOrderId}/suspend`

Suspend a BuyBack order with the provided reasons.
Caller must be an authenticated refurbisher, owner of the provided buyback order.

## Path parameters

- `buybackOrderId` string, required

## Request body

- BuybackOrderSuspensionPayload
  - `reasons` string[], required — List of suspension reasons identifiers

## Response `200`

OK

- BuybackOrder — Buyback order sent back by 'ws/buyback/' endpoints
  - `orderPublicId` string, required — buyback order public identifier
  - `creationDate` string, required — Buyback Order creation date
  - `modificationDate` string, required — Buyback Order last modification date
  - `shippingDate` string, required — Buyback Order shipping date
  - `suspensionDate` string — Buyback Order suspension date
  - `receivalDate` string — Buyback Order reception date
  - `paymentDate` string — Buyback Order payment date
  - `counterProposalDate` string — Last counter proposal date
  - `status` 'NEW' | 'PENDING' | 'TO_SEND' | 'SENT' | 'RECEIVED' | 'COUNTER_PROPOSAL' | 'VALIDATED' | 'PAID' | 'MONEY_TRANSFERED' | 'SUSPENDED', required — Buyback order state
  - `market` string, required — Idenfitication code of the market in which the buyback order was placed
  - `transferCertificateLink` string, required — URL where the transfer certificate can be downloaded
  - `listing` object, required
    - `sku` string — (Stock-keeping unit) Identification number of the product
    - `productId` number, required — Identification number of the product bought back by the merchant
    - `title` string, required — Name of the product bought back by the merchant
    - `grade` 'DIAMOND' | 'PLATINUM' | 'GOLD' | 'SILVER' | 'BRONZE' | 'STALLONE', required — Quality grade of the buyback order
  - `customer` object, required
    - `firstName` string — First name of the customer who wants to sell a device
    - `lastName` string — Last name of the customer who wants to sell a device
    - `phone` string — Phone number of the customer
    - `dateOfBirth` string — Birthdate of the customer
    - `documents` object[]
      - `type` 'PASSPORT' | 'ID' | 'ID_CARD_FRONT' | 'ID_CARD_BACK' | 'BANK_STATEMENT' | 'DRIVING_LICENCE_FRONT' | 'DRIVING_LICENCE_BACK', required — Type of the KYC document
      - `url` string, required — URL where the document can be downloaded
  - `returnAddress` object, required — Address where the parcel can be returned
    - `address1` string — Main address description
    - `address2` string — Details on the address
    - `city` string — City of the address
    - `zipcode` string — Zipcode of the address
    - `country` string, required — Country of the address
  - `originalPrice` object, required — Initial offer price
    - `value` number, required — Initial offer amount
    - `currency` string, required — Initial price currency
  - `counterOfferPrice` object — Counter offer price set by the merchant
    - `value` number, required — Amount set by the merchant
    - `currency` string, required — Currency of the counter offer price set by the merchant
  - `trackingNumber` string — Tracking number of the parcel
  - `shipper` string — Shipper of the parcel
  - `suspendReasons` BuybackReason[] — List of reasons set by the merchant when putting the buyback order on hold
    - `message` string, required — Details of the reason
    - `identifier` string, required — Identifier of the reason
    - `category` string — Category of the reason
  - `counterOfferReasons` BuybackReason[] — List of reasons set by the merchant when making a counter offer on the buyback order
    - `message` string, required — Details of the reason
    - `identifier` string, required — Identifier of the reason
    - `category` string — Category of the reason

## Other responses

- `401` — Unauthorized
- `403` — Permission denied
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Internal Error

---

[API](https://skmtc.net/backmarket/apis/back-market-api-guidelines.md) · [All operations](https://skmtc.net/backmarket/apis/back-market-api-guidelines/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/backmarket/back-market-api-guidelines/revisions/6a1303364143/schema)