Sign in
latestOpenAPI 3.0.32026-08-193973220.1 KB

6a1303364143

BuyBack

Validate BuyBack order

Validate a BuyBack order by setting the state to VALIDATED. Caller must be an authenticated merchant, owner of the provided buyback order.

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

Path parameters

buybackOrderIdstring required

BuyBack order id

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"
    }
  ]
}