Skip to main content
Our Best Buy integration uses the same ordering workflow and API endpoints as submitting orders to other merchants. Before submitting live orders, your production Rye account must be allowlisted. Once approved, you can submit orders in production using Best Buy product URLs. A few important details to be aware of are listed below, including the approval process, product limitations, and branding guidelines.

​
Example

You can test the Best Buy ordering workflow using our staging environment without being allowlisted. Below is an example using our single-step checkout workflow. You can also submit Best Buy orders through our multi-step checkout workflow if you need to retrieve pricing and availability details before placing the order. 
curl https://staging.api.rye.com/api/v1/checkout-intents/purchase \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CHECKOUT_INTENTS_API_KEY" \
    -d '{
          "buyer": {
            "address1": "123 Main St",
            "city": "New York",
            "country": "US",
            "email": "[email protected]",
            "firstName": "John",
            "lastName": "Doe",
            "phone": "212-333-2121",
            "postalCode": "10001",
            "province": "NY"
          },
          "paymentMethod": {
            "stripeToken": "tok_visa",
            "type": "stripe_token"
          },
          "productUrl": "https://www.bestbuy.com/product/apple-airtag-silver/JJGCQ8XFQY",
          "quantity": 1
        }'

​
Approval Process

Use of our Best Buy integration is subject to approval from Best Buy.
If submit a Best Buy order in production without prior approval, you will receive an error response from the API.
Please email us to request approval for Best Buy ordering. Include a short description of your app, the Best Buy product categories you are interested in, and screenshots of the experience where you plan to display Best Buy products. Once you submit this information, we will coordinate with Best Buy on the approval process.

​
Key Details

  • Branding Guidelines:
    • When displaying Best Buy products in your app, the Best Buy logo must be shown alongside any items from Best Buy. Ensure there is a space equal to 1x the height of the yellow tag separating the logo from any surrounding content.
    • On your PDP, you must also note to shoppers that products are fulfilled by Best Buy.
  • Commissions: Based on your agreement with Best Buy and Rye, any commissions are paid 30 days after the purchase is completed. This allows time for order confirmation, fulfillment, and potential returns.
  • Payments: Ordering by drawdown is not supported. You need to tokenize a credit card and provide it in the API request to pay for orders.
  • Product Availabilty: Only first-party inventory is supported through this integration. Some products on the Best Buy website are sold by third-party sellers. For those items, we are unable to fetch offers or submit orders.
  • Delivery: Only home shipping is supported (P.O. boxes and in-store pickup are not available). Orders over $35 generally qualify for free shipping, but the exact shipping cost can be confirmed through the API.