APappdirect
ShoppingCart

Validate non-persisted shopping carts

Changed on

Validates and retrieves the validation summary of the specified shopping cart payload

post/v3/checkout/shoppingCarts/validation

Request

Query parameters

level'PRE_FINALIZE' | 'PREVENT_FINALIZE' | 'PREVENT_PROVISIONING' required

Level of validation. Run PRE_FINALIZE validations before the shopping cart is finalized. Run PREVENT_FINALIZE and PREVENT_PROVISIONING at the time of finalization and provisioning respectively to prevent those operations if validation fails.

Headers

AD-ShoppingCart-Partnerstring required

The partner code of a marketplace

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

OK

object required

Changes