Create a shipping rate

Creates a new shipping rate object.

Returns

Returns a shipping rate object if the call succeeded.

Parameters

• display_name (string, required) The name of the shipping rate, meant to be displayable to the customer. This will appear on CheckoutSessions.

  The maximum length is 100 characters.

• delivery_estimate (object, optional) The estimated range for how long shipping will take, meant to be displayable to the customer. This will appear on CheckoutSessions.

  • delivery_estimate.maximum (object, optional) The upper bound of the estimated range. If empty, represents no upper bound i.e., infinite.

    • delivery_estimate.maximum.unit (enum, required) A unit of time. Possible enum values:

      • business_day The delivery estimate is in business days.

      • day The delivery estimate is in days.

      • hour The delivery estimate is in hours.

      • month The delivery estimate is in months.

      • week The delivery estimate is in weeks.

    • delivery_estimate.maximum.value (integer, required) Must be greater than 0.

  • delivery_estimate.minimum (object, optional) The lower bound of the estimated range. If empty, represents no lower bound.

    • delivery_estimate.minimum.unit (enum, required) A unit of time. Possible enum values:

      • business_day The delivery estimate is in business days.

      • day The delivery estimate is in days.

      • hour The delivery estimate is in hours.

      • month The delivery estimate is in months.

      • week The delivery estimate is in weeks.

    • delivery_estimate.minimum.value (integer, required) Must be greater than 0.

• fixed_amount (object, optional) Describes a fixed amount to charge for shipping. Must be present if type is fixed_amount.

  • fixed_amount.amount (integer, required) A non-negative integer in cents representing how much to charge.

  • fixed_amount.currency (enum, required) Three-letter ISO currency code, in lowercase. Must be a supported currency.

  • fixed_amount.currency_options (object, optional) Shipping rates defined in each available currency option. Each key must be a three-letter ISO currency code and a supported currency.

    • fixed_amount.currency_options.<currency>.amount (integer, required) A non-negative integer in cents representing how much to charge.

    • fixed_amount.currency_options.<currency>.tax_behavior (enum, recommended if calculating taxes) Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of inclusive, exclusive, or unspecified. Possible enum values:

      • exclusive
      • inclusive
      • unspecified

• metadata (object, optional) Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

• tax_behavior (enum, recommended if calculating taxes) Specifies whether the rate is considered inclusive of taxes or exclusive of taxes. One of inclusive, exclusive, or unspecified. Possible enum values:

  • exclusive
  • inclusive
  • unspecified

• tax_code (string, recommended if calculating taxes) A tax code ID. The Shipping tax code is txcd_92010001.

• type (enum, required) The type of calculation to use on the shipping rate. Possible enum values:

  • fixed_amount The shipping rate is a fixed amount.

curl https://api.stripe.com/v1/shipping_rates \
  -u "<<YOUR_SECRET_KEY>>" \
  -d "display_name=Ground shipping" \
  -d type=fixed_amount \
  -d "fixed_amount[amount]=500" \
  -d "fixed_amount[currency]=usd"

Response

{
  "id": "shr_1MrRx2LkdIwHu7ixikgEA6Wd",
  "object": "shipping_rate",
  "active": true,
  "created": 1680207604,
  "delivery_estimate": null,
  "display_name": "Ground shipping",
  "fixed_amount": {
    "amount": 500,
    "currency": "usd"
  },
  "livemode": false,
  "metadata": {},
  "tax_behavior": "unspecified",
  "tax_code": null,
  "type": "fixed_amount"
}