API Limitations

​

Pre-Purchase

• Product data is not available through Universal Checkout API, but can be accessed via the Sync API. You can use these two APIs together by retrieving product data from the Sync API and submitting orders through Universal Checkout API.

​

Ordering & Checkout

• Amazon orders are placed through Rye as the merchant of record. They will not use the end shopper’s personal Amazon account.

• 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 of the same product are supported, but multi-product carts are not supported yet.
• Stores with advanced anti‑bot mechanisms (such as REI or Sephora) are not yet supported.
• Product variants (such as size or color) are supported, but you need to provide a product URL associated with the specific variant when placing an order.
• 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. Please contact us if you need to increase the rate limits for your account.
• Checkout intents cannot be updated once created. To change buyer details such as the shipping address, you need to create a new checkout intent with the updated information.

• 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

• 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.

• 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.