Overview
To submit a checkout intent with Rye, you need to provide a payment method. Depending on the provider, this involves either tokenizing the buyer’s card information client-side or using your pre-funded account balance.| Provider | Payment Method Type | Description |
|---|---|---|
| Basis Theory | basis_theory_token | PCI-compliant card tokenization with direct marketplace forwarding. |
| Stripe | stripe_token | Stripe.js-based card tokenization using Rye’s Stripe publishable key. |
| Drawdown | drawdown | Pay using your pre-funded Rye account balance. No card tokenization required. |
How It Works
- Tokenize the buyer’s card details on the client side using your chosen provider’s SDK (or skip this step for Drawdown).
- Pass the payment method to the Rye API when adding payment to a checkout intent or when calling the single-step purchase endpoint.
- Rye handles the rest — routing the payment to the appropriate merchant.
Provider Details
Basis Theory provides PCI-compliant tokenization with direct card forwarding to merchant payment vaults. For Shopify merchants, the card is forwarded directly to Shopify’s payment vault, so Rye does not act as the merchant of record. For non-Shopify merchants, Rye is the merchant of record. Stripe tokenizes card data using Rye’s Stripe publishable key. Rye acts as the merchant of record in this flow. Drawdown uses your pre-funded Rye account balance. No card tokenization is needed — simply set the payment method type todrawdown. In this flow, the developer is responsible for collecting funds from the user, making the developer the merchant of record.