Rye for Developers: An API to Sell Anything

Rye

Jul 18, 2024

4 min read

Online shopping is changing fast. New ways to buy and sell are popping up everywhere - on social media (Instagram shopping, TikTok Shop), in games, through AI assistants, and more. But for developers trying to build these new experiences, there's a big problem.

The Problem

You want to build experiences with embedded commerce components. But instead of focusing on your unique product vision, you're bogged down with:

  • Running a full sales process to acquire brands

  • Signing commercial agreements with brands to sell their products

  • Integrating multiple e-commerce platforms, each with its own quirks

  • Syncing inventory and pricing data across systems

  • Building and maintaining complex checkout flows

  • Managing orders from various brands

These tasks eat up your development time and distract you from creating value for your users.

You want to build experiences with embedded commerce components. But instead of focusing on your unique product vision, you're bogged down with:

  • Running a full sales process to acquire brands

  • Signing commercial agreements with brands to sell their products

  • Integrating multiple e-commerce platforms, each with its own quirks

  • Syncing inventory and pricing data across systems

  • Building and maintaining complex checkout flows

  • Managing orders from various brands

These tasks eat up your development time and distract you from creating value for your users.

You want to build experiences with embedded commerce components. But instead of focusing on your unique product vision, you're bogged down with:

  • Running a full sales process to acquire brands

  • Signing commercial agreements with brands to sell their products

  • Integrating multiple e-commerce platforms, each with its own quirks

  • Syncing inventory and pricing data across systems

  • Building and maintaining complex checkout flows

  • Managing orders from various brands

These tasks eat up your development time and distract you from creating value for your users.

The Solution

Rye is a universal API for online commerce. We handle the backend complexity, so you can focus on building great experiences. With Rye, you can:

  • Instantly access large product catalogs of a diverse category of brands through a single API

  • Process checkouts with a unified flow across different platforms

  • Manage orders and track inventory updates in real-time

  • Handle refunds and returns across platforms seamlessly

Here's how simple it is to create a cart and checkout with Rye:

import { RyeClient, CartItemsInput, Country } from '@rye-api/rye-sdk';
import { tokenizeCreditCard } from './tokenization';

// You can find these in the Rye Console at console.rye.com/account

const API_HEADERS = {"Authorization": "Basic <Authorization>", "Rye-Shopper-IP": "<Shopper-IP>"};
const ryeClient = new RyeClient({authHeader: API_HEADERS.Authorization, shopperIp: API_HEADERS["Rye-Shopper-IP"]});
async function main() {

  // Create a new cart, tokenize the credit card, and submit the cart

  const createCartResponse = await ryeClient.createCart({
    input: {
      items: { amazonCartItemsInput: [{ productId: 'B01I2Y4GVY', quantity: 1 }] },
      buyerIdentity: {
        firstName: 'Jane', lastName: 'Smith', phone: '+14152940424',
        email:'jane@example.com', address1: '123 Main St', city: 'San Francisco',
        countryCode: Country.Us, provinceCode: 'CA', postalCode: '94111',
  }}});
  const paymentToken = await tokenizeCreditCard(
    'Jane', 'Smith', '4242424242424242', '423', '3', '2029'
  );

  // Order the cart

  const submitCartResponse = await ryeClient.submitCart({
    input: { id: createCartResponse!.cart.id!, token: paymentToken },
  });
  console.log(`Order submitted! Status: ${submitCartResponse!.cart.stores[0]!.status!},\n${JSON.stringify(submitCartResponse)}`);
}
main().catch(console.error);
import { RyeClient, CartItemsInput, Country } from '@rye-api/rye-sdk';
import { tokenizeCreditCard } from './tokenization';

// You can find these in the Rye Console at console.rye.com/account

const API_HEADERS = {"Authorization": "Basic <Authorization>", "Rye-Shopper-IP": "<Shopper-IP>"};
const ryeClient = new RyeClient({authHeader: API_HEADERS.Authorization, shopperIp: API_HEADERS["Rye-Shopper-IP"]});
async function main() {

  // Create a new cart, tokenize the credit card, and submit the cart

  const createCartResponse = await ryeClient.createCart({
    input: {
      items: { amazonCartItemsInput: [{ productId: 'B01I2Y4GVY', quantity: 1 }] },
      buyerIdentity: {
        firstName: 'Jane', lastName: 'Smith', phone: '+14152940424',
        email:'jane@example.com', address1: '123 Main St', city: 'San Francisco',
        countryCode: Country.Us, provinceCode: 'CA', postalCode: '94111',
  }}});
  const paymentToken = await tokenizeCreditCard(
    'Jane', 'Smith', '4242424242424242', '423', '3', '2029'
  );

  // Order the cart

  const submitCartResponse = await ryeClient.submitCart({
    input: { id: createCartResponse!.cart.id!, token: paymentToken },
  });
  console.log(`Order submitted! Status: ${submitCartResponse!.cart.stores[0]!.status!},\n${JSON.stringify(submitCartResponse)}`);
}
main().catch(console.error);
import { RyeClient, CartItemsInput, Country } from '@rye-api/rye-sdk';
import { tokenizeCreditCard } from './tokenization';

