All pages
Powered by GitBook
1 of 1

Loading...

Overview

The LiquidCommerce Cloud SDK provides an easy way to interact with our APIs through a server-side SDK for Node.js and Web JS script.

GitHub Repository: For the latest source code, issues, and contribution guidelines, visit our GitHub repository. Star the repo to stay updated with the latest changes.

Table of Contents

  • Installation

Installation

Authentication

The LiquidCommerce Cloud SDK uses API keys to authenticate requests. You can request your keys from your Partnerships liaison.

Your API keys carry many privileges, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

All API requests in production must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.

Cloud SDK Demo

We've included a comprehensive demo application to help you quickly understand how to implement the LiquidCommerce Cloud SDK in real-world scenarios.

Running the Demo

  1. Clone the repository:

  1. Navigate to the demo directory

  1. Add your API keys to the demo:

    • Open the demo directory in a code editor

    • Locate and edit the index.html file

    • Replace the placeholder values with your actual API keys:

  • Running pnpm run dev and opening http://localhost:3000/

  • Opening the file directly in your browser

This browser-based demo demonstrates client-side implementation of the LiquidCommerce Cloud SDK including:

  • SDK initialization in the browser

  • API authentication flow

  • Address validation

  • Catalog browsing and product search

The demo uses vanilla JavaScript to ensure compatibility and clear understanding of SDK implementation without framework-specific code. 👉

User

  • Payment Element

  • Legacy Payment Element

  • Checkout

  • Orders

  • Save the file

    ⚠️ Note: Keep your API keys secure and never commit them to public repositories.

  • Start the development server by either:

  • Shopping cart integration
  • User account management and session handling

  • Payment integration

  • Interactive checkout process

  • Orders

    • Authentication

    • Webhook Testing

    • Fetch By ID

  • Authentication
    Cloud SDK Demo
    Usage
    Response Types
    Methods
    Address
    Catalog
    Cart
    Price Type
    Documentation
    View Demo Source Code
    npm install @liquidcommerce/cloud-sdk
    # or
    yarn add @liquidcommerce/cloud-sdk
    git clone https://github.com/liquidcommerce/cloud-sdk.git
    cd cloud-sdk/demo
    const API_KEY = 'YOUR_LIQUIDCOMMERCE_API_KEY';
    const GOOGLE_PLACES_API_KEY = 'PUT_YOUR_KEY_HERE';
    
    // For Orders
    const ORDER_API_USER = 'YOUR_ORDER_API_USER';
    const ORDER_API_PASSWORD = 'YOUR_ORDER_API_PASSWORD';