CSQ Docs
    CSQ Docs
    CSQ API Doc
    • CSQ API Doc
    • Dummy Product Usage Guide
    • Back to home
    • Location-based Products
    • Get Labels
      GET
    • Get Countries
      GET
    • Get Categories
      GET
    • Get States
      GET
    • Get Municipalities
      GET
    • Get Deliver Locations
      GET
    • Get Products
      GET
    • Create Cart
      POST
    • Purchase
      POST
    • Get Orders
      GET
    • Get Order Status Details
      GET

      Create Cart

      POST
      /physical-products/cart/create/{terminalId}/{operatorId}
      This endpoint creates a new cart containing a single product for a given terminal. It is the first step in the checkout process after product selection in a location-based flow.

      🔍 Description#

      Use this method to:
      Initialize a cart with one product
      Submit all required purchase and delivery details
      Receive cart metadata including pricing and expiration
      📌 Currently, this method supports only one product per cart. Multi-product carts are not yet supported.

      📥 Request Details#

      Method: POST
      Authentication: Required
      Path Parameters:
      terminalId (integer): ID of the requesting terminal
      productId (integer): ID of the selected product
      Body Parameters:
      FieldTypeDescription
      productIdintegerID of the product being added to the cart
      countryIdintegerID of the selected country
      stateIdintegerID of the selected state or province
      locationIdintegerID of the delivery location
      municipalityIdintegerID of the selected municipality
      buyerNamestringName of the buyer
      buyerSurnamestringSurname of the buyer
      buyerPhonestringPhone number of the buyer
      buyerEmailstringEmail address of the buyer
      buyerDocumentNumberstringDocument number of the buyer
      beneficiaryNamestringName of the beneficiary
      beneficiarySurnamestringSurname of the beneficiary
      beneficiaryPhonestringPhone number of the beneficiary
      beneficiaryEmailstringEmail address of the beneficiary
      beneficiaryDocumentNumberstringDocument number of the beneficiary
      beneficiaryDocumentTypestringType of document (e.g., PASSPORT, ID_CARD)
      citystringCity of delivery
      addressstringFull delivery address

      Example Request#

      {
  "productId": 501,
  "countryId": 34,
  "stateId": 201,
  "locationId": 401,
  "municipalityId": 301,
  "buyerName": "Carlota",
  "buyerSurname": "Gómez",
  "buyerPhone": "+34000000000",
  "buyerEmail": "cg@example.com",
  "buyerDocumentNumber": "X1234567",
  "beneficiaryName": "Luis",
  "beneficiarySurname": "Gómez",
  "beneficiaryPhone": "+34000000001",
  "beneficiaryEmail": "luis@example.com",
  "beneficiaryDocumentNumber": "Y7654321",
  "city": "Madrid",
  "address": "Calle Mayor 1, 1ºB",
  "beneficiaryDocumentType": "PASSPORT"
}

      📤 Response#

      Returns cart creation confirmation and pricing details:
      FieldTypeDescription
      resultMessagestringHuman-readable message describing the result of the operation
      resultCodeintegerInternal result code (e.g., 0 for success)
      cartIdintegerUnique identifier of the newly created cart
      productPriceX100integerBase price of the product, expressed in cents
      amountToSendX100integerAmount intended to be sent, expressed in cents
      deliveryPriceX100integerCost of delivery, expressed in cents

      Example Response#

      {
  "resultMessage": "Cart created successfully",
  "resultCode": 0,
  "cartId": 874231,
  "productPriceX100": 1300,
  "amountToSendX100": 1500,
  "deliveryPriceX100": 200
}

      🧠 Usage Notes#

      This method must be called before initiating payment.
      The cart expires after a short time window (validUntil), so payment should follow promptly.
      The cartId returned is required for the next step: executing payment.

      Request

      Path Params

      Header Params

      Body Params application/json

      Example
      {
    "productId": 0,
    "countryId": 0,
    "stateId": 0,
    "locationId": 0,
    "municipalityId": 0,
    "buyerName": "string",
    "buyerSurname": "string",
    "buyerPhone": "string",
    "buyerEmail": "string",
    "buyerDocumentNumber": "string",
    "beneficiaryName": "string",
    "beneficiarySurname": "string",
    "beneficiaryPhone": "string",
    "beneficiaryEmail": "string",
    "beneficiaryDocumentNumber": "string",
    "city": "string",
    "address": "string",
    "beneficiaryDocumentType": "PASSPORT"
}

      Request samples

      Shell
      JavaScript
      Java
      Swift
      Go
      PHP
      Python
      HTTP
      C
      C#
      Objective-C
      Ruby
      OCaml
      Dart
      R
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location --request POST 'https://evsb.csqworld.com/physical-products/cart/create//' \
--header 'U;' \
--header 'SH;' \
--header 'ST;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "productId": 0,
    "countryId": 0,
    "stateId": 0,
    "locationId": 0,
    "municipalityId": 0,
    "buyerName": "string",
    "buyerSurname": "string",
    "buyerPhone": "string",
    "buyerEmail": "string",
    "buyerDocumentNumber": "string",
    "beneficiaryName": "string",
    "beneficiarySurname": "string",
    "beneficiaryPhone": "string",
    "beneficiaryEmail": "string",
    "beneficiaryDocumentNumber": "string",
    "city": "string",
    "address": "string",
    "beneficiaryDocumentType": "PASSPORT"
}'

      Responses

      🟢200OK
      application/json
      OK
      Body

      Example
      {
    "resultMessage": "string",
    "resultCode": 0,
    "cartId": 0,
    "productPriceX100": 0,
    "amountToSendX100": 0,
    "deliveryPriceX100": 0
}
      Modified at 2025-07-07 11:26:18
      Previous
      Get Products
      Next
      Purchase
      Built with