Skip to main content

Consumer Cart

Manage consumer shopping carts for e-commerce workflows including cart creation, item management, order submission, and payments.

Base URL: /api/v1/partner/store/cart

Endpoints Overview​

MethodEndpointDescription
GET/historyGet Consumer Order History
GET/{consumerCartId}Get Cart by id.
GET/activeGet Active Cart
POST/preparePrepare Active Cart
POST/updateCart/{consumerCartId}Update Cart to the platform.
DELETE/cancelCart/{consumerCartId}Cancel submitted order to the platform.
POST/submitCart/{consumerCartId}Submit Cart to be completed.
POST/product/findCostFind Product cost
GET/public/{publicKey}Find Cart by public key
POST/item/{orderItemId}/finalizeFinalize Item Cart
POST/item/{orderItemId}/unfinalizeUnfinalize Item Cart
POST/items/finalizeFinalize All Items in Cart
POST/{consumerCartId}/setConsumerUser/{consumerUserId}Update Consumer User
POST/{consumerCartId}/paymentsAdd Transaction Payments

Get Consumer Order History​

GET /api/v1/partner/store/cart/history

Retrieve the order history for the currently authenticated consumer. Returns a paginated list of past carts/orders. Requires consumer user authentication.

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid
startintegerNoNumber of records to skip
limitintegerNoMaximum records to return

Response​

Returns a paginated SearchResult of ConsumerCart objects.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Get Cart by id.​

GET /api/v1/partner/store/cart/{consumerCartId}

Retrieve a specific cart by its ID. Requires consumer user authentication.

Path Parameters​

ParameterTypeDescription
consumerCartIdstringThe consumer cart i d

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Get Active Cart​

GET /api/v1/partner/store/cart/active

Retrieve the currently active (in-progress) cart. You can look up the cart by sessionId, externalId, or transactionId. Does not require consumer user authentication — works for anonymous/guest sessions.

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid
sessionIdstringNosession i d
externalIdstringNoexternal i d
transactionIdstringNotransaction i d

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Prepare Active Cart​

POST /api/v1/partner/store/cart/prepare

Create and initialize a new cart with items. The system computes pricing, taxes, and discounts based on the provided cart data. This is typically the first step in the e-commerce checkout flow. Works for guest sessions.

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Request Body​

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Update Cart to the platform.​

POST /api/v1/partner/store/cart/updateCart/{consumerCartId}

Update an existing cart with new items, quantities, or other modifications. Send the updated cart object in the request body.

Path Parameters​

ParameterTypeDescription
consumerCartIdstringThe consumer cart i d

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Request Body​

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Cancel submitted order to the platform.​

DELETE /api/v1/partner/store/cart/cancelCart/{consumerCartId}

Cancel a previously submitted order. This is a destructive action that requires consumer user authentication. Only submitted orders can be cancelled.

Path Parameters​

ParameterTypeDescription
consumerCartIdstringThe consumer cart i d

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Submit Cart to be completed.​

POST /api/v1/partner/store/cart/submitCart/{consumerCartId}

Submit a cart as a completed order. This is the final step in the checkout flow — the cart transitions from in-progress to submitted status. Send the finalized cart object in the request body. All orders submitted through this endpoint are tagged with the Widget transaction source.

Path Parameters​

ParameterTypeDescription
consumerCartIdstringThe consumer cart i d

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Request Body​

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Find Product cost​

POST /api/v1/partner/store/cart/product/findCost

Calculate the cost of a product without adding it to a cart. Use this to display prices and estimated costs before the consumer commits to a purchase.

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Request Body​

FieldTypeRequiredDescription
productIdstringYesProduct identifier
quantitynumberNoQuantity

Response​

Returns a ProductCostResult object.

FieldTypeRequiredDescription
productIdstringYesProduct identifier
quantitynumberNoQuantity
costnumberNoCost

Find Cart by public key​

GET /api/v1/partner/store/cart/public/{publicKey}

Retrieve a cart using its public-facing key. Use this for shared cart links or public order tracking where internal cart IDs should not be exposed.

Path Parameters​

ParameterTypeDescription
publicKeystringThe public key

Response​

Returns a ConsumerCartResult object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier
membershipAcceptedbooleanNoMembership Accepted (default: false)
consumerUserConsumerUserNoConsumer User
memberMemberNoMember
transactionTransactionNoTransaction
shopShopNoShop
dispatchShopShopNoDispatch Shop
consumerAddressstringNoConsumer Address (default: ``)

Finalize Item Cart​

POST /api/v1/partner/store/cart/item/{orderItemId}/finalize

Mark a specific line item in the cart as finalized (confirmed and ready). Part of an item-by-item checkout workflow.

Path Parameters​

ParameterTypeDescription
orderItemIdstringThe order item i d

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Request Body​

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Unfinalize Item Cart​

POST /api/v1/partner/store/cart/item/{orderItemId}/unfinalize

