A Checkout Intent represents the end‑to‑end process of purchasing a product through Rye. Each intent progresses through a series of states, from initial creation to final order placement. Understanding these states helps you design robust checkout flows and handle errors gracefully.

​
States

  • retrieving_offer - When a Checkout Intent is first created, Rye fetches live pricing, availability, taxes, and shipping options from the merchant for the provided productUrl.
  • awaiting_confirmation - An offer is ready and includes pricing and availability details. Your app can collect payment details from the buyer.
  • placing_order - A payment method was provided and Rye is executing the checkout on the merchant site.
  • completed - The order was successfully placed and confirmed by the merchant.
  • failed - The checkout could not be completed (e.g., out of stock, unsupported merchant, declined payment).

​
Sequence

The diagram below shows the typical happy path (Create -> Confirm -> Fulfill) plus common branches.