About
This feature enables your shoppers to pay to gift wrap items in their cart.
Availability
Platform | Supported Products |
---|---|
BigCommerce |
|
Custom Cart / Direct API |
Supported for Bolt Embedded Accounts. Includes gift wrapping and messages. |
Adobe Commerce / Magento 2 (Adobe acquired the Magento brand in May 2018.) |
|
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.