Skip to main content

← All Payment Providers

​
Overview

Prava is a partner integration that offers VIC agentic payment instruments for Rye checkout intents. This allows the merchant to be the merchant of record in cases where the shopper is paying with a Visa credit or debit card. Card data (number, expiration, and CVC) is encrypted client-side using RSA-OAEP with Rye’s public key, producing a single base64-encoded token. When you pass a Prava token to Rye, the server decrypts the card data and processes the payment directly with the merchant.

​
Usage

Once you have an encrypted Prava token, pass it to the Rye API as the payment method.

​
Single-Step Purchase

curl -X POST https://api.rye.com/v1/checkout-intents/purchase \
  -H "Authorization: Bearer $RYE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "productUrl": "https://example-store.myshopify.com/products/example-product",
    "quantity": 1,
    "buyer": {
      "firstName": "Jane",
      "lastName": "Doe",
      "email": "jane@example.com",
      "phone": "+15551234567",
      "address1": "123 Main St",
      "city": "New York",
      "province": "NY",
      "postalCode": "10001",
      "country": "US"
    },
    "paymentMethod": {
      "type": "prava_token",
      "pravaToken": "<ENCRYPTED_TOKEN>"
    }
  }'

​
Two-Step Flow (Add Payment to Existing Intent)

curl -X POST https://api.rye.com/v1/checkout-intents/{id}/payment \
  -H "Authorization: Bearer $RYE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "paymentMethod": {
      "type": "prava_token",
      "pravaToken": "<ENCRYPTED_TOKEN>"
    }
  }'

​
Notes

  • Prava tokens are single-use. Generate a new token for each order.
  • Token encryption details (including Rye’s public key) are provided during partner onboarding.
  • Prava is a partner integration. Contact dev@rye.com for access.