Inside Prava
Search, quotes, approval, checkout, repeat orders and webhooks: how the parts of Prava's commerce stack connect, shown with one monthly coffee order.

Prava started as a way for AI agents to pay. It now covers the whole purchase, from finding a product to buying it again next month. This post explains how the parts fit together, using one example: a monthly coffee order.
A user might set up their agent to reorder the same bag of coffee beans each month from a UCP store, with a limit of $30 a month. At the start of the month, the agent asks the store for a fresh quote: $24.50, including shipping and tax. Because that is within the limit the user agreed to, Prava issues a new one-time token for that store and that amount. The order goes through the store's own checkout, a webhook confirms it to the app's server, and the user gets a message that the coffee is on its way.
If the store later raises the price to $32, the agent stops and asks the user before buying. If the user goes on holiday, they can pause the order with one tap. At no point does the user re-enter their card or approve each month's order by hand.
Eight parts of Prava are involved in this, and you can use any one of them on its own or all of them together.
The eight parts of the stack
Job | Prava piece | What it does |
|---|---|---|
Find the product | Shop API | Searches any UCP store plus merchants we've enabled directly, like Macy's, with the UCP integration handled for you. It understands that "750 ml" and "0.75 L" are the same bottle. |
Get the real price | Quotes | An exact total with shipping, tax, import duties and discount codes, held for about 15 minutes. |
Collect the card | SDK card form | Embedded in your app or hosted by Prava, with your logo, name and color. Card data never touches your servers. |
Get permission | Passkey approval | The user approves the store and total with Face ID, Touch ID or a security key, and reviews the cart before paying. |
Pay | One-time network tokens | Each approval produces a token locked to one store and one amount. Tokens come from Visa Intelligent Commerce and Mastercard Agent Pay. The merchant charges the user's own card. |
Check out | UCP checkout and Browser Harness | On UCP stores, checkout completes in 5 to 20 seconds. On regular store websites, the Browser Harness finishes in 10 to 20 seconds on most stores, removes paid extras, and stops if anything doesn't match. |
Buy again | Mandates | Approve once with limits on store, amount, frequency and duration. Limits can renew weekly, monthly or yearly. |
Stay in sync | Webhooks | Signed events for payments, saved cards and spending limits, retried for 72 hours and replayable for 30 days. |
Each piece is documented in the Prava docs, with request examples for the Shop API, checkout, mandates and webhooks.
Choosing which parts to use
Payments only. You already handle search and checkout. Use Prava for card collection, approvals and one-time tokens.
Payments and checkout. UCP stores check out in 5 to 20 seconds, and the Browser Harness covers stores that have no API.
The full stack. Add the Shop API for search and quotes, and mandates for repeat orders.
To start, follow the step-by-step integration guide, or see the full checkout flow for AI shopping apps.
Recent improvements
Recent updates include clearer reasons when a payment fails, a cart review before paying, mandate setup without asking for a shipping address, and sandbox payment simulations that send real webhook events marked as simulated.
Summary
Prava started as payments for AI agents. It's now one API for the whole purchase: finding the product, quoting it, getting approval, checking out on the store, and buying again.
Each piece works on its own, so you can use only what you need.
The monthly coffee order shows how the parts work together.
To try it, create sandbox keys in the dashboard and follow the quickstart.
FAQ
Do stores need to integrate with Prava? No. UCP stores and directly enabled merchants are reached through their APIs, and the Browser Harness checks out on regular websites.
Can a mandate charge without the agent asking? Today the agent starts each charge, within the limits the user set. Each one still gets its own one-time token.
Is the Shop API Shopify-only? No. It covers any store on UCP, the Universal Commerce Protocol, plus merchants we've enabled directly.
Sources

Prava team

