Use cases

Custom shops

(If you're building on top of a supported headless commerce platform like Shopify Hydrogen, see docs on integrating headless shops instead.)

For a loyalty solution to be operational, you need three basic ingredients:

  1. Send order and customer data to Bubblehouse.
  2. Set up a way for Bubblehouse to implement discounts on your store.
  3. Display a loyalty program page to the user.

Send order and customer data to Bubblehouse

You will normally use Orders API for this. (Bubblehouse has a few more ways to get order/customer data in for more exotic legacy systems, like polling exported CSVs.)

If you're building a custom experience for a supported headless shop system (like Shopify Hydrogen), this is already handled for you.

Set up a way for Bubblehouse to implement discounts on your store

This normally involves implementing custom hooks. In extreme cases, Bubblehouse can offer alternatives (like prepopulating discount codes).

If you're building a custom experience for a supported headless shop system (like Shopify Hydrogen), this is already handled for you.

Display a loyalty program page to the user

You have two options. We recommend starting with a Blocks API, which displays built-in user interface blocks on your web site, and handles all related interactions (like redeeming points) for you.

If you have engineering resources, you can alternatively use Loyalty API to build a completely custom experience.

Calling RPC APIs

A vast majority of Bubblehouse APIs are JSON-based RPCs via HTTP with consistent calling conventions.

Order API

Push order and customer information to Bubblehouse

Blocks API

Exposes built-in user interface blocks you can embed into your site

Loyalty API

A vast majority of Bubblehouse APIs are JSON-based RPCs via HTTP with consistent calling conventions.
Previous
Quick Start