📍 Bolt Help / Dashboard / Checkout Settings / Gift Options
Gift Options
Learn about offering gift options in your store.

About

This feature enables your shoppers to pay to gift wrap items in their cart.

Availability

Platform Supported Products

BigCommerce

  • Supported for Bolt Managed Checkout.
    • Includes gift wrapping and messages. Supported only for our BigCommerce Payment Only configuration. Reach out to your Bolt CSM for more information.

Custom Cart / Direct API

Adobe Commerce / Magento 2

(Adobe acquired the Magento brand in May 2018.)

  • Supported for Bolt Managed Checkout.
    • Includes gift wrapping and messages. Supported for both Bolt’s Legacy and API plugins.

Features

Gift Wrapping

Pay to Gift Wrap an Item

  • Shoppers can view products with gift options and see the cost to wrap a particular product.
  • Merchants can override the store’s default gift options for individual products in their cart platform.

Add a Gift Message

  • The shopper can enter a gift message when they add an item to their cart. Gift messages for each item are visible during checkout.

Mark Order as Gift

  • Shoppers can choose to mark an order as a gift, and Bolt skips adding an invoice to the order.
  • Shoppers can add different shipping and billing addresses.

Configuration

These instructions assume that you:

  • Have an active Bolt Merchant Account
  • Have reviewed the Bolt Merchant Callback API collection, particularly the order endpoints and the cart endpoints

Enable Paid Gift Options

Contact your customer success manager (CSM) and request that they enable the following feature flag for your merchant division: Enable paid gift wrapping in checkout

Cart Platform Setup

Magento

To enable gift options, refer to Magento’s Gift Options guide.

Bolt checkout supports the following gift settings:

  • Allow Gift Messages for Order Items
  • Allow Gift Wrapping for Order Items

Gift Wrap

Set up at least one gift wrap option. Refer to Magento’s Gift Wrap guide.

You can set the price of a gift wrap option, or you can set the price at the item level.

INFO

Bolt checkout does not currently support the display of gift wrap design thumbnails in checkout.

Override Products

By default, gift options apply to the whole store. Override gift options at the item level for products you wish to exclude from gift options.

BigCommerce

To set up at least one gift option, refer to BigCommerce’s Gift Wrapping guide.

Bolt checkout supports the following gift settings:

  • Price per Product
  • Allow Gift Messages?
  • Visible?

Override Products

By default, gift options apply to the whole store. Override gift options at the item level for products you wish to exclude from gift options.

Refer to BigCommerce’s Product-Level Gift Wrapping.

API Implementation

When a cart includes an item the shopper has marked as a gift, include information about the selected gift option within an item:

“cart”: {
  "items": [
    {"gift_options": {
      "wrap": true,
      "cost": 785,
      "message": "Happy birthday, Jane!",
      "merchant_product_id": 123456
          // This is the corresponding ID in your cart platform
      }
    }
  ]
}

This data structure applies to all endpoints that use a cart object.

Order Management Systems

To calculate order totals that include paid gift options, Bolt creates a hidden cart item that is not visible to shoppers. You’ll see this additional cart item in your order management system for orders that included paid gift options.