Create a cart

A cart can be created using products that exist in the Nexway catalog by referencing them with their UUID or by using signed products. You will find some examples below.

Request

POST https://api.nexway.store/carts/public

Request body

The request body takes a complete CartInput resource, containing the following writable properties:

{
    "checkoutUrl": "string",
    "country": "string",
    "discounts": [
        "string"
    ],
    "endUser": {
        "city": "string",
        "company": {
            "companyName": "string",
            "validVatNumber": "boolean",
            "vatNumber": "string"
        },
        "country": "string",
        "email": "string",
        "firstName": "string",
        "id": "string",
        "lastName": "string",
        "locale": "string",
        "streetAddress": "string",
        "zipCode": "string"
    },
    "externalContext": "string",
    "locale": "string",
    "products": {
        "<key>": {
            "priceFunctionParameters": {
                "<key>": "string"
            },
            "quantity": "int32"
        }
    },
    "salesFlag": [
        "string"
    ],
    "storeHostname": "string",
    "storeId": "string"
}

Properties

Response

The following HTTP status codes may be returned, optionally with a response resource.

Example with a nexway product

We can add products known and stored by Nexway to the cart by using their product IDs:

{
    "country": "US",
    "endUser": {
        "city": "San Francisco",
        "country": "US",
        "email": "jdoe@com2us.com",
        "firstName": "Doe",
        "lastName": "John",
        "locale": "en-US",
        "streetAddress": "236 8th street",
        "zipCode": "94103"
    },
    "locale": "en-US",
    "ip": "82.238.87.229",
    "products": {
        "82fc0517-358a-49a8-b5fb-8be1a0ced674": {
            "quantity": "2"
        }
    },
    "storeId": "82fc0517-358a-49a8-b5fb-8be1a0ced674"
}

Example with a signed product (catalog-free)

You can directly define product information when creating the cart without the product needing to be known upstream in the Nexway system.
To do so, you need to add a signed product in the cart instead of a product ID.
To learn more about signing data, please read Sign data.

Two different formats are possible:

• Private product
  This payload is exactly the same that we expect when we create a product.
• Public product
  If not found, some fields of this payload are filled by default, for example:
  • lifeTime equal to PERMANENT
  • type equal to SOFTWARE
  • customerId equal to the customer ID associated with the store
  • storeId equal to the store ID associated with the product

Below is an example of a minimal public product before signing:

{
    publisherRefId: "SKU001",
    name: "product name",
    price: {
        grossPrice: 178.5,
        currency: "EUR"
    }
}

Below is an example of a cart with a signed product:

{
    "country": "US",
    "endUser": {
        "city": "San Francisco",
        "country": "US",
        "email": "jdoe@com2us.com",
        "firstName": "Doe",
        "lastName": "John",
        "locale": "en-US",
        "streetAddress": "236 8th street",
        "zipCode": "94103"
    },
    "locale": "en-US",
    "ip": "82.238.87.229",
    "products": {
        "ewogICAgInB1Ymxpc2hlclJlZklkIjogIlNLVTAwMSIsCiAgICAibmFtZSI6ICJwcm9kdWN0IG5hbWUiLAogICAgInByaWNlIjogewogICAgICAgICJncm9zc1ByaWNlIjogMTc4LjUsCiAgICAgICAgImN1cnJlbmN5IjogIkVVUiIKICAgIH0KfS0tLS1NQ3dDRkVVaVA5UHozd3IrYVBzdkZkNzJVdklnelYvU0FoUmFGb2ZDRXRrN3RCNTZZb1ROelNIeENIT2ZQQT09": {
            "quantity": "2"
        }
    },
    "storeId": "82fc0517-358a-49a8-b5fb-8be1a0ced674"
}