Update offer buyout amount

Updates the buyout amount on an offer. The offer must be in “pending” or “awaiting_customer” status.

POST/{id}/buyout

Authorization

AuthorizationBearer token · headerrequired

API token from the SIBI developer dashboard (developer.sibipro.com), sent as Authorization: Bearer <token>.

Scopes:write:offers

Path parameters

idstringrequired

The ID of the offer to update

Request body

application/json

buyoutAmountnumberrequired

Buyout amount in cents (e.g., 50000 = $500.00). Customer can opt to receive this amount instead of a replacement product.

min 0

Responses

200

Offer buyout amount updated successfully

successbooleanrequired

Whether the offer buyout amount was updated successfully

buyoutAmountnumberrequired

The buyout amount in cents that was persisted on the offer, read back after the update.

min 0

updatedAtstring<date-time>required

Timestamp when the offer buyout amount was updated

400

Bad request - Offer buyout could not be updated

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

401

Unauthorized - Missing or invalid authentication

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

403

Forbidden - Caller can view this offer but is not allowed to update it

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

404

Not found - Offer does not exist or caller is not allowed to view it

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

500

Internal server error

codestringrequired

Error code indicating the type of error

messagestringrequired

Human-readable error message explaining what went wrong

detailsobject[]

Detailed validation errors when applicable

Show properties

Array of object

fieldstringrequired

errorstringrequired

Request

curl -X POST 'https://api.sibipro.com/prod/offers/string/buyout' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "buyoutAmount": 50000
}'

const response = await fetch("https://api.sibipro.com/prod/offers/string/buyout", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Accept": "application/json",
    "Content-Type": "application/json"
  },
  body: "{\n  \"buyoutAmount\": 50000\n}"
});

Response

{
  "success": true,
  "buyoutAmount": 50000,
  "updatedAt": "2024-01-20T12:00:00Z"
}

{
  "code": "OFFER_BUYOUT_UPDATE_NOT_ALLOWED",
  "message": "Offer buyout cannot be updated because it is in \"canceled\" status"
}

{
  "code": "UPDATE_BUYOUT_AMOUNT_ERROR",
  "message": "Failed to update offer buyout amount"
}

{
  "code": "UNAUTHORIZED",
  "message": "Missing authentication token"
}

{
  "code": "INSUFFICIENT_SCOPE",
  "message": "The presented token is missing the `write:offers` scope, which this endpoint requires. Create a token with the scopes you need at https://developer.sibipro.com."
}

{
  "code": "FORBIDDEN",
  "message": "User does not have permission to update this offer"
}

{
  "code": "OFFER_NOT_FOUND",
  "message": "Offer not found"
}

{
  "code": "INTERNAL_SERVER_ERROR",
  "message": "An unexpected error occurred"
}