BigCommerce
Storefront API
Checkout Coupons

Storefront Checkouts

Add Coupon to Checkout

POST /checkouts/{checkoutId}/coupons

Request

Adds a Coupon Code to Checkout.

Required Fields

  • couponCode

Note

  • Substitute your storefront domain for yourstore.example.com.
  • The Send a Test Request feature is not currently supported for this endpoint.

Parameters

  • store_domain in path - string
  • checkoutId in path - string - required

Body

object | application/json
  • couponCode
    string

example

Response

Body

object | application/json
  • id
    string

  • cart
    object

    A cart contains a collection of items, prices, discounts, etc. It does not contain customer-related data.

  • billingAddress
    object

  • consignments
    array[object]

  • coupons
    array[object]

    Coupons applied at the checkout level.

  • orderId
    string

  • shippingCostTotal
    number

    Shipping cost before any discounts are applied.

  • giftWrappingCostTotal
    number

    Gift wrapping cost for all items, including or excluding tax.

  • handlingCostTotal
    number

    Handling cost for all consignments including or excluding tax.

  • taxTotal
    number

  • taxes
    array[object]

  • subtotal
    number

    Subtotal of the checkout before applying item-level discounts. Tax inclusive based on the store settings.

  • grandTotal
    number

    The total payable amount, before applying any store credit or gift certificate.

  • giftCertificates
    array[array]

    Applied gift certificate (as a payment method).

  • createdTime
    string

    Time when the cart was created.

  • updatedTime
    string

    Time when the cart was last updated.

  • customerMessage
    string

    Shopperʼs message provided as details for the order to be created from this cart

  • outstandingBalance
    number

    grandTotal subtract the store-credit amount

  • isStoreCreditApplied
    boolean

    true value indicates StoreCredit has been applied.

example

Delete Checkout Coupon

DELETE /checkouts/{checkoutId}/coupons/{couponCode}

Request

Deletes a Coupon Code from Checkout.

Note

  • Substitute your storefront domain for yourstore.example.com.
  • The Send a Test Request feature is not currently supported for this endpoint.

Parameters

  • store_domain in path - string
  • checkoutId in path - string - required
  • couponCode in path - string - required

example

Response

Body

object | application/json
  • id
    string

  • cart
    object

    A cart contains a collection of items, prices, discounts, etc. It does not contain customer-related data.

  • billingAddress
    object

  • consignments
    array[object]

  • coupons
    array[object]

    Coupons applied at the checkout level.

  • orderId
    string

  • shippingCostTotal
    number

    Shipping cost before any discounts are applied.

  • giftWrappingCostTotal
    number

    Gift wrapping cost for all items, including or excluding tax.

  • handlingCostTotal
    number

    Handling cost for all consignments including or excluding tax.

  • taxTotal
    number

  • taxes
    array[object]

  • subtotal
    number

    Subtotal of the checkout before applying item-level discounts. Tax inclusive based on the store settings.

  • grandTotal
    number

    The total payable amount, before applying any store credit or gift certificate.

  • giftCertificates
    array[array]

    Applied gift certificate (as a payment method).

  • createdTime
    string

    Time when the cart was created.

  • updatedTime
    string

    Time when the cart was last updated.

  • customerMessage
    string

    Shopperʼs message provided as details for the order to be created from this cart

  • outstandingBalance
    number

    grandTotal subtract the store-credit amount

  • isStoreCreditApplied
    boolean

    true value indicates StoreCredit has been applied.

example

Did you find what you were looking for?