APappdirect
ShoppingCart

Create and finalize shopping carts

Changed on

Creates and finalizes a shopping cart in a single request

post/v3/checkout/shoppingCarts/finalize

Request

Headers

AD-ShoppingCart-Partnerstring required

The partner code of a marketplace

AD-Timezonestring

Request body

idstring

Shopping cart ID

createdOnstring

Shopping cart creation date

ownerUserIdstring

Cart owner user ID

ownerCompanyIdstring

Cart owner company ID

buyerType'CUSTOMER' | 'PLATFORM_OWNER' | 'PARTNER'

Describes the buyer's relationship with the platform, either CUSTOMER (end user), PLATFORM_OWNER (sales representative) or PARTNER (reseller)

currency'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN'

Supported currencies for the system

statusstring

Shopping cart status

isBlockedboolean

Shopping Cart is locked waiting for an external event

paymentMethodIdstring

Payment method ID

preAuthIdstring

Cart payment pre-authorization ID

localestring

Locale of shopping cart (ISO 639 language, ISO 3166 country, variant).

buyerUserIdstring

User ID of the buyer (customer, reseller, sales representative) who initiates the purchase

buyerCompanyIdstring

Buyer company ID

Example request

{
  "id": "4f59d160-0e63-45c4-bb91-7ebe873da29f",
  "createdOn": "2020-10-12 07:20:50.52Z",
  "ownerUserId": "83407ce8-373f-11e6-ac61-9e71128cae77",
  "ownerCompanyId": "a411dc54-d46f-4002-ab00-3ea52e4eb118",
  "status": "ACTIVE",
  "paymentMethodId": "a411dc54-d46f-4002-ab00-3ea52e4eb118",
  "preAuthId": "a411dc54-d46f-4002-ab00-3ea52e4eb118",
  "locale": "en_US",
  "buyerUserId": "83407ce8-373f-11e6-ac61-9e71128cae77",
  "buyerCompanyId": "a411dc54-d46f-4002-ab00-3ea52e4eb118",
  "items": [
    {
      "id": "45ae34b7-ffc1-4d74-be78-dce34008cd2e",
      "referenceId": "45",
      "subscriptionId": "83407ce8-373f-11e6-ac61-9e71128cae77",
      "pricingPlanId": "3dcc468d-fd4c-41ce-b700-f88c0c74561f",
      "serviceConfiguration": {
        "date": "2010-10-19T00:00:00.000Z"
      },
      "billingConfiguration": {
        "date": "1546300800000",
        "strategy": "CUSTOM"
      },
      "discountCode": "DISCOUNT",
      "discountId": "30",
      "customPrices": [
        {
          "costId": "9742e09a-e1b4-4b9e-b1a7-66df3e41cebe",
          "price": 20
        }
      ],
      "units": [
        {
          "quantity": "8",
          "unit": "USER"
        }
      ],
      "customAttributes": {
        "vendorRequiredFields": {
          "customAttributes": {
            "preferredColours": [
              "key_red",
              "key_white"
            ],
            "preferredTime": "12:00"
          }
        },
        "subscription": {
          "customAttributes": {
            "preferredColours": [
              "key_red",
              "key_white"
            ],
            "preferredTime": "12:00"
          }
        }
      },
      "customContractConfiguration": {
        "minimumServiceLengthUnit": "MONTHLY",
        "endOfContractGracePeriodUnit": "INFINITY",
        "contractCancellationPeriodUnit": "NONE",
        "terminationFeeGracePeriodUnit": "INFINITY"
      }
    }
  ],
  "customAttributes": {
    "purchase": {
      "customAttributes": {
        "preferredColours": [
          "key_red",
          "key_white"
        ],
        "preferredTime": "12:00"
      }
    },
    "buyerUser": {
      "customAttributes": {
        "preferredColours": [
          "key_red",
          "key_white"
        ],
        "preferredTime": "12:00"
      }
    },
    "buyerCompany": {
      "customAttributes": {
        "preferredColours": [
          "key_red",
          "key_white"
        ],
        "preferredTime": "12:00"
      }
    },
    "ownerUser": {
      "customAttributes": {
        "preferredColours": [
          "key_red",
          "key_white"
        ],
        "preferredTime": "12:00"
      }
    },
    "ownerCompany": {
      "customAttributes": {
        "preferredColours": [
          "key_red",
          "key_white"
        ],
        "preferredTime": "12:00"
      }
    }
  },
  "fees": [
    {
      "id": "ce402858-4fe8-4254-8b69-73c41142f4ba",
      "externalId": "a8bf31a8-fe75-4ab9-9559-dcd41eca9d12",
      "createdOn": "2020-10-12 07:20:50.52Z",
      "key": "SHIPPING_FEE_100",
      "currency": "USD",
      "description": {
        "defaultDescription": "Some description here. Valid from {$fromDate} until {$toDate}"
      }
    }
  ],
  "accreditedAgents": [
    {
      "userId": "83407ce8-373f-11e6-ac61-9e71128cae77",
      "companyId": "a411dc54-d46f-4002-ab00-3ea52e4eb118"
    }
  ]
}

Response

ACCEPTED

ShoppingCartRequestAcceptedResponse required(unresolved $ref)

Changes