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. |
| Prava | prava_token | Encrypted card tokenization via Rye’s public key. Partner integration. |
| Nekuda | nekuda_token | Virtual card issuance for payments. Partner integration. |
| 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. Prava offers VIC agentic payment instruments, which allows the merchant to be the merchant of record in cases where the shopper is paying with a Visa credit or debit card. Card details are encrypted client-side using RSA-OAEP with Rye’s public key. Available through partner onboarding. Nekuda issues virtual cards for payments. Rye creates a mandate with Nekuda and processes the payment directly with the merchant. Available through partner onboarding. 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.