Create a new cart, optionally adding items and discount

post

https://virtserver.swaggerhub.com/purchases/v1/customer/{customerId}/cart/currency/{currencyCode}

Create a new cart which can be used to make purchases. Items may be added at this point as well as a discount

Response Code	Fault Code	Fault	Suggested User Message
400	90035	ItemAlreadyPurchasedFault	Item Already Purchased
400	90036	ItemNotWithinBuyWindowFault	Item unavailable for purchase
403	90076	ValidateWithProviderFailedFault	Provider {name} cannot validate the device
404	90022	InvalidDiscountCodeFault	Discount does not exist
400	90023	InvalidItemCombinationFault	Item {itemCode} cannot be added to this cart
404	90069	UnknownItemCodeFault	Incorrect Item Code provided
400	90079	VCNRequiredFault	A Viewing Card is required for this purchase
400	90062	UnableToAddItemsFault	Item {itemCode} cannot be added to this cart
400	90009	InactiveVCNFault	Viewing Card provided is inactive
400	90052	PpvPinIncorrectFault	Incorrect PIN provided
400	90031	InvalidVCNFault	Viewing Card provided is Invalid
500	90061	SystemFailureFault	System Failure, please try again later
400	90053	PpvPinRequiredFault	PIN required

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

customerId

uuid

required

The ID of the customer the cart is to be created for

currencyCode

string

required

length between 3 and 3

3-letter code for currency in which purchases will be made

Body Params

The items to be added to the cart (including optional discount details)

List of cart items to be added with an optional discount details

items

array of objects

items

discountCode

object

Details of a code to be applied to the cart which may trigger a discount

Headers

tenantId

string

The tenant ID for which the operation is being carried out. This will be automatically generated during the authentication process.

userId

string

The ID of a user who is performing the operation. This will be automatically generated during the authentication process.

source

string

enum

The source of whether records are updated by HMAC or a USER. This will be automatically generated during the authentication process. For customers accessing the service the source will be set to CUSTOMER.

Allowed:

Responses

Language

Loading…

Response

Choose an example:

application/json

201Create cart request successful.

400Bad request

404Customer not found

422Unable to create cart.