Skip to main content

​
Introduction

The Henry Shopping API is designed to give developers all the tools they need to build in-app shopping experiences. The API follows a simple flow: your users discover products, adds them to a cart, and checks out all within your app. 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 include, but are not limited to, the items available for purchase through the Henry Shopping API. Use our discovery endpoints 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 API. 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 the entire checkout through a secure hosted modal or headless API 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 API 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.