Reverse the finalization of a specific line item, allowing further modifications to that item.

Path Parameters​

ParameterTypeDescription
orderItemIdstringThe order item i d

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Request Body​

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Finalize All Items in Cart​

POST /api/v1/partner/store/cart/items/finalize

Finalize all items in the cart at once. This is a batch operation equivalent to calling the single-item finalize endpoint for every item.

Query Parameters​

ParameterTypeRequiredDescription
cuidstringNocuid

Request Body​

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Update Consumer User​

POST /api/v1/partner/store/cart/{consumerCartId}/setConsumerUser/{consumerUserId}

Associate a consumer user with a cart. Use this when a cart was started as a guest/anonymous session and the consumer later logs in or identifies themselves.

Path Parameters​

ParameterTypeDescription
consumerCartIdstringThe consumer cart i d
consumerUserIdstringThe consumer user i d

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier

Add Transaction Payments​

POST /api/v1/partner/store/cart/{consumerCartId}/payments

Add payment information to a cart. The request body includes the paymentOption (payment method), paymentReceived (amount), and optional orderTags.

Path Parameters​

ParameterTypeDescription
consumerCartIdstringThe consumer cart i d

Request Body​

FieldTypeRequiredDescription
orderTagsstring[]NoOrder Tags
paymentReceivednumberNoPayment Received

Response​

Returns a ConsumerCart object.

FieldTypeRequiredDescription
idstringNoUnique identifier
companyIdstringNoCompany identifier
shopIdstringNoShop identifier
createdlongNoCreated timestamp (epoch ms)
modifiedlongNoLast modified timestamp (epoch ms)
deletedbooleanNoWhether the record is deleted
updatedbooleanNoWhether the record has been updated
consumerIdstringNoConsumer identifier
memberIdstringNoMember identifier
assignedNearbyDriverIdstringNoAssigned Nearby Driver identifier
cartCartNoCart
orderPlacedTimelongNoOrder Placed timestamp (epoch ms)
acceptedTimelongNoAccepted timestamp (epoch ms)
packagedTimelongNoPackaged timestamp (epoch ms)
onTheWayTimelongNoOn The Way timestamp (epoch ms)
completedTimelongNoCompleted timestamp (epoch ms)
canceledTimelongNoCanceled timestamp (epoch ms)
declinedTimelongNoDeclined timestamp (epoch ms)
placedbooleanNoPlaced (default: false)
acceptedbooleanNoAccepted (default: false)
completedbooleanNoCompleted (default: false)
packagedbooleanNoPackaged (default: false)
onTheWaybooleanNoOn The Way (default: false)
anonymousbooleanNoAnonymous (default: false)
etaintegerNoEta
reasonstringNoReason
sessionIdstringNoSession identifier
publicKeystringNoPublic Key
committedbooleanNoCommitted
cartStatusstringNoCart Status. One of: InProgress, Placed, Accepted, Completed, Declined, CanceledByConsumer, CanceledByDispensary (default: InProgress)
trackingStatusstringNoTracking Status. One of: NotStarted, Placed, Accepted, Packaged, OnTheWay, Delivered, WaitingPickup, Declined (default: NotStarted)
pickupTypestringNoPickup Type. One of: Pickup, Delivery, Ship (default: Delivery)
sourcestringNoSource
salesChannelstringNoSales Channel
partnerIdstringNoPartner identifier
externalIdstringNoExternal system identifier
transactionIdstringNoTransaction identifier
reqLinkedTransIdstringNoReq Linked Trans identifier
transNostringNoTrans No
orderNostringNoOrder No
employeeNamestringNoEmployee Name
memostringNoMemo/notes
additionalNotesstringNoAdditional Notes
pickUpDatelongNoPick Up timestamp (epoch ms)
transactionSourcestringNoTransaction Source. One of: Retail, Widget, WooCommerce, Weedmaps (default: Widget)
assignedEmployeeIdstringNoAssigned Employee identifier
deliveryDatelongNoDelivery timestamp (epoch ms)
deliveryAddressAddressNoDelivery Address
completeAfterlongNoComplete After
orderTagsstring[]NoOrder Tags
rewardNamestringNoReward Name
prepaidbooleanNoPrepaid (default: false)
disableAutoAssignmentbooleanNoDisable Auto Assignment (default: false)
disableAutoRegionDispatchbooleanNoDisable Auto Region Dispatch (default: false)
overrideRegionIdstringNoOverride Region identifier
dispatchRegionIdstringNoDispatch Region identifier (default: ``)
overrideInventoryIdstringNoOverride Inventory identifier
activeInventoryIdsstring[]NoActive Inventory Ids
expiredAtlongNoExpired At
integrationsconsumercartintegrationsNoIntegrations
externalPaymentIdsstring[]NoExternal Payment Ids
externalPaymentConfigIdstringNoExternal Payment Config identifier
strongholdstrongholdintegrationNoStronghold
chargeIdstringNoCharge identifier