Rye supports a variety of different use cases, including selling Shopify products from the Sell Anything API and the Sync API, as well as selling Amazon products via Rye or your own Amazon Business account. Each use case requires a slightly different payment flow, which is described in detail below.

Key terms / concepts

This guide assumes you’re familiar with the following terms and concepts:

Sell Anything API - Shopify products

These are products that are specifically requested as part of the Sell Anything API.

Sync API - Shopify products

These are products that are part of the Rye network via the Sync API.

Amazon checkout

This refers to using Rye to place Amazon orders on behalf of end customers. For this use case, Rye handles returns and cancellations. This is recommended to begin with - if your order volume grows to > 1,000 orders per month, you should consider switching to your own Amazon Business account.

Amazon checkout via developer’s own Amazon Business account

This refers to developers using Rye in combination with their own Amazon Business account to place orders on behalf of customers. This method allows developers to see orders in their own business account and manage returns and cancellations directly. See the Amazon Business account guide for more how to set this up.

rye-pay library

The rye-pay library is an npm package Rye provides to collect payment information from customers.


Payment flows

Sync API

  1. Shopper enters payment information on developer’s site via the rye-pay library OR developer collects payment from shopper via their own payment flow.
  2. Cart is submitted to Rye with tokenized credit card information.
  3. Order is submitted to merchant’s Shopify store, charging passed-in card directly (shopper’s card if using rye-pay, developer’s card if using their own payment flow).

Back-end payment flow

Sync API backend payment flow

Rye Pay payment flow

Sync API Rye SDK

Shopify products - Sell Anything API

Amazon products

  1. Shopper enters payment information on developer’s site via the rye-pay library OR developer collects payment from shopper via their own payment flow.
  2. Cart is submitted to Rye with tokenized credit card information.
  3. Passed-in card is charged by Rye (shopper’s card if using rye-pay, developer’s card if using their own payment flow).
  4. Order is submitted to merchant’s Shopify or Amazon store, paid for by Rye.

Back-end payment flow

Sell Anything API backend payment flow

Rye Pay payment flow

Sell Anything API Rye SDK

Amazon products using developer’s Amazon Business account

  1. Developer collects payment from shopper via their own payment flow.
  2. Developer submits cart to Rye.
  3. Order is submitted to Amazon via developer’s Amazon Business account, using developer’s saved payment information in Amazon.
  4. Developer charges shopper’s card directly.

Handling returns

To better understand how payments work with returns, please see the Returns guide.

Additional notes

Rye will handle any processing fees that are part of the flows explained above. As order volume grows, this is subject to change by incorporating a regular invoicing process paid via ACH.