Skip to main content

​
Introduction

The Henry Shopping SDK gives developers the primitives they need to build in-app shopping experiences. The SDK follows a simple flow: your users discover products, add them to a cart, and check out, all within your app while Henry handles the rest.

​
The Shopping Flow

The Henry Shopping API is built around a straightforward shopping experience:
  1. Product Discovery - Search for and browse products from across the internet
  2. Universal Cart - Add products to a user’s cart
  3. Cart Checkout - Direct users to our secure checkout interface
  4. Order Management - Monitor order status and post-purchase states

​
Products

Products represent the items available for purchase through Henry. Use the SDK’s product helpers to:
  • Search for products across the internet
  • Get details including price, images, and availability
  • Access metadata like sizes, colors, and variants
Each product includes all the information needed to display it in your app and add it to a user’s cart.

​
Shopping Cart

The cart is the centerpiece of the Henry Shopping SDK. It provides:
  • Persistent storage of products users want to purchase
  • Multi-merchant support allowing items from different stores
  • Quantity management for adjusting item counts
  • Session persistence so users can return and continue shopping
Every user gets their own cart identified by your app’s user ID.

​
Checkout Process

Henry handles checkout through a secure hosted modal or headless SDK calls. Hosted
  1. Add user’s products to their universal cart
  2. Generate a hosted checkout URL for the user to complete checkout (we handle shipping, card collection, and payment)
Headless
  1. Add user’s products to their universal cart
  2. Call APIs to create a checkout session
  3. Add card and shipping details to the checkout session (your hosted frontend)
  4. Confirm the checkout session to create an order

​
Order Management

Once checkout is complete, you can:
  • Track order status using the order ID
  • Query order details including shipping and fulfillment information
Orders progress through clear status stages from payment processing to order placed. Once the order is placed on the merchant site, your users will get email updates as if they placed an order themselves. Post purchase updates (shipped, delivered, etc.) are coming soon.

​
Monetization

Every purchase made through the Henry Shopping SDK-backed experience generates commission revenue for your application:
  • Automatic tracking of all purchases from your users
  • Competitive commission rates from our merchant partnerships
  • No overhead - Henry handles payouts and merchant relationships
  • Transparent reporting of earnings and transactions
This creates a sustainable revenue stream aligned with your users’ shopping activity.