// You can find these in the Rye Console at console.rye.com/account

const API_HEADERS = {"Authorization": "Basic <Authorization>", "Rye-Shopper-IP": "<Shopper-IP>"};
const ryeClient = new RyeClient({authHeader: API_HEADERS.Authorization, shopperIp: API_HEADERS["Rye-Shopper-IP"]});
async function main() {

  // Create a new cart, tokenize the credit card, and submit the cart

  const createCartResponse = await ryeClient.createCart({
    input: {
      items: { amazonCartItemsInput: [{ productId: 'B01I2Y4GVY', quantity: 1 }] },
      buyerIdentity: {
        firstName: 'Jane', lastName: 'Smith', phone: '+14152940424',
        email:'jane@example.com', address1: '123 Main St', city: 'San Francisco',
        countryCode: Country.Us, provinceCode: 'CA', postalCode: '94111',
  }}});
  const paymentToken = await tokenizeCreditCard(
    'Jane', 'Smith', '4242424242424242', '423', '3', '2029'
  );

  // Order the cart

  const submitCartResponse = await ryeClient.submitCart({
    input: { id: createCartResponse!.cart.id!, token: paymentToken },
  });
  console.log(`Order submitted! Status: ${submitCartResponse!.cart.stores[0]!.status!},\n${JSON.stringify(submitCartResponse)}`);
}
main().catch(console.error);

What You Can Build

With Rye, you're free to innovate. Here are just a few ideas:

  • Cross-platform product discovery tools

  • Social commerce apps that turn any content into a point-of-sale

  • AR/VR shopping experiences pulling from multiple brands

  • AI-powered personal shopping assistants

  • Decentralized marketplaces

With Rye, you're free to innovate. Here are just a few ideas:

  • Cross-platform product discovery tools

  • Social commerce apps that turn any content into a point-of-sale

  • AR/VR shopping experiences pulling from multiple brands

  • AI-powered personal shopping assistants

  • Decentralized marketplaces

With Rye, you're free to innovate. Here are just a few ideas:

  • Cross-platform product discovery tools

  • Social commerce apps that turn any content into a point-of-sale

  • AR/VR shopping experiences pulling from multiple brands

  • AI-powered personal shopping assistants

  • Decentralized marketplaces

Our Commitment to Developers

We're developers too, and we're building Rye with your needs in mind:

  1. Developer Experience: Clear documentation, intuitive SDKs, and responsive support.

  2. Scalability & Reliability: Rye's infrastructure is battle-tested and built for mission-critical e-commerce operations. Our platform consistently delivers high performance and reliability, even during peak sales events. Developers can focus on building innovative shopping experiences, confident that Rye will handle the heavy lifting behind the scenes.

  3. Consistency: Our API provides a unified interface, regardless of the underlying platforms.

  4. Performance: We're constantly optimizing for low latency and high throughput.

  5. Security: Rock-solid security is table stakes. We safeguard shopper data and secure transactions.

We're developers too, and we're building Rye with your needs in mind:

  1. Developer Experience: Clear documentation, intuitive SDKs, and responsive support.

  2. Scalability & Reliability: Rye's infrastructure is battle-tested and built for mission-critical e-commerce operations. Our platform consistently delivers high performance and reliability, even during peak sales events. Developers can focus on building innovative shopping experiences, confident that Rye will handle the heavy lifting behind the scenes.

  3. Consistency: Our API provides a unified interface, regardless of the underlying platforms.

  4. Performance: We're constantly optimizing for low latency and high throughput.

  5. Security: Rock-solid security is table stakes. We safeguard shopper data and secure transactions.

We're developers too, and we're building Rye with your needs in mind:

  1. Developer Experience: Clear documentation, intuitive SDKs, and responsive support.

  2. Scalability & Reliability: Rye's infrastructure is battle-tested and built for mission-critical e-commerce operations. Our platform consistently delivers high performance and reliability, even during peak sales events. Developers can focus on building innovative shopping experiences, confident that Rye will handle the heavy lifting behind the scenes.

  3. Consistency: Our API provides a unified interface, regardless of the underlying platforms.

  4. Performance: We're constantly optimizing for low latency and high throughput.

  5. Security: Rock-solid security is table stakes. We safeguard shopper data and secure transactions.

Get Started

Check out our docs and get your API key to start building with Rye.

We're just getting started, and there's a lot more to come!

Check out our docs and get your API key to start building with Rye.

We're just getting started, and there's a lot more to come!

Check out our docs and get your API key to start building with Rye.

We're just getting started, and there's a lot more to come!

Accelerate your commerce operations

Accelerate your commerce operations

Accelerate your commerce operations