Inside Prava

How Prava's commerce stack fits together

How Prava's commerce stack fits together

How Prava's commerce stack fits together

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

Inside Prava: Prava's Commerce Stack, Explained

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

Copyright © 2026 Prava Payments Inc. All rights reserved

Copyright © 2026 Prava Payments Inc. All rights reserved