Create Order Token
curl --request POST \
--url https://api.bolt.com/v1/merchant/orders \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"cart": {
"total_amount": 900,
"currency": "USD",
"order_reference": "order_100",
"add_ons": [
{
"name": "<string>",
"price": 123,
"productId": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"productPageUrl": "<string>"
}
],
"discounts": [
{
"amount": 100,
"code": "SUMMER10DISCOUNT",
"description": "10% off our summer collection",
"details_url": "https://boltswagstore.com/SUMMERSALE",
"reference": "DISC-1234",
"type": "percentage"
}
],
"fees": [
{
"reference": "ItemFee",
"name": "Item Fee",
"unit_price": 123,
"unit_tax_amount": 123,
"quantity": 123,
"description": "Item Fee"
}
],
"fulfillments": [
{
"cart_items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": [
"summer"
],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": false
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": true,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": true,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"digital_delivery": {
"email": "<string>",
"phone": "<string>"
},
"in_store_cart_shipment": {
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
}
],
"in_store_cart_shipments": [
{
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
],
"items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": [
"summer"
],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": false
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": true,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": true,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"loyalty_rewards": [
{
"amount": 123,
"coupon_code": "<string>",
"description": "$5 off (100 Points)",
"details": "{\"id\": 123456, \"icon\": \"fa-dollar\", \"name\": \"$15.00 Off\", \"type\": \"Coupon\", \"amount\": 100, \"duration\": \"single_use\", \"cost_text\": \"150 Points\", \"description\": \"Get $15 off your next purchase for 150 points\", \"discount_type\": \"fixed_amount\", \"unrendered_name\": \"$15.00 Off\", \"discount_percentage\": null, \"discount_rate_cents\": null, \"discount_value_cents\": null, \"discount_amount_cents\": 1500, \"unrendered_description\": \"Get $15 off your next purchase for 150 points\", \"applies_to_product_type\": \"ALL\"}",
"points": 123,
"source": "<string>",
"type": "<string>"
}
],
"shipments": [
{
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
}
],
"tax_amount": 123,
"cart_url": "https://boltswagstore.com/orders/123456765432",
"display_id": "displayid_100",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"order_description": "Order #1234567890"
},
"create_cart_on_merchant_backend": false,
"metadata": {
"encrypted_user_id": "ID12345678"
},
"user_note": "Happy Birthday to my best friend in the whole world. Enjoy!",
"seller_splits": [
{
"seller_id": "seller-1234",
"amounts": {
"merchant_subtotal": 5000,
"discount_total": 500,
"shipping_total": 1000,
"tax_total": 400,
"gross_total": 5900
},
"marketplace_commission_fee": {
"bps": 250,
"flat_cents": 100,
"metadata": {
"plan_type": "pro",
"tier": "premium"
}
}
}
]
}
'import requests
url = "https://api.bolt.com/v1/merchant/orders"
payload = {
"cart": {
"total_amount": 900,
"currency": "USD",
"order_reference": "order_100",
"add_ons": [
{
"name": "<string>",
"price": 123,
"productId": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"productPageUrl": "<string>"
}
],
"discounts": [
{
"amount": 100,
"code": "SUMMER10DISCOUNT",
"description": "10% off our summer collection",
"details_url": "https://boltswagstore.com/SUMMERSALE",
"reference": "DISC-1234",
"type": "percentage"
}
],
"fees": [
{
"reference": "ItemFee",
"name": "Item Fee",
"unit_price": 123,
"unit_tax_amount": 123,
"quantity": 123,
"description": "Item Fee"
}
],
"fulfillments": [
{
"cart_items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": ["summer"],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": False
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": True,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": True,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"digital_delivery": {
"email": "<string>",
"phone": "<string>"
},
"in_store_cart_shipment": {
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
}
],
"in_store_cart_shipments": [
{
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
],
"items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": ["summer"],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": False
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": True,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": True,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"loyalty_rewards": [
{
"amount": 123,
"coupon_code": "<string>",
"description": "$5 off (100 Points)",
"details": "{\"id\": 123456, \"icon\": \"fa-dollar\", \"name\": \"$15.00 Off\", \"type\": \"Coupon\", \"amount\": 100, \"duration\": \"single_use\", \"cost_text\": \"150 Points\", \"description\": \"Get $15 off your next purchase for 150 points\", \"discount_type\": \"fixed_amount\", \"unrendered_name\": \"$15.00 Off\", \"discount_percentage\": null, \"discount_rate_cents\": null, \"discount_value_cents\": null, \"discount_amount_cents\": 1500, \"unrendered_description\": \"Get $15 off your next purchase for 150 points\", \"applies_to_product_type\": \"ALL\"}",
"points": 123,
"source": "<string>",
"type": "<string>"
}
],
"shipments": [
{
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
}
],
"tax_amount": 123,
"cart_url": "https://boltswagstore.com/orders/123456765432",
"display_id": "displayid_100",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"order_description": "Order #1234567890"
},
"create_cart_on_merchant_backend": False,
"metadata": { "encrypted_user_id": "ID12345678" },
"user_note": "Happy Birthday to my best friend in the whole world. Enjoy!",
"seller_splits": [
{
"seller_id": "seller-1234",
"amounts": {
"merchant_subtotal": 5000,
"discount_total": 500,
"shipping_total": 1000,
"tax_total": 400,
"gross_total": 5900
},
"marketplace_commission_fee": {
"bps": 250,
"flat_cents": 100,
"metadata": {
"plan_type": "pro",
"tier": "premium"
}
}
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cart: {
total_amount: 900,
currency: 'USD',
order_reference: 'order_100',
add_ons: [
{
name: '<string>',
price: 123,
productId: '<string>',
description: '<string>',
imageUrl: '<string>',
productPageUrl: '<string>'
}
],
discounts: [
{
amount: 100,
code: 'SUMMER10DISCOUNT',
description: '10% off our summer collection',
details_url: 'https://boltswagstore.com/SUMMERSALE',
reference: 'DISC-1234',
type: 'percentage'
}
],
fees: [
{
reference: 'ItemFee',
name: 'Item Fee',
unit_price: 123,
unit_tax_amount: 123,
quantity: 123,
description: 'Item Fee'
}
],
fulfillments: [
{
cart_items: [
{
name: 'Bolt Swag Bag',
quantity: 1,
reference: 'item_100',
total_amount: 1000,
unit_price: 1000,
brand: 'Bolt',
category: 'bags',
collections: ['summer'],
color: 'Bolt Blue',
customizations: [{attributes: {key1: 'value1', key2: 'value2'}, name: '<string>', price: 754}],
description: 'Large tote with Bolt logo.',
details_url: 'https://boltswagstore.com/products/123456',
external_inputs: {
shopify_line_item_reference: 123,
shopify_product_reference: 123,
shopify_product_variant_reference: 123
},
gift_option: {
cost: 770,
merchant_product_id: '881',
message: 'Happy Anniversary, Smoochy Poo!',
wrap: false
},
image_url: 'https://boltswagstore.com/products/123456/images/1.png',
isbn: '9780091347314',
item_group: '<string>',
manufacturer: 'Bolt Textiles USA',
merchant_product_id: '881',
merchant_variant_id: '888',
msrp: 123,
options: 'Special Edition',
properties: [
{
color: '<string>',
display: true,
name: '<string>',
name_id: 123,
value: '<string>',
value_id: 123
}
],
shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
size: 'Large',
sku: 'BOLT-SKU_100',
source: '<string>',
seller_id: 'seller-1234',
tags: 'tote, blue, linen, eco-friendly',
tax_amount: 0,
tax_code: '<string>',
taxable: true,
uom: 'inches',
upc: '0825764603119',
weight: 10,
weight_unit: 'pounds'
}
],
cart_shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
digital_delivery: {email: '<string>', phone: '<string>'},
in_store_cart_shipment: {
cart_shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
description: 'Pick up in-store at 123 Main St.',
distance: 3,
distance_unit: 'mile',
pickup_window_close: 123,
pickup_window_open: 123,
store_name: 'Bolt Collective'
}
}
],
in_store_cart_shipments: [
{
cart_shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
description: 'Pick up in-store at 123 Main St.',
distance: 3,
distance_unit: 'mile',
pickup_window_close: 123,
pickup_window_open: 123,
store_name: 'Bolt Collective'
}
],
items: [
{
name: 'Bolt Swag Bag',
quantity: 1,
reference: 'item_100',
total_amount: 1000,
unit_price: 1000,
brand: 'Bolt',
category: 'bags',
collections: ['summer'],
color: 'Bolt Blue',
customizations: [{attributes: {key1: 'value1', key2: 'value2'}, name: '<string>', price: 754}],
description: 'Large tote with Bolt logo.',
details_url: 'https://boltswagstore.com/products/123456',
external_inputs: {
shopify_line_item_reference: 123,
shopify_product_reference: 123,
shopify_product_variant_reference: 123
},
gift_option: {
cost: 770,
merchant_product_id: '881',
message: 'Happy Anniversary, Smoochy Poo!',
wrap: false
},
image_url: 'https://boltswagstore.com/products/123456/images/1.png',
isbn: '9780091347314',
item_group: '<string>',
manufacturer: 'Bolt Textiles USA',
merchant_product_id: '881',
merchant_variant_id: '888',
msrp: 123,
options: 'Special Edition',
properties: [
{
color: '<string>',
display: true,
name: '<string>',
name_id: 123,
value: '<string>',
value_id: 123
}
],
shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
size: 'Large',
sku: 'BOLT-SKU_100',
source: '<string>',
seller_id: 'seller-1234',
tags: 'tote, blue, linen, eco-friendly',
tax_amount: 0,
tax_code: '<string>',
taxable: true,
uom: 'inches',
upc: '0825764603119',
weight: 10,
weight_unit: 'pounds'
}
],
loyalty_rewards: [
{
amount: 123,
coupon_code: '<string>',
description: '$5 off (100 Points)',
details: '{"id": 123456, "icon": "fa-dollar", "name": "$15.00 Off", "type": "Coupon", "amount": 100, "duration": "single_use", "cost_text": "150 Points", "description": "Get $15 off your next purchase for 150 points", "discount_type": "fixed_amount", "unrendered_name": "$15.00 Off", "discount_percentage": null, "discount_rate_cents": null, "discount_value_cents": null, "discount_amount_cents": 1500, "unrendered_description": "Get $15 off your next purchase for 150 points", "applies_to_product_type": "ALL"}',
points: 123,
source: '<string>',
type: '<string>'
}
],
shipments: [
{
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
}
],
tax_amount: 123,
cart_url: 'https://boltswagstore.com/orders/123456765432',
display_id: 'displayid_100',
metadata: {key1: 'value1', key2: 'value2'},
order_description: 'Order #1234567890'
},
create_cart_on_merchant_backend: false,
metadata: {encrypted_user_id: 'ID12345678'},
user_note: 'Happy Birthday to my best friend in the whole world. Enjoy!',
seller_splits: [
{
seller_id: 'seller-1234',
amounts: {
merchant_subtotal: 5000,
discount_total: 500,
shipping_total: 1000,
tax_total: 400,
gross_total: 5900
},
marketplace_commission_fee: {bps: 250, flat_cents: 100, metadata: {plan_type: 'pro', tier: 'premium'}}
}
]
})
};
fetch('https://api.bolt.com/v1/merchant/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bolt.com/v1/merchant/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cart' => [
'total_amount' => 900,
'currency' => 'USD',
'order_reference' => 'order_100',
'add_ons' => [
[
'name' => '<string>',
'price' => 123,
'productId' => '<string>',
'description' => '<string>',
'imageUrl' => '<string>',
'productPageUrl' => '<string>'
]
],
'discounts' => [
[
'amount' => 100,
'code' => 'SUMMER10DISCOUNT',
'description' => '10% off our summer collection',
'details_url' => 'https://boltswagstore.com/SUMMERSALE',
'reference' => 'DISC-1234',
'type' => 'percentage'
]
],
'fees' => [
[
'reference' => 'ItemFee',
'name' => 'Item Fee',
'unit_price' => 123,
'unit_tax_amount' => 123,
'quantity' => 123,
'description' => 'Item Fee'
]
],
'fulfillments' => [
[
'cart_items' => [
[
'name' => 'Bolt Swag Bag',
'quantity' => 1,
'reference' => 'item_100',
'total_amount' => 1000,
'unit_price' => 1000,
'brand' => 'Bolt',
'category' => 'bags',
'collections' => [
'summer'
],
'color' => 'Bolt Blue',
'customizations' => [
[
'attributes' => [
'key1' => 'value1',
'key2' => 'value2'
],
'name' => '<string>',
'price' => 754
]
],
'description' => 'Large tote with Bolt logo.',
'details_url' => 'https://boltswagstore.com/products/123456',
'external_inputs' => [
'shopify_line_item_reference' => 123,
'shopify_product_reference' => 123,
'shopify_product_variant_reference' => 123
],
'gift_option' => [
'cost' => 770,
'merchant_product_id' => '881',
'message' => 'Happy Anniversary, Smoochy Poo!',
'wrap' => false
],
'image_url' => 'https://boltswagstore.com/products/123456/images/1.png',
'isbn' => '9780091347314',
'item_group' => '<string>',
'manufacturer' => 'Bolt Textiles USA',
'merchant_product_id' => '881',
'merchant_variant_id' => '888',
'msrp' => 123,
'options' => 'Special Edition',
'properties' => [
[
'color' => '<string>',
'display' => true,
'name' => '<string>',
'name_id' => 123,
'value' => '<string>',
'value_id' => 123
]
],
'shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'size' => 'Large',
'sku' => 'BOLT-SKU_100',
'source' => '<string>',
'seller_id' => 'seller-1234',
'tags' => 'tote, blue, linen, eco-friendly',
'tax_amount' => 0,
'tax_code' => '<string>',
'taxable' => true,
'uom' => 'inches',
'upc' => '0825764603119',
'weight' => 10,
'weight_unit' => 'pounds'
]
],
'cart_shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'digital_delivery' => [
'email' => '<string>',
'phone' => '<string>'
],
'in_store_cart_shipment' => [
'cart_shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'description' => 'Pick up in-store at 123 Main St.',
'distance' => 3,
'distance_unit' => 'mile',
'pickup_window_close' => 123,
'pickup_window_open' => 123,
'store_name' => 'Bolt Collective'
]
]
],
'in_store_cart_shipments' => [
[
'cart_shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'description' => 'Pick up in-store at 123 Main St.',
'distance' => 3,
'distance_unit' => 'mile',
'pickup_window_close' => 123,
'pickup_window_open' => 123,
'store_name' => 'Bolt Collective'
]
],
'items' => [
[
'name' => 'Bolt Swag Bag',
'quantity' => 1,
'reference' => 'item_100',
'total_amount' => 1000,
'unit_price' => 1000,
'brand' => 'Bolt',
'category' => 'bags',
'collections' => [
'summer'
],
'color' => 'Bolt Blue',
'customizations' => [
[
'attributes' => [
'key1' => 'value1',
'key2' => 'value2'
],
'name' => '<string>',
'price' => 754
]
],
'description' => 'Large tote with Bolt logo.',
'details_url' => 'https://boltswagstore.com/products/123456',
'external_inputs' => [
'shopify_line_item_reference' => 123,
'shopify_product_reference' => 123,
'shopify_product_variant_reference' => 123
],
'gift_option' => [
'cost' => 770,
'merchant_product_id' => '881',
'message' => 'Happy Anniversary, Smoochy Poo!',
'wrap' => false
],
'image_url' => 'https://boltswagstore.com/products/123456/images/1.png',
'isbn' => '9780091347314',
'item_group' => '<string>',
'manufacturer' => 'Bolt Textiles USA',
'merchant_product_id' => '881',
'merchant_variant_id' => '888',
'msrp' => 123,
'options' => 'Special Edition',
'properties' => [
[
'color' => '<string>',
'display' => true,
'name' => '<string>',
'name_id' => 123,
'value' => '<string>',
'value_id' => 123
]
],
'shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'size' => 'Large',
'sku' => 'BOLT-SKU_100',
'source' => '<string>',
'seller_id' => 'seller-1234',
'tags' => 'tote, blue, linen, eco-friendly',
'tax_amount' => 0,
'tax_code' => '<string>',
'taxable' => true,
'uom' => 'inches',
'upc' => '0825764603119',
'weight' => 10,
'weight_unit' => 'pounds'
]
],
'loyalty_rewards' => [
[
'amount' => 123,
'coupon_code' => '<string>',
'description' => '$5 off (100 Points)',
'details' => '{"id": 123456, "icon": "fa-dollar", "name": "$15.00 Off", "type": "Coupon", "amount": 100, "duration": "single_use", "cost_text": "150 Points", "description": "Get $15 off your next purchase for 150 points", "discount_type": "fixed_amount", "unrendered_name": "$15.00 Off", "discount_percentage": null, "discount_rate_cents": null, "discount_value_cents": null, "discount_amount_cents": 1500, "unrendered_description": "Get $15 off your next purchase for 150 points", "applies_to_product_type": "ALL"}',
'points' => 123,
'source' => '<string>',
'type' => '<string>'
]
],
'shipments' => [
[
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
]
],
'tax_amount' => 123,
'cart_url' => 'https://boltswagstore.com/orders/123456765432',
'display_id' => 'displayid_100',
'metadata' => [
'key1' => 'value1',
'key2' => 'value2'
],
'order_description' => 'Order #1234567890'
],
'create_cart_on_merchant_backend' => false,
'metadata' => [
'encrypted_user_id' => 'ID12345678'
],
'user_note' => 'Happy Birthday to my best friend in the whole world. Enjoy!',
'seller_splits' => [
[
'seller_id' => 'seller-1234',
'amounts' => [
'merchant_subtotal' => 5000,
'discount_total' => 500,
'shipping_total' => 1000,
'tax_total' => 400,
'gross_total' => 5900
],
'marketplace_commission_fee' => [
'bps' => 250,
'flat_cents' => 100,
'metadata' => [
'plan_type' => 'pro',
'tier' => 'premium'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bolt.com/v1/merchant/orders"
payload := strings.NewReader("{\n \"cart\": {\n \"total_amount\": 900,\n \"currency\": \"USD\",\n \"order_reference\": \"order_100\",\n \"add_ons\": [\n {\n \"name\": \"<string>\",\n \"price\": 123,\n \"productId\": \"<string>\",\n \"description\": \"<string>\",\n \"imageUrl\": \"<string>\",\n \"productPageUrl\": \"<string>\"\n }\n ],\n \"discounts\": [\n {\n \"amount\": 100,\n \"code\": \"SUMMER10DISCOUNT\",\n \"description\": \"10% off our summer collection\",\n \"details_url\": \"https://boltswagstore.com/SUMMERSALE\",\n \"reference\": \"DISC-1234\",\n \"type\": \"percentage\"\n }\n ],\n \"fees\": [\n {\n \"reference\": \"ItemFee\",\n \"name\": \"Item Fee\",\n \"unit_price\": 123,\n \"unit_tax_amount\": 123,\n \"quantity\": 123,\n \"description\": \"Item Fee\"\n }\n ],\n \"fulfillments\": [\n {\n \"cart_items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"digital_delivery\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"in_store_cart_shipment\": {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n }\n ],\n \"in_store_cart_shipments\": [\n {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n ],\n \"items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"loyalty_rewards\": [\n {\n \"amount\": 123,\n \"coupon_code\": \"<string>\",\n \"description\": \"$5 off (100 Points)\",\n \"details\": \"{\\\"id\\\": 123456, \\\"icon\\\": \\\"fa-dollar\\\", \\\"name\\\": \\\"$15.00 Off\\\", \\\"type\\\": \\\"Coupon\\\", \\\"amount\\\": 100, \\\"duration\\\": \\\"single_use\\\", \\\"cost_text\\\": \\\"150 Points\\\", \\\"description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"discount_type\\\": \\\"fixed_amount\\\", \\\"unrendered_name\\\": \\\"$15.00 Off\\\", \\\"discount_percentage\\\": null, \\\"discount_rate_cents\\\": null, \\\"discount_value_cents\\\": null, \\\"discount_amount_cents\\\": 1500, \\\"unrendered_description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"applies_to_product_type\\\": \\\"ALL\\\"}\",\n \"points\": 123,\n \"source\": \"<string>\",\n \"type\": \"<string>\"\n }\n ],\n \"shipments\": [\n {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n }\n ],\n \"tax_amount\": 123,\n \"cart_url\": \"https://boltswagstore.com/orders/123456765432\",\n \"display_id\": \"displayid_100\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"order_description\": \"Order #1234567890\"\n },\n \"create_cart_on_merchant_backend\": false,\n \"metadata\": {\n \"encrypted_user_id\": \"ID12345678\"\n },\n \"user_note\": \"Happy Birthday to my best friend in the whole world. Enjoy!\",\n \"seller_splits\": [\n {\n \"seller_id\": \"seller-1234\",\n \"amounts\": {\n \"merchant_subtotal\": 5000,\n \"discount_total\": 500,\n \"shipping_total\": 1000,\n \"tax_total\": 400,\n \"gross_total\": 5900\n },\n \"marketplace_commission_fee\": {\n \"bps\": 250,\n \"flat_cents\": 100,\n \"metadata\": {\n \"plan_type\": \"pro\",\n \"tier\": \"premium\"\n }\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bolt.com/v1/merchant/orders")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cart\": {\n \"total_amount\": 900,\n \"currency\": \"USD\",\n \"order_reference\": \"order_100\",\n \"add_ons\": [\n {\n \"name\": \"<string>\",\n \"price\": 123,\n \"productId\": \"<string>\",\n \"description\": \"<string>\",\n \"imageUrl\": \"<string>\",\n \"productPageUrl\": \"<string>\"\n }\n ],\n \"discounts\": [\n {\n \"amount\": 100,\n \"code\": \"SUMMER10DISCOUNT\",\n \"description\": \"10% off our summer collection\",\n \"details_url\": \"https://boltswagstore.com/SUMMERSALE\",\n \"reference\": \"DISC-1234\",\n \"type\": \"percentage\"\n }\n ],\n \"fees\": [\n {\n \"reference\": \"ItemFee\",\n \"name\": \"Item Fee\",\n \"unit_price\": 123,\n \"unit_tax_amount\": 123,\n \"quantity\": 123,\n \"description\": \"Item Fee\"\n }\n ],\n \"fulfillments\": [\n {\n \"cart_items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"digital_delivery\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"in_store_cart_shipment\": {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n }\n ],\n \"in_store_cart_shipments\": [\n {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n ],\n \"items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"loyalty_rewards\": [\n {\n \"amount\": 123,\n \"coupon_code\": \"<string>\",\n \"description\": \"$5 off (100 Points)\",\n \"details\": \"{\\\"id\\\": 123456, \\\"icon\\\": \\\"fa-dollar\\\", \\\"name\\\": \\\"$15.00 Off\\\", \\\"type\\\": \\\"Coupon\\\", \\\"amount\\\": 100, \\\"duration\\\": \\\"single_use\\\", \\\"cost_text\\\": \\\"150 Points\\\", \\\"description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"discount_type\\\": \\\"fixed_amount\\\", \\\"unrendered_name\\\": \\\"$15.00 Off\\\", \\\"discount_percentage\\\": null, \\\"discount_rate_cents\\\": null, \\\"discount_value_cents\\\": null, \\\"discount_amount_cents\\\": 1500, \\\"unrendered_description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"applies_to_product_type\\\": \\\"ALL\\\"}\",\n \"points\": 123,\n \"source\": \"<string>\",\n \"type\": \"<string>\"\n }\n ],\n \"shipments\": [\n {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n }\n ],\n \"tax_amount\": 123,\n \"cart_url\": \"https://boltswagstore.com/orders/123456765432\",\n \"display_id\": \"displayid_100\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"order_description\": \"Order #1234567890\"\n },\n \"create_cart_on_merchant_backend\": false,\n \"metadata\": {\n \"encrypted_user_id\": \"ID12345678\"\n },\n \"user_note\": \"Happy Birthday to my best friend in the whole world. Enjoy!\",\n \"seller_splits\": [\n {\n \"seller_id\": \"seller-1234\",\n \"amounts\": {\n \"merchant_subtotal\": 5000,\n \"discount_total\": 500,\n \"shipping_total\": 1000,\n \"tax_total\": 400,\n \"gross_total\": 5900\n },\n \"marketplace_commission_fee\": {\n \"bps\": 250,\n \"flat_cents\": 100,\n \"metadata\": {\n \"plan_type\": \"pro\",\n \"tier\": \"premium\"\n }\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bolt.com/v1/merchant/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cart\": {\n \"total_amount\": 900,\n \"currency\": \"USD\",\n \"order_reference\": \"order_100\",\n \"add_ons\": [\n {\n \"name\": \"<string>\",\n \"price\": 123,\n \"productId\": \"<string>\",\n \"description\": \"<string>\",\n \"imageUrl\": \"<string>\",\n \"productPageUrl\": \"<string>\"\n }\n ],\n \"discounts\": [\n {\n \"amount\": 100,\n \"code\": \"SUMMER10DISCOUNT\",\n \"description\": \"10% off our summer collection\",\n \"details_url\": \"https://boltswagstore.com/SUMMERSALE\",\n \"reference\": \"DISC-1234\",\n \"type\": \"percentage\"\n }\n ],\n \"fees\": [\n {\n \"reference\": \"ItemFee\",\n \"name\": \"Item Fee\",\n \"unit_price\": 123,\n \"unit_tax_amount\": 123,\n \"quantity\": 123,\n \"description\": \"Item Fee\"\n }\n ],\n \"fulfillments\": [\n {\n \"cart_items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"digital_delivery\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"in_store_cart_shipment\": {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n }\n ],\n \"in_store_cart_shipments\": [\n {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n ],\n \"items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"loyalty_rewards\": [\n {\n \"amount\": 123,\n \"coupon_code\": \"<string>\",\n \"description\": \"$5 off (100 Points)\",\n \"details\": \"{\\\"id\\\": 123456, \\\"icon\\\": \\\"fa-dollar\\\", \\\"name\\\": \\\"$15.00 Off\\\", \\\"type\\\": \\\"Coupon\\\", \\\"amount\\\": 100, \\\"duration\\\": \\\"single_use\\\", \\\"cost_text\\\": \\\"150 Points\\\", \\\"description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"discount_type\\\": \\\"fixed_amount\\\", \\\"unrendered_name\\\": \\\"$15.00 Off\\\", \\\"discount_percentage\\\": null, \\\"discount_rate_cents\\\": null, \\\"discount_value_cents\\\": null, \\\"discount_amount_cents\\\": 1500, \\\"unrendered_description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"applies_to_product_type\\\": \\\"ALL\\\"}\",\n \"points\": 123,\n \"source\": \"<string>\",\n \"type\": \"<string>\"\n }\n ],\n \"shipments\": [\n {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n }\n ],\n \"tax_amount\": 123,\n \"cart_url\": \"https://boltswagstore.com/orders/123456765432\",\n \"display_id\": \"displayid_100\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"order_description\": \"Order #1234567890\"\n },\n \"create_cart_on_merchant_backend\": false,\n \"metadata\": {\n \"encrypted_user_id\": \"ID12345678\"\n },\n \"user_note\": \"Happy Birthday to my best friend in the whole world. Enjoy!\",\n \"seller_splits\": [\n {\n \"seller_id\": \"seller-1234\",\n \"amounts\": {\n \"merchant_subtotal\": 5000,\n \"discount_total\": 500,\n \"shipping_total\": 1000,\n \"tax_total\": 400,\n \"gross_total\": 5900\n },\n \"marketplace_commission_fee\": {\n \"bps\": 250,\n \"flat_cents\": 100,\n \"metadata\": {\n \"plan_type\": \"pro\",\n \"tier\": \"premium\"\n }\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"cart": {
"billing_address": {
"company": "Bolt",
"country": "United States",
"country_code": "US",
"door_code": "123456",
"email_address": "alan.watts@example.com",
"first_name": "Alan",
"id": "<string>",
"last_name": "Watts",
"locality": "Brooklyn",
"name": "Alan Watts",
"phone_number": "+12125550199",
"postal_code": "10044",
"priority": "primary",
"region": "NY",
"region_code": "NY",
"street_address1": "888 main street",
"street_address2": "apt 3021",
"street_address3": "c/o Alicia Watts",
"street_address4": "Bridge Street Apartment Building B"
},
"cart_url": "https://boltswagstore.com/orders/123456765432",
"currency": {
"currency": "USD",
"currency_symbol": "$"
},
"discount_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"discounts": [
{
"amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"code": "SUMMER10",
"description": "10% off our summer collection",
"details_url": "https://boltswagstore.com/SUMMERSALE",
"free_shipping": {
"is_free_shipping": true,
"maximum_cost_allowed": 123
},
"reference": "DISC-1234"
}
],
"display_id": "displayid_100",
"fee_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"fees": [
{
"reference": "ItemFee",
"name": "Item Fee",
"description": "Item Fee",
"unit_price": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"unit_tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"quantity": 123
}
],
"items": [
{
"bolt_product_id": "<string>",
"brand": "<string>",
"category": "bags",
"collections": [
"summer"
],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "<string>",
"details_url": "https://boltswagstore.com/products/123456",
"gift_option": {
"hide_gift_message": false,
"hide_gift_wrap": false
},
"hide": true,
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": 9780091347314,
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "<string>",
"merchant_variant_id": "<string>",
"msrp": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"name": "<string>",
"options": "<string>",
"properties": [
{
"color": "<string>",
"display": true,
"name": "<string>",
"value": "<string>"
}
],
"quantity": 1,
"reference": "<string>",
"shipment_id": "<string>",
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123,
"size": "Large",
"sku": "BOLT-SKU_100",
"subscription": {
"frequency": {
"unit": "month",
"value": 2
}
},
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"taxable": true,
"total_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"unit_price": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"uom": "inches",
"upc": "0825764603119",
"weight": {
"unit": "<string>",
"weight": 123
}
}
],
"merchant_order_url": "<string>",
"order_description": "Order #1234567890",
"order_reference": "order_100",
"shipments": [
{
"carrier": "USPS",
"cost": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"default": true,
"description": [
{
"content": "<string>",
"is_html": true
}
],
"description_tooltips": [
{
"html_content": "<string>",
"target": 123
}
],
"estimated_delivery_date": "2022-04-10 16:12:38.386000+00:00",
"expedited": true,
"gift_options": {
"hide_gift_message": false,
"hide_gift_wrap": false
},
"id": "<string>",
"package_dimension": {
"depth": 123,
"height": 123,
"unit": "<string>",
"width": 123
},
"package_type": "<string>",
"package_weight": {
"unit": "<string>",
"weight": 123
},
"reference": "<string>",
"service": "<string>",
"shipping_address": {
"company": "Bolt",
"country": "United States",
"country_code": "US",
"door_code": "123456",
"email_address": "alan.watts@example.com",
"first_name": "Alan",
"id": "<string>",
"last_name": "Watts",
"locality": "Brooklyn",
"name": "Alan Watts",
"phone_number": "+12125550199",
"postal_code": "10044",
"priority": "primary",
"region": "NY",
"region_code": "NY",
"street_address1": "888 main street",
"street_address2": "apt 3021",
"street_address3": "c/o Alicia Watts",
"street_address4": "Bridge Street Apartment Building B"
},
"shipping_method": "<string>",
"signature": "<string>",
"tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"total_weight": {
"unit": "<string>",
"weight": 123
},
"type": "<string>"
}
],
"shipping_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"subtotal_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"total_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"transaction_reference": "6CEA-ZME1-DACE"
},
"dynamic_content": {
"custom_fields": [
{
"dynamic": true,
"external_id": "<string>",
"field_setup": "<string>",
"helper_text": "<string>",
"label": "<string>",
"position": 123,
"public_id": "<string>",
"required": true,
"subscribeToNewsletter": true
}
],
"eligible_payment_methods": [
{
"eligible": true
}
],
"gift_option_view": {
"hide_gift_message": true,
"hide_gift_wrap": true
},
"hide_apm": [],
"order_notice": "<string>",
"payment_notice": "<string>",
"shipping_info_notice": "<string>",
"shipping_notice": "<string>"
},
"external_data": {
"steam_id": "<string>"
},
"token": "<string>",
"user_note": "<string>"
}{
"errors": [
{
"code": 2001005,
"message": "The input is missing a required parameter."
}
],
"result": {
"success": false
}
}{
"errors": [
{
"code": 2001005,
"message": "The input is missing a required parameter."
}
],
"result": {
"success": false
}
}{
"errors": [
{
"code": 2001005,
"message": "The input is missing a required parameter."
}
],
"result": {
"success": false
}
}Orders
Create Order Token
Make a request to this endpoint to create a Bolt order, generate a Bolt order token, and initiate the checkout process. A Bolt order token is required for Bolt orders; see Non-Bolt orders for alternative use cases.
POST
/
v1
/
merchant
/
orders
Create Order Token
curl --request POST \
--url https://api.bolt.com/v1/merchant/orders \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"cart": {
"total_amount": 900,
"currency": "USD",
"order_reference": "order_100",
"add_ons": [
{
"name": "<string>",
"price": 123,
"productId": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"productPageUrl": "<string>"
}
],
"discounts": [
{
"amount": 100,
"code": "SUMMER10DISCOUNT",
"description": "10% off our summer collection",
"details_url": "https://boltswagstore.com/SUMMERSALE",
"reference": "DISC-1234",
"type": "percentage"
}
],
"fees": [
{
"reference": "ItemFee",
"name": "Item Fee",
"unit_price": 123,
"unit_tax_amount": 123,
"quantity": 123,
"description": "Item Fee"
}
],
"fulfillments": [
{
"cart_items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": [
"summer"
],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": false
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": true,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": true,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"digital_delivery": {
"email": "<string>",
"phone": "<string>"
},
"in_store_cart_shipment": {
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
}
],
"in_store_cart_shipments": [
{
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
],
"items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": [
"summer"
],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": false
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": true,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": true,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"loyalty_rewards": [
{
"amount": 123,
"coupon_code": "<string>",
"description": "$5 off (100 Points)",
"details": "{\"id\": 123456, \"icon\": \"fa-dollar\", \"name\": \"$15.00 Off\", \"type\": \"Coupon\", \"amount\": 100, \"duration\": \"single_use\", \"cost_text\": \"150 Points\", \"description\": \"Get $15 off your next purchase for 150 points\", \"discount_type\": \"fixed_amount\", \"unrendered_name\": \"$15.00 Off\", \"discount_percentage\": null, \"discount_rate_cents\": null, \"discount_value_cents\": null, \"discount_amount_cents\": 1500, \"unrendered_description\": \"Get $15 off your next purchase for 150 points\", \"applies_to_product_type\": \"ALL\"}",
"points": 123,
"source": "<string>",
"type": "<string>"
}
],
"shipments": [
{
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": false,
"estimated_delivery_date": "08-30-2022",
"expedited": false,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
}
],
"tax_amount": 123,
"cart_url": "https://boltswagstore.com/orders/123456765432",
"display_id": "displayid_100",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"order_description": "Order #1234567890"
},
"create_cart_on_merchant_backend": false,
"metadata": {
"encrypted_user_id": "ID12345678"
},
"user_note": "Happy Birthday to my best friend in the whole world. Enjoy!",
"seller_splits": [
{
"seller_id": "seller-1234",
"amounts": {
"merchant_subtotal": 5000,
"discount_total": 500,
"shipping_total": 1000,
"tax_total": 400,
"gross_total": 5900
},
"marketplace_commission_fee": {
"bps": 250,
"flat_cents": 100,
"metadata": {
"plan_type": "pro",
"tier": "premium"
}
}
}
]
}
'import requests
url = "https://api.bolt.com/v1/merchant/orders"
payload = {
"cart": {
"total_amount": 900,
"currency": "USD",
"order_reference": "order_100",
"add_ons": [
{
"name": "<string>",
"price": 123,
"productId": "<string>",
"description": "<string>",
"imageUrl": "<string>",
"productPageUrl": "<string>"
}
],
"discounts": [
{
"amount": 100,
"code": "SUMMER10DISCOUNT",
"description": "10% off our summer collection",
"details_url": "https://boltswagstore.com/SUMMERSALE",
"reference": "DISC-1234",
"type": "percentage"
}
],
"fees": [
{
"reference": "ItemFee",
"name": "Item Fee",
"unit_price": 123,
"unit_tax_amount": 123,
"quantity": 123,
"description": "Item Fee"
}
],
"fulfillments": [
{
"cart_items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": ["summer"],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": False
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": True,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": True,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"digital_delivery": {
"email": "<string>",
"phone": "<string>"
},
"in_store_cart_shipment": {
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
}
],
"in_store_cart_shipments": [
{
"cart_shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"description": "Pick up in-store at 123 Main St.",
"distance": 3,
"distance_unit": "mile",
"pickup_window_close": 123,
"pickup_window_open": 123,
"store_name": "Bolt Collective"
}
],
"items": [
{
"name": "Bolt Swag Bag",
"quantity": 1,
"reference": "item_100",
"total_amount": 1000,
"unit_price": 1000,
"brand": "Bolt",
"category": "bags",
"collections": ["summer"],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "Large tote with Bolt logo.",
"details_url": "https://boltswagstore.com/products/123456",
"external_inputs": {
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123
},
"gift_option": {
"cost": 770,
"merchant_product_id": "881",
"message": "Happy Anniversary, Smoochy Poo!",
"wrap": False
},
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": "9780091347314",
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "881",
"merchant_variant_id": "888",
"msrp": 123,
"options": "Special Edition",
"properties": [
{
"color": "<string>",
"display": True,
"name": "<string>",
"name_id": 123,
"value": "<string>",
"value_id": 123
}
],
"shipment": {
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
},
"size": "Large",
"sku": "BOLT-SKU_100",
"source": "<string>",
"seller_id": "seller-1234",
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": 0,
"tax_code": "<string>",
"taxable": True,
"uom": "inches",
"upc": "0825764603119",
"weight": 10,
"weight_unit": "pounds"
}
],
"loyalty_rewards": [
{
"amount": 123,
"coupon_code": "<string>",
"description": "$5 off (100 Points)",
"details": "{\"id\": 123456, \"icon\": \"fa-dollar\", \"name\": \"$15.00 Off\", \"type\": \"Coupon\", \"amount\": 100, \"duration\": \"single_use\", \"cost_text\": \"150 Points\", \"description\": \"Get $15 off your next purchase for 150 points\", \"discount_type\": \"fixed_amount\", \"unrendered_name\": \"$15.00 Off\", \"discount_percentage\": null, \"discount_rate_cents\": null, \"discount_value_cents\": null, \"discount_amount_cents\": 1500, \"unrendered_description\": \"Get $15 off your next purchase for 150 points\", \"applies_to_product_type\": \"ALL\"}",
"points": 123,
"source": "<string>",
"type": "<string>"
}
],
"shipments": [
{
"carrier": "FedEx",
"cost": 770,
"discounted_by_membership": False,
"estimated_delivery_date": "08-30-2022",
"expedited": False,
"package_depth": 90,
"package_dimension_unit": "cm",
"package_height": 103,
"package_type": "A big package.",
"package_weight_unit": "kg",
"package_width": 222,
"service": "Option 1",
"shipping_address_id": "address1",
"shipping_method": "unknown",
"signature": "a1B2s3dC4f5g5D6hj6E7k8F9l0",
"tax_amount": 230,
"tax_code": "tax-12345",
"total_weight": 55,
"total_weight_unit": "kg",
"type": "door_delivery"
}
],
"tax_amount": 123,
"cart_url": "https://boltswagstore.com/orders/123456765432",
"display_id": "displayid_100",
"metadata": {
"key1": "value1",
"key2": "value2"
},
"order_description": "Order #1234567890"
},
"create_cart_on_merchant_backend": False,
"metadata": { "encrypted_user_id": "ID12345678" },
"user_note": "Happy Birthday to my best friend in the whole world. Enjoy!",
"seller_splits": [
{
"seller_id": "seller-1234",
"amounts": {
"merchant_subtotal": 5000,
"discount_total": 500,
"shipping_total": 1000,
"tax_total": 400,
"gross_total": 5900
},
"marketplace_commission_fee": {
"bps": 250,
"flat_cents": 100,
"metadata": {
"plan_type": "pro",
"tier": "premium"
}
}
}
]
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
cart: {
total_amount: 900,
currency: 'USD',
order_reference: 'order_100',
add_ons: [
{
name: '<string>',
price: 123,
productId: '<string>',
description: '<string>',
imageUrl: '<string>',
productPageUrl: '<string>'
}
],
discounts: [
{
amount: 100,
code: 'SUMMER10DISCOUNT',
description: '10% off our summer collection',
details_url: 'https://boltswagstore.com/SUMMERSALE',
reference: 'DISC-1234',
type: 'percentage'
}
],
fees: [
{
reference: 'ItemFee',
name: 'Item Fee',
unit_price: 123,
unit_tax_amount: 123,
quantity: 123,
description: 'Item Fee'
}
],
fulfillments: [
{
cart_items: [
{
name: 'Bolt Swag Bag',
quantity: 1,
reference: 'item_100',
total_amount: 1000,
unit_price: 1000,
brand: 'Bolt',
category: 'bags',
collections: ['summer'],
color: 'Bolt Blue',
customizations: [{attributes: {key1: 'value1', key2: 'value2'}, name: '<string>', price: 754}],
description: 'Large tote with Bolt logo.',
details_url: 'https://boltswagstore.com/products/123456',
external_inputs: {
shopify_line_item_reference: 123,
shopify_product_reference: 123,
shopify_product_variant_reference: 123
},
gift_option: {
cost: 770,
merchant_product_id: '881',
message: 'Happy Anniversary, Smoochy Poo!',
wrap: false
},
image_url: 'https://boltswagstore.com/products/123456/images/1.png',
isbn: '9780091347314',
item_group: '<string>',
manufacturer: 'Bolt Textiles USA',
merchant_product_id: '881',
merchant_variant_id: '888',
msrp: 123,
options: 'Special Edition',
properties: [
{
color: '<string>',
display: true,
name: '<string>',
name_id: 123,
value: '<string>',
value_id: 123
}
],
shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
size: 'Large',
sku: 'BOLT-SKU_100',
source: '<string>',
seller_id: 'seller-1234',
tags: 'tote, blue, linen, eco-friendly',
tax_amount: 0,
tax_code: '<string>',
taxable: true,
uom: 'inches',
upc: '0825764603119',
weight: 10,
weight_unit: 'pounds'
}
],
cart_shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
digital_delivery: {email: '<string>', phone: '<string>'},
in_store_cart_shipment: {
cart_shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
description: 'Pick up in-store at 123 Main St.',
distance: 3,
distance_unit: 'mile',
pickup_window_close: 123,
pickup_window_open: 123,
store_name: 'Bolt Collective'
}
}
],
in_store_cart_shipments: [
{
cart_shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
description: 'Pick up in-store at 123 Main St.',
distance: 3,
distance_unit: 'mile',
pickup_window_close: 123,
pickup_window_open: 123,
store_name: 'Bolt Collective'
}
],
items: [
{
name: 'Bolt Swag Bag',
quantity: 1,
reference: 'item_100',
total_amount: 1000,
unit_price: 1000,
brand: 'Bolt',
category: 'bags',
collections: ['summer'],
color: 'Bolt Blue',
customizations: [{attributes: {key1: 'value1', key2: 'value2'}, name: '<string>', price: 754}],
description: 'Large tote with Bolt logo.',
details_url: 'https://boltswagstore.com/products/123456',
external_inputs: {
shopify_line_item_reference: 123,
shopify_product_reference: 123,
shopify_product_variant_reference: 123
},
gift_option: {
cost: 770,
merchant_product_id: '881',
message: 'Happy Anniversary, Smoochy Poo!',
wrap: false
},
image_url: 'https://boltswagstore.com/products/123456/images/1.png',
isbn: '9780091347314',
item_group: '<string>',
manufacturer: 'Bolt Textiles USA',
merchant_product_id: '881',
merchant_variant_id: '888',
msrp: 123,
options: 'Special Edition',
properties: [
{
color: '<string>',
display: true,
name: '<string>',
name_id: 123,
value: '<string>',
value_id: 123
}
],
shipment: {
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
},
size: 'Large',
sku: 'BOLT-SKU_100',
source: '<string>',
seller_id: 'seller-1234',
tags: 'tote, blue, linen, eco-friendly',
tax_amount: 0,
tax_code: '<string>',
taxable: true,
uom: 'inches',
upc: '0825764603119',
weight: 10,
weight_unit: 'pounds'
}
],
loyalty_rewards: [
{
amount: 123,
coupon_code: '<string>',
description: '$5 off (100 Points)',
details: '{"id": 123456, "icon": "fa-dollar", "name": "$15.00 Off", "type": "Coupon", "amount": 100, "duration": "single_use", "cost_text": "150 Points", "description": "Get $15 off your next purchase for 150 points", "discount_type": "fixed_amount", "unrendered_name": "$15.00 Off", "discount_percentage": null, "discount_rate_cents": null, "discount_value_cents": null, "discount_amount_cents": 1500, "unrendered_description": "Get $15 off your next purchase for 150 points", "applies_to_product_type": "ALL"}',
points: 123,
source: '<string>',
type: '<string>'
}
],
shipments: [
{
carrier: 'FedEx',
cost: 770,
discounted_by_membership: false,
estimated_delivery_date: '08-30-2022',
expedited: false,
package_depth: 90,
package_dimension_unit: 'cm',
package_height: 103,
package_type: 'A big package.',
package_weight_unit: 'kg',
package_width: 222,
service: 'Option 1',
shipping_address_id: 'address1',
shipping_method: 'unknown',
signature: 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
tax_amount: 230,
tax_code: 'tax-12345',
total_weight: 55,
total_weight_unit: 'kg',
type: 'door_delivery'
}
],
tax_amount: 123,
cart_url: 'https://boltswagstore.com/orders/123456765432',
display_id: 'displayid_100',
metadata: {key1: 'value1', key2: 'value2'},
order_description: 'Order #1234567890'
},
create_cart_on_merchant_backend: false,
metadata: {encrypted_user_id: 'ID12345678'},
user_note: 'Happy Birthday to my best friend in the whole world. Enjoy!',
seller_splits: [
{
seller_id: 'seller-1234',
amounts: {
merchant_subtotal: 5000,
discount_total: 500,
shipping_total: 1000,
tax_total: 400,
gross_total: 5900
},
marketplace_commission_fee: {bps: 250, flat_cents: 100, metadata: {plan_type: 'pro', tier: 'premium'}}
}
]
})
};
fetch('https://api.bolt.com/v1/merchant/orders', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bolt.com/v1/merchant/orders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'cart' => [
'total_amount' => 900,
'currency' => 'USD',
'order_reference' => 'order_100',
'add_ons' => [
[
'name' => '<string>',
'price' => 123,
'productId' => '<string>',
'description' => '<string>',
'imageUrl' => '<string>',
'productPageUrl' => '<string>'
]
],
'discounts' => [
[
'amount' => 100,
'code' => 'SUMMER10DISCOUNT',
'description' => '10% off our summer collection',
'details_url' => 'https://boltswagstore.com/SUMMERSALE',
'reference' => 'DISC-1234',
'type' => 'percentage'
]
],
'fees' => [
[
'reference' => 'ItemFee',
'name' => 'Item Fee',
'unit_price' => 123,
'unit_tax_amount' => 123,
'quantity' => 123,
'description' => 'Item Fee'
]
],
'fulfillments' => [
[
'cart_items' => [
[
'name' => 'Bolt Swag Bag',
'quantity' => 1,
'reference' => 'item_100',
'total_amount' => 1000,
'unit_price' => 1000,
'brand' => 'Bolt',
'category' => 'bags',
'collections' => [
'summer'
],
'color' => 'Bolt Blue',
'customizations' => [
[
'attributes' => [
'key1' => 'value1',
'key2' => 'value2'
],
'name' => '<string>',
'price' => 754
]
],
'description' => 'Large tote with Bolt logo.',
'details_url' => 'https://boltswagstore.com/products/123456',
'external_inputs' => [
'shopify_line_item_reference' => 123,
'shopify_product_reference' => 123,
'shopify_product_variant_reference' => 123
],
'gift_option' => [
'cost' => 770,
'merchant_product_id' => '881',
'message' => 'Happy Anniversary, Smoochy Poo!',
'wrap' => false
],
'image_url' => 'https://boltswagstore.com/products/123456/images/1.png',
'isbn' => '9780091347314',
'item_group' => '<string>',
'manufacturer' => 'Bolt Textiles USA',
'merchant_product_id' => '881',
'merchant_variant_id' => '888',
'msrp' => 123,
'options' => 'Special Edition',
'properties' => [
[
'color' => '<string>',
'display' => true,
'name' => '<string>',
'name_id' => 123,
'value' => '<string>',
'value_id' => 123
]
],
'shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'size' => 'Large',
'sku' => 'BOLT-SKU_100',
'source' => '<string>',
'seller_id' => 'seller-1234',
'tags' => 'tote, blue, linen, eco-friendly',
'tax_amount' => 0,
'tax_code' => '<string>',
'taxable' => true,
'uom' => 'inches',
'upc' => '0825764603119',
'weight' => 10,
'weight_unit' => 'pounds'
]
],
'cart_shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'digital_delivery' => [
'email' => '<string>',
'phone' => '<string>'
],
'in_store_cart_shipment' => [
'cart_shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'description' => 'Pick up in-store at 123 Main St.',
'distance' => 3,
'distance_unit' => 'mile',
'pickup_window_close' => 123,
'pickup_window_open' => 123,
'store_name' => 'Bolt Collective'
]
]
],
'in_store_cart_shipments' => [
[
'cart_shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'description' => 'Pick up in-store at 123 Main St.',
'distance' => 3,
'distance_unit' => 'mile',
'pickup_window_close' => 123,
'pickup_window_open' => 123,
'store_name' => 'Bolt Collective'
]
],
'items' => [
[
'name' => 'Bolt Swag Bag',
'quantity' => 1,
'reference' => 'item_100',
'total_amount' => 1000,
'unit_price' => 1000,
'brand' => 'Bolt',
'category' => 'bags',
'collections' => [
'summer'
],
'color' => 'Bolt Blue',
'customizations' => [
[
'attributes' => [
'key1' => 'value1',
'key2' => 'value2'
],
'name' => '<string>',
'price' => 754
]
],
'description' => 'Large tote with Bolt logo.',
'details_url' => 'https://boltswagstore.com/products/123456',
'external_inputs' => [
'shopify_line_item_reference' => 123,
'shopify_product_reference' => 123,
'shopify_product_variant_reference' => 123
],
'gift_option' => [
'cost' => 770,
'merchant_product_id' => '881',
'message' => 'Happy Anniversary, Smoochy Poo!',
'wrap' => false
],
'image_url' => 'https://boltswagstore.com/products/123456/images/1.png',
'isbn' => '9780091347314',
'item_group' => '<string>',
'manufacturer' => 'Bolt Textiles USA',
'merchant_product_id' => '881',
'merchant_variant_id' => '888',
'msrp' => 123,
'options' => 'Special Edition',
'properties' => [
[
'color' => '<string>',
'display' => true,
'name' => '<string>',
'name_id' => 123,
'value' => '<string>',
'value_id' => 123
]
],
'shipment' => [
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
],
'size' => 'Large',
'sku' => 'BOLT-SKU_100',
'source' => '<string>',
'seller_id' => 'seller-1234',
'tags' => 'tote, blue, linen, eco-friendly',
'tax_amount' => 0,
'tax_code' => '<string>',
'taxable' => true,
'uom' => 'inches',
'upc' => '0825764603119',
'weight' => 10,
'weight_unit' => 'pounds'
]
],
'loyalty_rewards' => [
[
'amount' => 123,
'coupon_code' => '<string>',
'description' => '$5 off (100 Points)',
'details' => '{"id": 123456, "icon": "fa-dollar", "name": "$15.00 Off", "type": "Coupon", "amount": 100, "duration": "single_use", "cost_text": "150 Points", "description": "Get $15 off your next purchase for 150 points", "discount_type": "fixed_amount", "unrendered_name": "$15.00 Off", "discount_percentage": null, "discount_rate_cents": null, "discount_value_cents": null, "discount_amount_cents": 1500, "unrendered_description": "Get $15 off your next purchase for 150 points", "applies_to_product_type": "ALL"}',
'points' => 123,
'source' => '<string>',
'type' => '<string>'
]
],
'shipments' => [
[
'carrier' => 'FedEx',
'cost' => 770,
'discounted_by_membership' => false,
'estimated_delivery_date' => '08-30-2022',
'expedited' => false,
'package_depth' => 90,
'package_dimension_unit' => 'cm',
'package_height' => 103,
'package_type' => 'A big package.',
'package_weight_unit' => 'kg',
'package_width' => 222,
'service' => 'Option 1',
'shipping_address_id' => 'address1',
'shipping_method' => 'unknown',
'signature' => 'a1B2s3dC4f5g5D6hj6E7k8F9l0',
'tax_amount' => 230,
'tax_code' => 'tax-12345',
'total_weight' => 55,
'total_weight_unit' => 'kg',
'type' => 'door_delivery'
]
],
'tax_amount' => 123,
'cart_url' => 'https://boltswagstore.com/orders/123456765432',
'display_id' => 'displayid_100',
'metadata' => [
'key1' => 'value1',
'key2' => 'value2'
],
'order_description' => 'Order #1234567890'
],
'create_cart_on_merchant_backend' => false,
'metadata' => [
'encrypted_user_id' => 'ID12345678'
],
'user_note' => 'Happy Birthday to my best friend in the whole world. Enjoy!',
'seller_splits' => [
[
'seller_id' => 'seller-1234',
'amounts' => [
'merchant_subtotal' => 5000,
'discount_total' => 500,
'shipping_total' => 1000,
'tax_total' => 400,
'gross_total' => 5900
],
'marketplace_commission_fee' => [
'bps' => 250,
'flat_cents' => 100,
'metadata' => [
'plan_type' => 'pro',
'tier' => 'premium'
]
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bolt.com/v1/merchant/orders"
payload := strings.NewReader("{\n \"cart\": {\n \"total_amount\": 900,\n \"currency\": \"USD\",\n \"order_reference\": \"order_100\",\n \"add_ons\": [\n {\n \"name\": \"<string>\",\n \"price\": 123,\n \"productId\": \"<string>\",\n \"description\": \"<string>\",\n \"imageUrl\": \"<string>\",\n \"productPageUrl\": \"<string>\"\n }\n ],\n \"discounts\": [\n {\n \"amount\": 100,\n \"code\": \"SUMMER10DISCOUNT\",\n \"description\": \"10% off our summer collection\",\n \"details_url\": \"https://boltswagstore.com/SUMMERSALE\",\n \"reference\": \"DISC-1234\",\n \"type\": \"percentage\"\n }\n ],\n \"fees\": [\n {\n \"reference\": \"ItemFee\",\n \"name\": \"Item Fee\",\n \"unit_price\": 123,\n \"unit_tax_amount\": 123,\n \"quantity\": 123,\n \"description\": \"Item Fee\"\n }\n ],\n \"fulfillments\": [\n {\n \"cart_items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"digital_delivery\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"in_store_cart_shipment\": {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n }\n ],\n \"in_store_cart_shipments\": [\n {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n ],\n \"items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"loyalty_rewards\": [\n {\n \"amount\": 123,\n \"coupon_code\": \"<string>\",\n \"description\": \"$5 off (100 Points)\",\n \"details\": \"{\\\"id\\\": 123456, \\\"icon\\\": \\\"fa-dollar\\\", \\\"name\\\": \\\"$15.00 Off\\\", \\\"type\\\": \\\"Coupon\\\", \\\"amount\\\": 100, \\\"duration\\\": \\\"single_use\\\", \\\"cost_text\\\": \\\"150 Points\\\", \\\"description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"discount_type\\\": \\\"fixed_amount\\\", \\\"unrendered_name\\\": \\\"$15.00 Off\\\", \\\"discount_percentage\\\": null, \\\"discount_rate_cents\\\": null, \\\"discount_value_cents\\\": null, \\\"discount_amount_cents\\\": 1500, \\\"unrendered_description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"applies_to_product_type\\\": \\\"ALL\\\"}\",\n \"points\": 123,\n \"source\": \"<string>\",\n \"type\": \"<string>\"\n }\n ],\n \"shipments\": [\n {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n }\n ],\n \"tax_amount\": 123,\n \"cart_url\": \"https://boltswagstore.com/orders/123456765432\",\n \"display_id\": \"displayid_100\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"order_description\": \"Order #1234567890\"\n },\n \"create_cart_on_merchant_backend\": false,\n \"metadata\": {\n \"encrypted_user_id\": \"ID12345678\"\n },\n \"user_note\": \"Happy Birthday to my best friend in the whole world. Enjoy!\",\n \"seller_splits\": [\n {\n \"seller_id\": \"seller-1234\",\n \"amounts\": {\n \"merchant_subtotal\": 5000,\n \"discount_total\": 500,\n \"shipping_total\": 1000,\n \"tax_total\": 400,\n \"gross_total\": 5900\n },\n \"marketplace_commission_fee\": {\n \"bps\": 250,\n \"flat_cents\": 100,\n \"metadata\": {\n \"plan_type\": \"pro\",\n \"tier\": \"premium\"\n }\n }\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bolt.com/v1/merchant/orders")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"cart\": {\n \"total_amount\": 900,\n \"currency\": \"USD\",\n \"order_reference\": \"order_100\",\n \"add_ons\": [\n {\n \"name\": \"<string>\",\n \"price\": 123,\n \"productId\": \"<string>\",\n \"description\": \"<string>\",\n \"imageUrl\": \"<string>\",\n \"productPageUrl\": \"<string>\"\n }\n ],\n \"discounts\": [\n {\n \"amount\": 100,\n \"code\": \"SUMMER10DISCOUNT\",\n \"description\": \"10% off our summer collection\",\n \"details_url\": \"https://boltswagstore.com/SUMMERSALE\",\n \"reference\": \"DISC-1234\",\n \"type\": \"percentage\"\n }\n ],\n \"fees\": [\n {\n \"reference\": \"ItemFee\",\n \"name\": \"Item Fee\",\n \"unit_price\": 123,\n \"unit_tax_amount\": 123,\n \"quantity\": 123,\n \"description\": \"Item Fee\"\n }\n ],\n \"fulfillments\": [\n {\n \"cart_items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"digital_delivery\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"in_store_cart_shipment\": {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n }\n ],\n \"in_store_cart_shipments\": [\n {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n ],\n \"items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"loyalty_rewards\": [\n {\n \"amount\": 123,\n \"coupon_code\": \"<string>\",\n \"description\": \"$5 off (100 Points)\",\n \"details\": \"{\\\"id\\\": 123456, \\\"icon\\\": \\\"fa-dollar\\\", \\\"name\\\": \\\"$15.00 Off\\\", \\\"type\\\": \\\"Coupon\\\", \\\"amount\\\": 100, \\\"duration\\\": \\\"single_use\\\", \\\"cost_text\\\": \\\"150 Points\\\", \\\"description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"discount_type\\\": \\\"fixed_amount\\\", \\\"unrendered_name\\\": \\\"$15.00 Off\\\", \\\"discount_percentage\\\": null, \\\"discount_rate_cents\\\": null, \\\"discount_value_cents\\\": null, \\\"discount_amount_cents\\\": 1500, \\\"unrendered_description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"applies_to_product_type\\\": \\\"ALL\\\"}\",\n \"points\": 123,\n \"source\": \"<string>\",\n \"type\": \"<string>\"\n }\n ],\n \"shipments\": [\n {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n }\n ],\n \"tax_amount\": 123,\n \"cart_url\": \"https://boltswagstore.com/orders/123456765432\",\n \"display_id\": \"displayid_100\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"order_description\": \"Order #1234567890\"\n },\n \"create_cart_on_merchant_backend\": false,\n \"metadata\": {\n \"encrypted_user_id\": \"ID12345678\"\n },\n \"user_note\": \"Happy Birthday to my best friend in the whole world. Enjoy!\",\n \"seller_splits\": [\n {\n \"seller_id\": \"seller-1234\",\n \"amounts\": {\n \"merchant_subtotal\": 5000,\n \"discount_total\": 500,\n \"shipping_total\": 1000,\n \"tax_total\": 400,\n \"gross_total\": 5900\n },\n \"marketplace_commission_fee\": {\n \"bps\": 250,\n \"flat_cents\": 100,\n \"metadata\": {\n \"plan_type\": \"pro\",\n \"tier\": \"premium\"\n }\n }\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bolt.com/v1/merchant/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"cart\": {\n \"total_amount\": 900,\n \"currency\": \"USD\",\n \"order_reference\": \"order_100\",\n \"add_ons\": [\n {\n \"name\": \"<string>\",\n \"price\": 123,\n \"productId\": \"<string>\",\n \"description\": \"<string>\",\n \"imageUrl\": \"<string>\",\n \"productPageUrl\": \"<string>\"\n }\n ],\n \"discounts\": [\n {\n \"amount\": 100,\n \"code\": \"SUMMER10DISCOUNT\",\n \"description\": \"10% off our summer collection\",\n \"details_url\": \"https://boltswagstore.com/SUMMERSALE\",\n \"reference\": \"DISC-1234\",\n \"type\": \"percentage\"\n }\n ],\n \"fees\": [\n {\n \"reference\": \"ItemFee\",\n \"name\": \"Item Fee\",\n \"unit_price\": 123,\n \"unit_tax_amount\": 123,\n \"quantity\": 123,\n \"description\": \"Item Fee\"\n }\n ],\n \"fulfillments\": [\n {\n \"cart_items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"digital_delivery\": {\n \"email\": \"<string>\",\n \"phone\": \"<string>\"\n },\n \"in_store_cart_shipment\": {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n }\n ],\n \"in_store_cart_shipments\": [\n {\n \"cart_shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"description\": \"Pick up in-store at 123 Main St.\",\n \"distance\": 3,\n \"distance_unit\": \"mile\",\n \"pickup_window_close\": 123,\n \"pickup_window_open\": 123,\n \"store_name\": \"Bolt Collective\"\n }\n ],\n \"items\": [\n {\n \"name\": \"Bolt Swag Bag\",\n \"quantity\": 1,\n \"reference\": \"item_100\",\n \"total_amount\": 1000,\n \"unit_price\": 1000,\n \"brand\": \"Bolt\",\n \"category\": \"bags\",\n \"collections\": [\n \"summer\"\n ],\n \"color\": \"Bolt Blue\",\n \"customizations\": [\n {\n \"attributes\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"name\": \"<string>\",\n \"price\": 754\n }\n ],\n \"description\": \"Large tote with Bolt logo.\",\n \"details_url\": \"https://boltswagstore.com/products/123456\",\n \"external_inputs\": {\n \"shopify_line_item_reference\": 123,\n \"shopify_product_reference\": 123,\n \"shopify_product_variant_reference\": 123\n },\n \"gift_option\": {\n \"cost\": 770,\n \"merchant_product_id\": \"881\",\n \"message\": \"Happy Anniversary, Smoochy Poo!\",\n \"wrap\": false\n },\n \"image_url\": \"https://boltswagstore.com/products/123456/images/1.png\",\n \"isbn\": \"9780091347314\",\n \"item_group\": \"<string>\",\n \"manufacturer\": \"Bolt Textiles USA\",\n \"merchant_product_id\": \"881\",\n \"merchant_variant_id\": \"888\",\n \"msrp\": 123,\n \"options\": \"Special Edition\",\n \"properties\": [\n {\n \"color\": \"<string>\",\n \"display\": true,\n \"name\": \"<string>\",\n \"name_id\": 123,\n \"value\": \"<string>\",\n \"value_id\": 123\n }\n ],\n \"shipment\": {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n },\n \"size\": \"Large\",\n \"sku\": \"BOLT-SKU_100\",\n \"source\": \"<string>\",\n \"seller_id\": \"seller-1234\",\n \"tags\": \"tote, blue, linen, eco-friendly\",\n \"tax_amount\": 0,\n \"tax_code\": \"<string>\",\n \"taxable\": true,\n \"uom\": \"inches\",\n \"upc\": \"0825764603119\",\n \"weight\": 10,\n \"weight_unit\": \"pounds\"\n }\n ],\n \"loyalty_rewards\": [\n {\n \"amount\": 123,\n \"coupon_code\": \"<string>\",\n \"description\": \"$5 off (100 Points)\",\n \"details\": \"{\\\"id\\\": 123456, \\\"icon\\\": \\\"fa-dollar\\\", \\\"name\\\": \\\"$15.00 Off\\\", \\\"type\\\": \\\"Coupon\\\", \\\"amount\\\": 100, \\\"duration\\\": \\\"single_use\\\", \\\"cost_text\\\": \\\"150 Points\\\", \\\"description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"discount_type\\\": \\\"fixed_amount\\\", \\\"unrendered_name\\\": \\\"$15.00 Off\\\", \\\"discount_percentage\\\": null, \\\"discount_rate_cents\\\": null, \\\"discount_value_cents\\\": null, \\\"discount_amount_cents\\\": 1500, \\\"unrendered_description\\\": \\\"Get $15 off your next purchase for 150 points\\\", \\\"applies_to_product_type\\\": \\\"ALL\\\"}\",\n \"points\": 123,\n \"source\": \"<string>\",\n \"type\": \"<string>\"\n }\n ],\n \"shipments\": [\n {\n \"carrier\": \"FedEx\",\n \"cost\": 770,\n \"discounted_by_membership\": false,\n \"estimated_delivery_date\": \"08-30-2022\",\n \"expedited\": false,\n \"package_depth\": 90,\n \"package_dimension_unit\": \"cm\",\n \"package_height\": 103,\n \"package_type\": \"A big package.\",\n \"package_weight_unit\": \"kg\",\n \"package_width\": 222,\n \"service\": \"Option 1\",\n \"shipping_address_id\": \"address1\",\n \"shipping_method\": \"unknown\",\n \"signature\": \"a1B2s3dC4f5g5D6hj6E7k8F9l0\",\n \"tax_amount\": 230,\n \"tax_code\": \"tax-12345\",\n \"total_weight\": 55,\n \"total_weight_unit\": \"kg\",\n \"type\": \"door_delivery\"\n }\n ],\n \"tax_amount\": 123,\n \"cart_url\": \"https://boltswagstore.com/orders/123456765432\",\n \"display_id\": \"displayid_100\",\n \"metadata\": {\n \"key1\": \"value1\",\n \"key2\": \"value2\"\n },\n \"order_description\": \"Order #1234567890\"\n },\n \"create_cart_on_merchant_backend\": false,\n \"metadata\": {\n \"encrypted_user_id\": \"ID12345678\"\n },\n \"user_note\": \"Happy Birthday to my best friend in the whole world. Enjoy!\",\n \"seller_splits\": [\n {\n \"seller_id\": \"seller-1234\",\n \"amounts\": {\n \"merchant_subtotal\": 5000,\n \"discount_total\": 500,\n \"shipping_total\": 1000,\n \"tax_total\": 400,\n \"gross_total\": 5900\n },\n \"marketplace_commission_fee\": {\n \"bps\": 250,\n \"flat_cents\": 100,\n \"metadata\": {\n \"plan_type\": \"pro\",\n \"tier\": \"premium\"\n }\n }\n }\n ]\n}"
response = http.request(request)
puts response.read_body{
"cart": {
"billing_address": {
"company": "Bolt",
"country": "United States",
"country_code": "US",
"door_code": "123456",
"email_address": "alan.watts@example.com",
"first_name": "Alan",
"id": "<string>",
"last_name": "Watts",
"locality": "Brooklyn",
"name": "Alan Watts",
"phone_number": "+12125550199",
"postal_code": "10044",
"priority": "primary",
"region": "NY",
"region_code": "NY",
"street_address1": "888 main street",
"street_address2": "apt 3021",
"street_address3": "c/o Alicia Watts",
"street_address4": "Bridge Street Apartment Building B"
},
"cart_url": "https://boltswagstore.com/orders/123456765432",
"currency": {
"currency": "USD",
"currency_symbol": "$"
},
"discount_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"discounts": [
{
"amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"code": "SUMMER10",
"description": "10% off our summer collection",
"details_url": "https://boltswagstore.com/SUMMERSALE",
"free_shipping": {
"is_free_shipping": true,
"maximum_cost_allowed": 123
},
"reference": "DISC-1234"
}
],
"display_id": "displayid_100",
"fee_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"fees": [
{
"reference": "ItemFee",
"name": "Item Fee",
"description": "Item Fee",
"unit_price": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"unit_tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"quantity": 123
}
],
"items": [
{
"bolt_product_id": "<string>",
"brand": "<string>",
"category": "bags",
"collections": [
"summer"
],
"color": "Bolt Blue",
"customizations": [
{
"attributes": {
"key1": "value1",
"key2": "value2"
},
"name": "<string>",
"price": 754
}
],
"description": "<string>",
"details_url": "https://boltswagstore.com/products/123456",
"gift_option": {
"hide_gift_message": false,
"hide_gift_wrap": false
},
"hide": true,
"image_url": "https://boltswagstore.com/products/123456/images/1.png",
"isbn": 9780091347314,
"item_group": "<string>",
"manufacturer": "Bolt Textiles USA",
"merchant_product_id": "<string>",
"merchant_variant_id": "<string>",
"msrp": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"name": "<string>",
"options": "<string>",
"properties": [
{
"color": "<string>",
"display": true,
"name": "<string>",
"value": "<string>"
}
],
"quantity": 1,
"reference": "<string>",
"shipment_id": "<string>",
"shopify_line_item_reference": 123,
"shopify_product_reference": 123,
"shopify_product_variant_reference": 123,
"size": "Large",
"sku": "BOLT-SKU_100",
"subscription": {
"frequency": {
"unit": "month",
"value": 2
}
},
"tags": "tote, blue, linen, eco-friendly",
"tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"taxable": true,
"total_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"unit_price": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"uom": "inches",
"upc": "0825764603119",
"weight": {
"unit": "<string>",
"weight": 123
}
}
],
"merchant_order_url": "<string>",
"order_description": "Order #1234567890",
"order_reference": "order_100",
"shipments": [
{
"carrier": "USPS",
"cost": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"default": true,
"description": [
{
"content": "<string>",
"is_html": true
}
],
"description_tooltips": [
{
"html_content": "<string>",
"target": 123
}
],
"estimated_delivery_date": "2022-04-10 16:12:38.386000+00:00",
"expedited": true,
"gift_options": {
"hide_gift_message": false,
"hide_gift_wrap": false
},
"id": "<string>",
"package_dimension": {
"depth": 123,
"height": 123,
"unit": "<string>",
"width": 123
},
"package_type": "<string>",
"package_weight": {
"unit": "<string>",
"weight": 123
},
"reference": "<string>",
"service": "<string>",
"shipping_address": {
"company": "Bolt",
"country": "United States",
"country_code": "US",
"door_code": "123456",
"email_address": "alan.watts@example.com",
"first_name": "Alan",
"id": "<string>",
"last_name": "Watts",
"locality": "Brooklyn",
"name": "Alan Watts",
"phone_number": "+12125550199",
"postal_code": "10044",
"priority": "primary",
"region": "NY",
"region_code": "NY",
"street_address1": "888 main street",
"street_address2": "apt 3021",
"street_address3": "c/o Alicia Watts",
"street_address4": "Bridge Street Apartment Building B"
},
"shipping_method": "<string>",
"signature": "<string>",
"tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"total_weight": {
"unit": "<string>",
"weight": 123
},
"type": "<string>"
}
],
"shipping_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"subtotal_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"tax_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"total_amount": {
"amount": 754,
"currency": "USD",
"currency_symbol": "$"
},
"transaction_reference": "6CEA-ZME1-DACE"
},
"dynamic_content": {
"custom_fields": [
{
"dynamic": true,
"external_id": "<string>",
"field_setup": "<string>",
"helper_text": "<string>",
"label": "<string>",
"position": 123,
"public_id": "<string>",
"required": true,
"subscribeToNewsletter": true
}
],
"eligible_payment_methods": [
{
"eligible": true
}
],
"gift_option_view": {
"hide_gift_message": true,
"hide_gift_wrap": true
},
"hide_apm": [],
"order_notice": "<string>",
"payment_notice": "<string>",
"shipping_info_notice": "<string>",
"shipping_notice": "<string>"
},
"external_data": {
"steam_id": "<string>"
},
"token": "<string>",
"user_note": "<string>"
}{
"errors": [
{
"code": 2001005,
"message": "The input is missing a required parameter."
}
],
"result": {
"success": false
}
}{
"errors": [
{
"code": 2001005,
"message": "The input is missing a required parameter."
}
],
"result": {
"success": false
}
}{
"errors": [
{
"code": 2001005,
"message": "The input is missing a required parameter."
}
],
"result": {
"success": false
}
}Authorizations
Admins and Developers can obtain their Bolt API key from the Bolt Merchant Dashboard.
Body
application/json
Generate Order Token
The cart_create object is a composite of the base_cart object and additional order details.
Show child attributes
Show child attributes
Used to determine the channel from which the order was created.
Available options:
browser, mobile_app Used to determine whether the order is created on your backend platform. This should almost always be false.
Example:
false
Show child attributes
Show child attributes
Optionally used by shoppers to make extra requests or provide details for gift messages.
Maximum string length:
1024Example:
"Happy Birthday to my best friend in the whole world. Enjoy!"
Array of seller splits for marketplace orders. This enables marketplaces to dynamically configure commission fees and payment splits per seller. Each split contains seller identification, scoped line items and shipments, and declarative amount breakdowns.
Show child attributes
Show child attributes
Response
Token Generation Successful
⌘I