Sign in
latestOpenAPI 3.0.32026-08-193973220.1 KB

6a1303364143

BuyBack

Suspend a BuyBack order

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

put/ws/buyback/v1/orders/{buybackOrderId}/suspend

Path parameters

buybackOrderIdstring required

BuyBack order id

Request body

reasonsstring[] required

List of suspension reasons identifiers

Example request

{
  "reasons": [
    "parcel_damaged",
    "broken_device"
  ]
}

Response

OK

orderPublicIdstring required

buyback order public identifier

creationDatestring required

Buyback Order creation date

modificationDatestring required

Buyback Order last modification date

shippingDatestring required

Buyback Order shipping date

suspensionDatestring

Buyback Order suspension date

receivalDatestring

Buyback Order reception date

paymentDatestring

Buyback Order payment date

counterProposalDatestring

Last counter proposal date

status'NEW' | 'PENDING' | 'TO_SEND' | 'SENT' | 'RECEIVED' | 'COUNTER_PROPOSAL' | 'VALIDATED' | 'PAID' | 'MONEY_TRANSFERED' | 'SUSPENDED' required

Buyback order state

marketstring required

Idenfitication code of the market in which the buyback order was placed

transferCertificateLinkstring required

URL where the transfer certificate can be downloaded

trackingNumberstring

Tracking number of the parcel

shipperstring

Shipper of the parcel

Example response

{
  "orderPublicId": "US-24527-ABCDE",
  "creationDate": "2019-03-21T14:28:30+01:00",
  "modificationDate": "2019-03-26T08:00:53+01:00",
  "shippingDate": "2019-03-21T14:37:54+01:00",
  "suspensionDate": "2019-03-21T14:37:54+01:00",
  "receivalDate": "2019-03-21T14:37:54+01:00",
  "paymentDate": "2019-03-21T14:38:11+01:00",
  "counterProposalDate": "2019-03-21T14:37:54+01:00",
  "status": "TO_SEND",
  "market": "FR",
  "transferCertificateLink": "https://tranfer-certificate.com",
  "listing": {
    "sku": "21000021",
    "productId": 2311,
    "title": "Apple iPhone XS 64 Go",
    "grade": "DIAMOND"
  },
  "customer": {
    "firstName": "John",
    "lastName": "Doe",
    "phone": "+33699887766",
    "dateOfBirth": "1970-03-21",
    "documents": [
      {
        "type": "PASSPORT",
        "url": "https://bucket.com/user_document/passport.jpeg"
      }
    ]
  },
  "returnAddress": {
    "address1": "10, Downing street",
    "address2": "3rd floor",
    "city": "London",
    "zipcode": "93100",
    "country": "United Kingdom"
  },
  "originalPrice": {
    "value": 1000,
    "currency": "EUR"
  },
  "counterOfferPrice": {
    "value": 900,
    "currency": "EUR"
  },
  "trackingNumber": "8R41352499203",
  "shipper": "DHL",
  "suspendReasons": [
    {
      "message": "Empty parcel",
      "identifier": "parcel_empty",
      "category": "Transport issue"
    }
  ],
  "counterOfferReasons": [
    {
      "message": "Empty parcel",
      "identifier": "parcel_empty",
      "category": "Transport issue"
    }
  ]
}