API reference · Types
OrderAdditionOfferShippingUpgrade
The shipping option this addition would UPGRADE the parcel to, or null when it rides the one already paid for. All purchased additions share the original parcel: there is never a second shipment. The upgrade becomes the order’s effective option and tracking requirement only when the payment succeeds, and the historical shipping charges are not rewritten - each stays on the payment that collected it. The amount is money.shipping_cents.
Type: object or null
Example
{
"method": "string",
"is_tracked": true
}Fields
methodstring requiredThe upgraded option’s label, in the wording an order’s shipping method uses.
is_trackedboolean requiredWhether the upgraded option requires tracking when the order is marked shipped.
Used by
GET /orders/{orderId}/addition-offers- List an order's add-on offers (not yet available) (response)POST /orders/{orderId}/addition-offers- Send or replace an add-on offer (not yet available) (response)POST /orders/{orderId}/addition-offers/{offerRef}/withdraw- Withdraw an add-on offer (not yet available) (response)order.addition_offer.updated- Add-on offer updated (not yet available) (payload)