B2C Shopping Cart
Shopping carts help you collect and manage items users select as they navigate through the purchase flows. The cart can either be built and updated as a stand-alone object or it can be built directly in the checkout call when the order is submitted.
Note: Creating a stand-alone shopping cart isn’t required for checkout but the shopping cart object is used in most of the checkout flows. For that reason, we strongly recommend using the shopping cart features.
Method | Endpoint | Actions | Request Payload | Response Payload |
POST | /v2/b2c/carts | Create a new shopping cart | Shopping Cart Object* | Shopping Cart ID |
GET | /v2/b2c/carts/{id} | Get an existing shopping cart | None | Shopping Cart Object |
PUT | /v2/b2c/carts/{id} | Update an existing shopping cart | Shopping Cart Object | Shopping Cart Object |
DELETE | /v2/b2c/carts/{id} | Delete an existing shopping cart | None | Shopping Cart Object |
*If you’d like to create an empty shopping cart, pass an empty object {} into the create a new shopping cart call
Sample Requests
Create a new shopping cart or update an existing shopping cart. This example includes all possible items that can be included in a cart. Add or remove items depending on what the user selects.
{
"items": [{
"itemType": "Event",
"eventName": "History of Magic",
"eventId": "5d96453460309f26d082bc80",
"ticketingTypeName": "Adult",
"ticketingTypeId": "55268c54e4b0fb9be01106bd",
"quantity": 2,
"unitPrice": "20.00",
"amount": "40.00"
},
{
"itemType": "Inventory",
"eventName": "History of Magic",
"eventId": "5d96453460309f26d082bc80",
"inventoryName": "Horocrux",
"inventoryId": 594,
"quantity": 1,
"unitPrice": "100.00",
"amount": "100.00"
},
{
"itemType": "Inventory",
"inventoryName": "Floo Powder",
"inventoryId": 818,
"quantity": 1,
"unitPrice": "10.00",
"amount": "10.00"
},
{
"itemType": "Inventory",
"addonType": "fixedDonation",
"inventoryName": "$10 Donation",
"inventoryId": 889,
"quantity": 1,
"unitPrice": "100.00",
"amount": "100.00",
"donationDetail": {
"donationAppealName": "Appeal One",
"donationCampaignName": "Spring Direct Mail Appeal",
"donationFundName": "General Fund",
"donorRecognition": "self",
"donorRecognitionType": "self",
"dedicationLastName": "Longbottom",
"dedicationFirstName": "Mr. and Mrs.",
"beneficiaryType": "In memory of",
"beneficiaryLastName": "Longbottom",
"beneficiaryFirstName": "Neville",
"beneficiaryEmail": "nlongbottom@hsww.magic.edu",
"beneficiaryPhoneNumber": "555-555-5555",
"beneficiaryStreetAddress1": "123 Main Street",
"beneficiaryStreetAddress2": "Apt 2B",
"beneficiaryCity": "Anytown",
"beneficiaryState": "GA",
"beneficiaryZipCode": "30303",
"beneficiaryCountry": "United States"
}
},
{
"itemType": "Inventory",
"addonType": "donation",
"inventoryName": "Variable Donation",
"inventoryId": 888,
"quantity": 1,
"unitPrice": "10000.00",
"amount": "10000.00",
"donationDetail": {
"donationAppealName": "Appeal One",
"donationCampaignName": "Spring Direct Mail Appeal",
"donationFundName": "General Fund",
"donorRecognition": "anonymous",
"donorRecognitionType": "anonymous"
}
},
{
"itemType": "MembershipPurchase",
"quantity": 1,
"unitPrice": "100.00",
"amount": "100.00",
"membershipInfo": {
"membershipCategoryId": "5a049c3b60309f5d917c6e63",
"membershipCategoryName": "Founders",
"membershipOfferingId": "519d569cd32748ae9e3c507fe0456e5e",
"membershipOfferingName": "Offering One",
"pricePointId": "59aeb29a60309f07f6c6bef6",
"pricePointName": "Membership",
"membershipCards": [{
"cardType": "primary",
"name": "B Bagshot",
"email": "bbagshot@email.com",
"firstName": "B",
"lastName": "Bagshot",
"phoneNumber": "555-555-5555",
"streetAddress1": "123 Main St",
"streetAddress2": "Apt 2",
"city": "Springfield",
"state": "Oregon",
"zipCode": "97477",
"country": "United States"
},
{
"cardType": "secondary",
"email": "hsimpson@springfieldnuclear.org",
"firstName": "H",
"lastName": "Simpson",
"phoneNumber": "939-555-0113"
}
],
"isGift": false
}
}
],
"forms": [],
"comboItems": [],
"verifyEntitlements": false,
"reservationId": "10788"
}Sample Responses
Empty shopping cart object
{
"id": "5e14cd4f60309f41499e653b",
"tempVisitorId": "706ae7924a824d2483ac8827db78511e",
"items": [],
"forms": [],
"comboItems": [],
"verifyEntitlements": false
}
Full shopping cart object
{
"id": "5e173d6060309f41499e6602",
"tempVisitorId": "43b66f951401416781903934f8c68e9a",
"membershipCategoryId": "5a049c3b60309f5d917c6e63",
"membershipId": "000000000", //***
"couponCode": "COUPONCODE", //***
// ***coupon code and membership id cannot be used at the same time
"items": [
{
// typical ticket example
"itemId": "fb433e2a72594339bfe1be054440cd41",
"eventId": "5d96453460309f26d082bc80",
"ticketingTypeId": "55268c54e4b0fb9be01106bd",
"eventName": "History of Magic",
"ticketingTypeName": "Adult",
"quantity": 2,
"unitPrice": "20.00",
"retailUnitPrice": "20.00",
"amount": "40.00",
"itemType": "Event",
"admissionType": "standard",
"isRetail": false,
"ignoreEntitlements": false
},
{
// full price ticket when using entitlements example
"itemId": "fb433e2a72594339bfe1be054440cd41",
"eventId": "5d96453460309f26d082bc80",
"ticketingTypeId": "55268c54e4b0fb9be01106bd",
"eventName": "History of Magic",
"ticketingTypeName": "Adult",
"quantity": 2,
"unitPrice": "20.00",
"retailUnitPrice": "20.00",
"amount": "40.00",
"itemType": "Event",
"admissionType": "standard",
"isRetail": true,
"ignoreEntitlements": false
},
{
// addon tied to event example
"itemId": "0b2dc945b9e34bd2ab3c1ff8fb407d7b",
"eventId": "5d96453460309f26d082bc80",
"eventName": "History of Magic",
"quantity": 1,
"unitPrice": "100.00",
"retailUnitPrice": "0.00",
"amount": "100.00",
"itemType": "Inventory",
"inventoryId": 594,
"inventoryName": "Horocrux",
"admissionType": "standard",
"isRetail": false,
"ignoreEntitlements": false
},
{
// addon not tied to an event example
"itemId": "b898f7f493834dab8d21946838a89b4f",
"quantity": 1,
"unitPrice": "10.00",
"retailUnitPrice": "0.00",
"amount": "10.00",
"itemType": "Inventory",
"inventoryId": 818,
"inventoryName": "Floo Powder",
"admissionType": "standard",
"isRetail": false,
"ignoreEntitlements": false
},
{
// fixed donation example
"itemId": "75df1d03e1534e37bbcefd6b956aaa2e",
"quantity": 1,
"unitPrice": "100.00",
"retailUnitPrice": "0.00",
"amount": "100.00",
"itemType": "Inventory",
"inventoryId": 889,
"inventoryName": "$10 Donation",
"admissionType": "standard",
"addonType": "fixedDonation",
"donationDetail": {
"donorRecognition": "self",
"donorRecognitionType": "self",
"dedicationLastName": "Longbottom",
"dedicationFirstName": "Mr. and Mrs.",
"donationCampaignName": "Spring Direct Mail Appeal",
"donationFundName": "General Fund",
"beneficiaryType": "In memory of",
"beneficiaryLastName": "Longbottom",
"beneficiaryFirstName": "Neville",
"beneficiaryEmail": "nlongbottom@hsww.magic.edu",
"beneficiaryPhoneNumber": "555-555-5555",
"beneficiaryStreetAddress1": "123 Main Street",
"beneficiaryStreetAddress2": "Apt 2B",
"beneficiaryCity": "Anytown",
"beneficiaryState": "GA",
"beneficiaryZipCode": "30303",
"beneficiaryCountry": "United States",
"customFieldValues": [],
"donationAppealName": "Appeal One"
},
"isRetail": false,
"ignoreEntitlements": false
},
{
// variable donation example
"itemId": "d52ab9a933e64b0bb82771cfeb1a871d",
"quantity": 1,
"unitPrice": "10000.00",
"retailUnitPrice": "0.00",
"amount": "10000.00",
"itemType": "Inventory",
"inventoryId": 888,
"inventoryName": "Variable Donation",
"admissionType": "standard",
"addonType": "donation",
"donationDetail": {
"donorRecognition": "anonymous",
"donorRecognitionType": "anonymous",
"donationCampaignName": "Spring Direct Mail Appeal",
"donationFundName": "General Fund",
"customFieldValues": [],
"donationAppealName": "Appeal One"
},
"isRetail": false,
"ignoreEntitlements": false
},
{
// membership purchase example
"itemId": "b278c0577a8a42d497dbaeca8bc7112a",
"quantity": 1,
"unitPrice": "100.00",
"retailUnitPrice": "100.00",
"amount": "100.00",
"itemType": "MembershipPurchase",
"membershipInfo": {
"membershipCategoryId": "5a049c3b60309f5d917c6e63",
"membershipCategoryName": "Founders",
"membershipOfferingId": "519d569cd32748ae9e3c507fe0456e5e",
"membershipOfferingName": "Offering One",
"pricePointId": "59aeb29a60309f07f6c6bef6",
"pricePointName": "Membership",
"membershipCards": [
{
"cardType": "primary",
"name": "B Bagshot",
"email": "bbagshot@email.com",
"firstName": "B",
"lastName": "Bagshot",
"phoneNumber": "555-555-5555",
"streetAddress1": "123 Main St",
"streetAddress2": "Apt 2",
"city": "Springfield",
"state": "Oregon",
"zipCode": "97477",
"country": "United States",
"deceased": "no",
"primaryCard": "no",
"startDate": "1969-12-31T19:00:01-05:00",
"expirationDate": "2038-01-18T22:14:07-05:00",
"excludeCardOnMemberCreation": false,
"ignoreUpdates": false
},
{
"cardType": "secondary",
"name": "H Simpson",
"email": "hsimpson@springfieldnuclear.org",
"firstName": "H",
"lastName": "Simpson",
"phoneNumber": "939-555-0113",
"deceased": "no",
"primaryCard": "no",
"startDate": "1969-12-31T19:00:01-05:00",
"expirationDate": "2038-01-18T22:14:07-05:00",
"excludeCardOnMemberCreation": false,
"ignoreUpdates": false
}
],
"waiveBenefits": false,
"isGift": false,
"notifyGiftRecipient": false,
"donationAmount": "0.00",
"markDonationAsAnonymous": false,
"cancellationRefundAmount": "0.00",
"auxiliary": false
},
"admissionType": "standard",
"isRetail": false,
"ignoreEntitlements": false
}
],
"forms": [],
"comboItems": [],
"verifyEntitlements": false
}