πŸ“ Bolt Help / Developers / Developer Guides / Checkout Setup / Implement Gift Options

Implement Gift Options


Gift options is currently available to participating Beta merchants.


Gift options are available to merchants who use one of the following cart platforms:

  • Magento 2
  • BigCommerce
  • Custom cart implementations

Before You Start

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.

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.

πŸ“–On This Page