Pre-Purchase

  • Product data is not provided through this API.

Ordering & Checkout

Amazon Orders
  • Amazon orders are placed through Rye as the merchant of record. They will not use the end shopper’s personal Amazon account.
All Orders
  • Login or non-guest checkout flows are not supported.
  • Only physical products are supported at this time.
  • US-only ordering is supported.
  • One product per checkout is required. Multiple quantities and multi-product carts are currently not supported yet. We plan to add support soon for multiple quantities.
  • Stores with advanced anti‑bot mechanisms (such as REI or Sephora) are not yet supported.
  • Selecting product options such as color or size is not currently supported.
  • Shipping options default to the first option returned (usually the lowest cost). Developers cannot select from multiple options.
  • Currently, Rye does not support webhooks for the async processes of creating or confirming a Checkout Intent. We recommend polling the /api/v1/checkout_intent/{id} endpoint every 10 seconds for updates to avoid overloading our system while keeping your system in sync.
  • Rate limits: The default limits are 5 requests per second and 50 requests per day.
Merchant of Record & Payment Flows
  • With the current integration, Rye uses Stripe to tokenize users’ credit cards. This makes Rye the merchant of record and introduces a duplicate transaction fee.
    • Later this year: We plan to work with a partner for payment tokenization, at which point Rye will no longer be the merchant of record.

Post-Purchase

Amazon Orders
  • Since all Amazon orders are placed via Rye’s Amazon account, tracking information is provided via Webhooks. Please follow the webhooks documentation found here for webhooks setup and usage.
Non-Amazon Orders
  • Rye does not track orders post-purchase (other than Amazon). Rye’s API places orders on the store website acting on behalf of the end-user. If the end-user has provided an email and/or phone number, they will directly receive tracking information.
  • Post-purchase webhooks are not supported (except for Amazon). Order confirmations and updates are sent directly to the buyer via the email address provided in the buyer identity.