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.


Endpoints

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 an empty shopping cart

1

{}

 

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

 

Create a new shopping cart


5e14b17860309f41499e652e

 

Empty shopping cart object

{

    "id": "5e14cd4f60309f41499e653b",

    "tempVisitorId": "706ae7924a824d2483ac8827db78511e",

    "items": [],

    "forms": [],

    "comboItems": [],

    "verifyEntitlements": false

}

 

Full shopping cart object


{

    "id": "5e173d6060309f41499e6602",

    "tempVisitorId": "43b66f951401416781903934f8c68e9a",

    "membershipCategoryId": "5a049c3b60309f5d917c6e63",

    "items": [

        {

            "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

        },

        {

            "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

        },

        {

            "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

        },

        {

            "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

        },

        {

            "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

        },

        {

            "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

}